Наразі ви можете підписатися лише на події чату, контактів і повідомлення. Усі події вебхуків містять однакові атрибути, перелічені нижче:
Поле | Тип | Опис |
event | String | Тип чату або події контакту |
eventData | Object | Контейнер для даних, пов’язаних із подією |
attempts | Integer | Кількість спроб цієї події |
lastAttemptAt | Date (UNIX timestamp) | Остання спроба доставки події |
createdAt | Date (UNIX timestamp) | Дата і час створення події |
id | String | Унікальний ідентифікатор події, наданий HelpCrunch |
🙋 Події контактів
Тип події | Опис |
customer.new | До вашого облікового запису HelpCrunch додано новий контакт. |
customer.email_updated | Електронну адресу контакту оновлено. Зміна на нульове значення вважається оновленням. |
customer.tags_changed | Теги контакту змінені. Видалення всіх тегів вважається оновленням. |
customer.unsubscribed | Контакт відписався від ваших електронних листів. |
customer.subscribed | Контакт підписався на ваші листи. |
customer.blocked | Контакт заблокований будь-яким із членів вашої команди. |
customer.unblocked | Контакт розблокований будь-яким із членів вашої команди. |
customer.deleted | Контакт видалено з вашого облікового запису HelpCrunch. |
Коли відбувається подія контакту, HelpCrunch надсилає запит HTTP до вказаної кінцевої точки. Ви можете отримати основну інформацію про контакт зі структури eventData
в тілі запиту (ідентифікатор, ім’я, електронна адреса, ідентифікатор контакту, скасований підписку), а також усі ваші власні дані контакту.
Модель контакту для вебхуків
Приклад відповіді
{
"event": "customer.email_updated",
"eventData": {
"id": 8745474,
"name": "Paul",
"userId": "example_2924",
"email": "[email protected]",
"unsubscribed": false,
"customData": {
"Role": "admin",
"Plan": "Enterprise (Unlimited) $9999/mo",
"segment": "PotentialChurn_premium_seg1",
"Currency": "USD",
"Emails sent": 621,
"Trial end date": "2017-07-24 14:30:00",
"Became payer at": "2017-09-13 00:00:00",
"Registered date": "2017-07-10 14:30:00",
"Next payment date": "2020-09-01 00:40:00",
"Billing info added": true,
"Number of payments": 35,
"Subscription status": "active"
},
"tags": [
{
"id": 52661,
"name": "Lead"
},
{
"id": 64814,
"name": "Enterprise"
}
],
},
"attempts": 0,
"lastAttemptAt": 1606151791,
"createdAt": 1606151791,
"id": "9e7ef91a-6243-4637-b5d2-404b68841ee9"
}
Об’єкт eventData для подій контакту
Поле | Тип | Опис |
event | String | Тип події |
id | Integer | Унікальний внутрішній ідентифікатор контакту в системі HelpCrunch |
name | String | Ім'я контакту |
userId | String | Власний унікальний ідентифікатор контакту, який ви можете передати до HelpCrunch за допомогою автентифікації користувача |
String | Електронна адреса контакту | |
unsubscribed | Boolean | Статус підписки на електронну пошту контакту. Правда - відписався. Неправда - підписався. |
customData | Array | Ваші власні дані контакту представлені у вигляді масиву. Кожен атрибут складається з імені/властивості та значення. |
tags | Array | Масив об'єктів тегів. Кожен тег містить свій унікальний ідентифікатор та назву HelpCrunch. |
Щоб отримати всі доступні дані контакту, використовуйте ідентифікатор контакту з події та викликайте метод REST API "Отримати інформацію про контакт".