机器人通知
把客户回复、转人工、发送失败和新商机推送到飞书、钉钉或通用 Webhook,并核实每次投递结果。
最后更新:2026-10-23
你不需要一直盯着收件箱。RenewSell 可以把四类事件推送到飞书群、钉钉群的机器人,或你自己控制的任意 HTTPS 地址。
这一页说明有哪些事件、怎样添加机器人、加签怎么工作,以及怎样确认消息有没有送达。
添加机器人
- 打开 设置,选择 通知偏好。
- 在 机器人通知 卡片下方的 添加机器人通知 表单里填写:
| 字段 | 填什么 |
|---|---|
| 类型 | 飞书、钉钉 或 通用 Webhook |
| 名称 | 列表里能认出来的名字 |
| Webhook URL | 机器人的 Webhook 地址 |
| 加签密钥(可选) | 同一个机器人上的密钥,只有用加签时才填 |
| 订阅事件 | 至少勾选下面四类事件之一 |
- 点 添加机器人。
添加后,列表会显示名称、地址(只显示主机名)、订阅的事件、启用开关、最近一次投递结果,以及 测试发送 和 删除。
飞书:在群里添加自定义机器人,复制 Webhook 地址;如果在这里设置了密钥,请在机器人上开启「加签」。 钉钉:在群里添加自定义机器人,复制 Webhook 地址;如果设置了密钥,请开启「加签」。 通用 Webhook:HTTPS 的 JSON POST;设置密钥后,请求头里会带签名(见下)。
URL 和密钥都加密存储,而且只写不读:保存后不会再显示完整 URL,列表里只保留主机名。
四类事件
| 事件 | 什么时候发送 |
|---|---|
| 收到客户回复 | 客户的回复进入某个智能体的收件箱 |
| 需人工处理 | 智能体把会话转给你,或停止回复 |
| 消息发送失败 | 消息在尝试发送之后最终失败 |
| 新商机 | 识别出一条新的客户信号(见 商机看板) |
飞书和钉钉收到一段简短的中文文本,包含联系人和公司,以及该事件相关的字段:新回复带渠道和预览,转人工带渠道和原因,发送失败带渠道和失败码,新商机带等级和摘要。通用 Webhook 收到英文 JSON:
{
"event": "message.received",
"occurredAt": "2026-10-23T09:15:00.000Z",
"data": { "contactName": "…", "companyName": "…", "channel": "email", "preview": "…", "link": "…" }
}
每类事件的 data 字段不同,例如 消息发送失败 会带上失败码,新商机 会带上等级和摘要。
加签
- 飞书:按飞书自定义机器人的规则,把时间戳和签名放进 JSON 请求体。在机器人上开启加签,并在这里填同一个密钥。
- 钉钉:把时间戳和签名作为查询参数追加到 Webhook 地址。在机器人上开启「加签」,并填同一个密钥。
- 通用 Webhook:设置密钥后,每个请求都会带一个请求头,值为
sha256=<请求体的十六进制 HMAC>。处理内容前先校验签名。
测试与投递结果
测试发送 会给这一个机器人发一条固定的测试消息,不用等真实事件就能检查地址和密钥。测试结果也会写进 最近投递:成功 · 2026-10-23 09:15。
- 只接受 HTTPS 地址,不跟随重定向。
- 飞书机器人只能使用
open.feishu.cn或open.larksuite.com的地址;钉钉机器人只能使用oapi.dingtalk.com的地址。通用 Webhook 可以是任意可公开访问的 HTTPS 地址。 - 每次投递 5 秒超时,失败后再试一次。两次都失败时只记为投递失败,之后不会再补发。
- 通知不消耗额度,也不会改变消息、回复或商机;投递失败只会被记录。
- 钉钉本身对每个机器人有每分钟 20 条的限制,超出部分会被钉钉拒绝。
接待型智能体
接待型智能体的转人工、停止和达到回复上限,以及收齐信息时产生的商机,只发给在该智能体里勾选的 通知渠道(可多选),不看这些机器人订阅了哪些事件;客户来信仍按 收到客户回复 的订阅发送。没有勾选任何机器人时,这些智能体事件不会通知任何人。
常见问题
为什么没有收到通知? 检查机器人是否启用、事件是否在 订阅事件 里、地址是否为允许主机上的 HTTPS 地址;接待型智能体还要检查它的通知设置里有没有勾选这个机器人。最近投递 会显示最近一次尝试的结果。
能看到或修改已保存的 URL 吗? 不能。URL 和密钥只写不读。要改地址,请添加一个新机器人并删除旧的。
通知失败会影响会话吗? 不会。投递独立于收件箱,尽力而为;消息、回复和商机都不受影响。