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 次。不保證順序。

這頁對你有幫助嗎?

最後更新: