钉钉(DingTalk)¶
在钉钉里创建机器人¶
- 打开钉钉,进入群聊,点击右上角群设置(齿轮图标)→「机器人 → 添加机器人」,选择自定义机器人(有的版本入口叫智能群助手)。普通群和外部群都可以;机器人只发群消息,不发单聊。
- 起一个名字(可选头像),然后完成安全设置——钉钉要求至少选择一种:
- 自定义关键词:最多 10 个,发出的消息必须包含其中至少一个。记下其中一个,稍后填进 Vibe Seller 的自定义关键词栏——未包含关键词的消息,Vibe Seller 会自动在末尾补上。
- 加签:复制
SEC开头的密钥,稍后填进 Vibe Seller 的加签栏,每条消息的签名由 Vibe Seller 自动带上。 - IP 地址(段):只允许指定出口 IP 调用。填写 Vibe Seller 所在机器的公网出口 IP;不使用这种方式的就留空,Vibe Seller 侧勾选IP 地址段即可、无需填写。
- 勾选《自定义机器人服务及免责条款》,点击完成,复制 Webhook 地址:
https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxx
官方说明:自定义机器人接入 · 自定义机器人安全设置
使用时注意:
- 每个机器人每分钟最多 20 条,超过会被限流 10 分钟;
- Markdown 消息会自动用正文首行做标题(会话列表和通知里显示的就是它);
- 不支持发文件;消息过长可能被拒,建议控制在 20 KB 以内。
在 Vibe Seller 里添加¶
- 打开 Vibe Seller,进入设置›集成›群机器人,点击添加机器人;
- 填写名称(例如运营告警),把刚才复制的 Webhook 地址整段粘贴进去,平台会自动识别为钉钉(DingTalk),下方出现安全设置(至少选一项)——至少勾选你在群里实际设置的一项,只显示勾选项对应的输入栏(机器人同时启用多种安全方式时要全部勾上,钉钉会逐项校验):
- 加签:粘贴
SEC开头的密钥; - 自定义关键词:填写你设置的关键词之一(不含它的消息由服务端自动补上);
- IP 地址段:什么都不用填——地址段在钉钉侧设置,这里只记录你用了它。

- 点击保存,列表里能看到平台标签、是否已加签和关键词;
- 点击这条机器人上的测试,行下方出现绿色提示、群里收到测试消息即为接通:

失败时行下方显示钉钉返回的真实原因——截图里的 token is not exist(错误码
300005)表示 access_token 不对或机器人已被删除,回群里重新复制地址即可:

其他报错的含义见群机器人。