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 次。不保证顺序。

这篇文档有帮助吗?

最后更新: