Webhook
转人工、新消息、会话结束、工单和文档处理等事件推送,以及验签和重试规则。
在后台「机器人设置」填写 webhook 地址。请求头:
| 头 | 说明 |
|---|---|
X-AICS-Event-Id | 事件 ID,按它去重 |
X-AICS-Timestamp / X-AICS-Signature | 验签方法同 订单查询接口 |
请求体:{"id", "type", "created_at", "data"}。
| 事件 | 什么时候 |
|---|---|
conversation.handoff | 转人工(转人工方式选了「推送到我的系统」或「两边都通知」时) |
conversation.message | 人工模式下顾客发来新消息 |
conversation.closed | 会话结束(data.conversation.closed_by 说明是谁结束的) |
conversation.rated | 顾客评价了已结束的会话:data.rating、data.comment |
ticket.created | 新工单(含顾客在客服不在线时的留言):data.ticket、data.description |
ticket.updated | 工单状态、优先级、处理人等变化:data.changes 是 {字段: [旧, 新]} |
ticket.replied | 客服回复了顾客:data.reply |
document.ready / document.failed | 文档处理完成或失败 |
返回 2xx 视为成功,否则按 30 秒、2 分钟、10 分钟……最长 12 小时退避重试,共 8 次。不保证顺序。
这篇文档有帮助吗?
最后更新:
