Наразі ви можете підписатися лише на події чату, контакту і повідомлення. Усі події вебхуків містять однакові атрибути, перелічені нижче:
Поле | Тип | Опис |
event | String | Тип чату або події контакту |
eventData | Object | Контейнер для даних, пов’язаних із подією |
attempts | Integer | Кількість спроб цієї події |
lastAttemptAt | Date (UNIX timestamp) | Остання спроба доставки події |
createdAt | Date (UNIX timestamp) | Дата і час створення події |
id | String | Унікальний ідентифікатор події, наданий HelpCrunch |
📢 Події повідомлення
Тип події | Опис |
message.chat.customer | Нове вхідне повідомлення чату, надіслане контактом |
message.email.customer | Нове вхідне повідомлення електронної пошти, надіслане контактом |
message.private | Нове приватне повідомлення надіслане учасником команди |
message.chat.agent | Нове повідомлення чату надіслано учасником команди |
message.email.agent | Нове повідомлення електронної пошти, надіслане членом команди |
Коли відбувається подія повідомлення, HelpCrunch надсилає запит HTTP до вказаної кінцевої точки. Ви можете отримати всі доступні атрибути повідомлення зі структури eventData
в тілі запиту, включаючи основну інформацію про контакт (ідентифікатор, ім’я, електронна адреса та userId) та чат (ідентифікатор).
Модель повідомлень для вебхуків
Приклад відповіді:
{
"event": "message.chat.customer",
"eventData": {
"chat_id": 5224081,
"agent": null,
"customer": {
"id": 8745474,
"name": "Paul",
"email": "[email protected]",
"userId": "example_9106"
},
"message": {
"applicationId": 77,
"broadcastType": null,
"createdAt": "1638953586.915",
"edited": false,
"id": 38488,
"read": false,
"text": "Thanks! Have a nice day.",
"updatedAt": "1638953586.915"
}
},
"attempts": 0,
"lastAttemptAt": 1638953588,
"createdAt": 1638953588,
"id": "73499e69-285c-44c3-8431-a843ed08183d"
}
Об'єкт eventData для подій повідомлення
Поле | Тип | Опис |
event | String | Тип події |
chat_id | Integer | Унікальний внутрішній ідентифікатор чату |
agent | Object |
Інформація про члена команди, включаючи:
|
customer | Object |
Основна інформація про контакт, включаючи:
|
message | Object |
Інформація про повідомлення, зокрема:
|
Ви можете використовувати ідентифікатор чату та ідентифікатор контакту з будь-якої події повідомлення, щоб викликати методи REST API "Отримати інформацію про чат" та "Отримати інформацію про контакт".