Webhook
Đẩy sự kiện như chuyển sang nhân viên, tin nhắn mới, kết thúc hội thoại, phiếu hỗ trợ và xử lý tài liệu, cùng quy tắc xác minh chữ ký và thử lại.
Điền địa chỉ webhook trong「Cài đặt bot」ở phần quản trị. Header của request:
| Header | Mô tả |
|---|---|
X-AICS-Event-Id | ID sự kiện, dùng để loại trùng |
X-AICS-Timestamp / X-AICS-Signature | Cách xác thực chữ ký giống API tra cứu đơn hàng |
Request body: {"id", "type", "created_at", "data"}.
| Sự kiện | Khi nào |
|---|---|
conversation.handoff | Chuyển sang nhân viên (khi cách chuyển nhân viên chọn「Đẩy về hệ thống của tôi」hoặc「Thông báo cả hai bên」) |
conversation.message | Khách gửi tin nhắn mới trong chế độ nhân viên |
conversation.closed | Cuộc hội thoại kết thúc (data.conversation.closed_by cho biết ai đã kết thúc) |
conversation.rated | Khách đánh giá cuộc hội thoại đã kết thúc: data.rating, data.comment |
ticket.created | Phiếu yêu cầu mới (bao gồm tin nhắn khách để lại khi nhân viên không online): data.ticket, data.description |
ticket.updated | Thay đổi trạng thái, độ ưu tiên, người xử lý… của phiếu yêu cầu: data.changes là {字段: [旧, 新]} |
ticket.replied | Nhân viên đã trả lời khách: data.reply |
document.ready / document.failed | Tài liệu xử lý xong hoặc thất bại |
Trả về 2xx được coi là thành công, nếu không sẽ retry với backoff 30 giây, 2 phút, 10 phút… tối đa 12 giờ, tổng cộng 8 lần. Không đảm bảo thứ tự.
Trang này có hữu ích không?
Cập nhật lần cuối:
