Webhook
Push-уведомления о таких событиях, как передача оператору, новые сообщения, завершение диалога, тикеты и обработка документов, а также правила проверки подписи и повторных попыток.
В разделе «Настройки бота» в панели управления укажите адрес 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 раз. Порядок не гарантируется.
Эта страница была полезной?
Обновлено:
