文档中心

消息中心

机器人接收配置

如何设置机器人消息回调

说明

机器人接收目前支持飞书、钉钉、企业微信、Slack等协作平台，同时也支持自定义Webhook地址。如果您在机器人的“安全设置”中配置了自定义关键词，请添加关键词「火山引擎」，确保能够收到来自火山引擎的Webhook消息。如果您使用了自定义Webhook地址，请关注火山引擎提供的通用webhook的出口IP，确保网络畅通。

进入机器人管理

在机器人接收配置中，点击页面右上角的「机器人管理」进入机器人管理界面，可以看到当前已配置的所有机器人

添加消息接收机器人

在机器人管理界面，点击左下角的「添加机器人」，将弹出添加机器人弹层，选择机器人类型并填入相关信息，确认保存即可

当前支持飞书机器人、企业微信机器人、钉钉群机器人、Slack以及自定义Webhook地址。

飞书、企业微信、钉钉、Slack

飞书、企业微信、钉钉、Slack等协作软件可参考对应开放文档进行配置：

飞书机器人webhook获取

企业微信机器人webhook获取

钉钉群机器人webhook获取

Slack webhook获取

自定义Webhook方式

在机器人平台中选择“自定义”后，按照下表填写各项，带 * 为必填项

配置项	是否必填	填写说明
机器人名称	是	2-50 字符，支持汉字、英文、数字。用于在列表中区分不同机器人。机器人名称要唯一。
Webhook 地址	是	填写需要推送消息的Webhook地址，不超过 256 字符，且必须是有效的 HTTP 或 HTTPS URL
加密密钥	否	火山引擎对通用的webhook提供了一些安全机制，核心主要是在推送消息时会在header中加2个字段： x-volcmsg-nonce：{hash}-{timestamp}-{random}，即"固定值 + - + 时间戳 + - + 随机数"。其中 hash 为一次推送的固定值，timestamp 为推送的时间戳，random 为随机值。 x-volcmsg-sign：使用「加密密钥」对「x-volcmsg-nonce」执行 HMAC-SHA256 签名运算，输出十六进制格式的签名结果。您可以解析这两个参数判断请求是否合法。
数据格式	是	注意自定义Webhook，仅支持推送文本格式消息。消息均以HTTP POST 发送、Content-Type 为 application/json，消息正文通过 ${content} 占位。请根据目标支持情况选择对应格式。格式 A （典型应用：钉钉、WPS） { "text": { "content": "${content}" }, "msgtype": "text" } 格式 B （典型应用：飞书） { "msg_type": "text", "content": { "text": "${content}" } } 格式 C （典型应用：Slack） { "text": "${content}" }
消息验证码	是	如果您当前配置的Webhook地址有效，通过验证码完成身份校验后，保存配置即可生效。验证码为6位，有效期为10分钟，格式为：【火山引擎】验证码：32***，有效期 10 分钟。账号 ID：21*****1 正在为火山引擎消息中心添加 Webhook 机器人。出于安全考虑，请勿将验证码透露给任何人。