接管通知
在 AI 无法继续对话时,通知所有者或办公软件 Webhook
接管通知用于在 AI 无法继续回复、需要人工介入时提醒团队。团队成员主动开启人工接管,不会单独触发此通知。
打开 组织 → 接管通知。所有者和管理员可以修改通知渠道;其他活跃成员可以查看当前状态,但不能保存更改。
何时发送通知
Bubblo 会为每段连续的 AI 不可用事件发送一次通知。同一事件中的更多内部尝试不会重复提醒团队。人工回复、切换人工接管、解决对话或 AI 恢复可以结束当前事件;之后的独立 AI 故障可以再发送一次新通知。
如果在实际投递前人工已处理、AI 已恢复,或对话已进入后续故障事件,过期通知会被跳过。临时投递失败会在最长 7 天的重试窗口内重试。
正式通知只包含组织、不含正文的对话代号、故障原因和控制台链接,不包含访客聊天正文。
邮件通知
“向组织所有者发送邮件”默认开启,只会将 AI 待人工通知发给组织所有者。实际投递需要当前部署已配置邮件服务。
Webhook 通知
开启 Webhook 通知后,选择一个接收工具:
| 目标 | 请求与签名 |
|---|---|
| 通用 Webhook | 发送稳定 JSON 事件。可选密钥会添加 X-Bubblo-Signature HMAC 请求头。 |
| 飞书群机器人 | 使用飞书自定义机器人文本消息格式,并支持安全设置中的签名校验。 |
| 钉钉群机器人 | 使用钉钉自定义机器人 Markdown 格式,并支持加签机器人。 |
输入可公开访问的 HTTPS Webhook URL,并在目标需要时填写签名密钥。私有网络与本机端点会被拒绝。请先保存当前修改,再选择发送测试通知。页面会显示最近测试和投递结果,方便排查目标拒绝或不可达问题。
通用 Webhook 的 JSON 事件包含 event、event_id、occurred_at、organization 和 conversation。请求会附带 X-Bubblo-Event、X-Bubblo-Delivery 和 X-Bubblo-Timestamp;配置密钥后还会附带 X-Bubblo-Signature: sha256=...。
Webhook 凭据需要部署已配置通知加密密钥。如果 Webhook 加密不可用,就不能保存或测试 Webhook 设置;邮件通知不受影响。