Перейти до основного контенту

Вебхуки — підключіть Smartsupp до Make, n8n та власних інструментів

Налаштуйте вебхуки прямо в панелі керування та отримуйте сповіщення в реальному часі про розмови, контакти й відвідувачів у Make, n8n або власній системі.

Вебхуки дозволяють Smartsupp надсилати сповіщення в реальному часі на обраний вами URL — щойно відкривається розмова, створюється контакт або доставляється повідомлення, ваша система дізнається про це. У цій статті пояснюється, що таке вебхуки, як налаштувати їх у панелі керування та як підключити до платформ автоматизації, таких як Make і n8n.

Ми розділили статтю на кілька розділів:

Для чого потрібні вебхуки?

Вебхук — це автоматичне HTTP-повідомлення, яке Smartsupp надсилає на обраний вами URL щоразу, коли відбувається вибрана подія. Замість постійних запитів на зміни ваші інструменти отримують дані в момент, коли щось стається.

Типові сценарії використання:

  • Платформи автоматизації — запускайте робочі процеси в Make, n8n чи подібних інструментах: додавання контактів у CRM, сповіщення в Slack, запис лідів у таблицю

  • Внутрішні системи — передавайте дані про розмови й контакти в реальному часі до дашбордів, сховищ даних або тікет-систем

  • Сповіщення — повідомляйте команду, коли розмова отримує оцінку або доставка повідомлення не вдається

Порада: Вебхуки доступні починаючи з тарифу Plus — Plus включає 1 вебхук, Expert 3, а Ultimate пропонує індивідуальний ліміт. Порівняйте тарифи →

Створення вебхука

Налаштування вебхука займає лише кілька кроків у панелі керування Smartsupp:

  • 1. Відкрийте Settings і перейдіть до розділу Webhooks.

  • 2. Натисніть, щоб додати новий вебхук, і введіть ваш endpoint URL — адресу, на яку Smartsupp надсилатиме дані про події.

  • 3. Виберіть події, які хочете отримувати (повний список у наступному розділі).

  • 4. Збережіть вебхук. Відтепер вибрані події доставляються як HTTP POST-запити з JSON-вмістом.

Примітка: Раніше налаштовані вебхуки продовжують працювати як зазвичай. Ми працюємо над тим, щоб усі наявні вебхуки стали видимими та керованими з нового розділу панелі.

Доступні події

Smartsupp може сповіщати ваш endpoint про події у трьох категоріях. Вибирайте лише ті події, які справді потрібні вашому робочому процесу — так endpoint залишається легким і ви уникаєте зайвого трафіку.

Контакти

  • contact.created

  • contact.updated

  • contact.acquired

  • contact.banned

  • contact.unbanned

Розмови

  • conversation.opened

  • conversation.closed

  • conversation.closed_by_contact

  • conversation.rated

  • conversation.agent_assigned

  • conversation.agent_unassigned

  • conversation.agent_joined

  • conversation.agent_left

  • conversation.agent_replied

  • conversation.bot_replied

  • conversation.contact_replied

  • conversation.message_delivered

  • conversation.message_delivery_failed

Відвідувачі

  • visitor.connected

  • visitor.disconnected

  • visitor.updated

  • visitor.typing

  • visitor.triggered

  • visitor.replied

Пов'язані ресурси: Документація Smartsupp для розробників — повні JSON-схеми payload для кожного типу події.

Протестуйте свій вебхук

Перед запуском скористайтеся вбудованою функцією тестування, щоб переконатися, що endpoint доступний, а ваш сценарій у Make чи n8n налаштований правильно.

У налаштуваннях вебхука в панелі натисніть Send test. Smartsupp надішле зразок payload на ваш endpoint URL. Перевірте в сервісі-отримувачі, що дані надійшли в очікуваному форматі.

Порада: У Make сценарій має бути активним і слухати до надсилання тесту. В n8n переключіть вузол Webhook на production URL і переконайтеся, що робочий процес активний.

Доставка, повторні спроби та безпека

Smartsupp створений для надійної доставки подій вебхуків, навіть коли ваш endpoint тимчасово недоступний.

  • Формат — усі події надсилаються як HTTP POST-запити з JSON-тілом, що описує подію та її дані

  • Відповідь — ваш endpoint має відповідати кодом стану HTTP 2xx якомога швидше; повільні відповіді можуть затримувати повторні спроби

  • Повторні спроби — якщо доставка не вдалася, Smartsupp повторює спроби зі зростаючими інтервалами до 3 днів

  • Автоматичне вимкнення — endpoint-и, що постійно дають збій, вимикаються автоматично; ви можете будь-коли знову ввімкнути їх у панелі

  • Безпека — кожен запит вебхука підписаний, щоб ви могли перевірити, що він справді надійшов від Smartsupp; див. docs.smartsupp.com деталі перевірки підпису

Примітка: Якщо ваш endpoint вимкнено через повторювані помилки, знову ввімкніть його в Settings → Webhooks після усунення проблеми. Smartsupp одразу відновить надсилання подій.

Підключіть Smartsupp до Make або n8n

Підключення Smartsupp до платформи автоматизації займає чотири кроки. Процес однаковий для Make і n8n — відрізняється лише вузол-тригер.

  • 1. У Make додайте тригер Webhooks → Custom webhook і скопіюйте згенерований URL. В n8n додайте вузол-тригер Webhook і скопіюйте його production URL.

  • 2. У Smartsupp перейдіть до Settings → Webhooks, створіть новий вебхук і вставте скопійований URL.

  • 3. Виберіть потрібні події та збережіть вебхук.

  • 4. Натисніть Send test, щоб Make або n8n зафіксував структуру даних — потім побудуйте на ній решту сценарію.

Порада: У Make активуйте сценарій до надсилання тесту — інакше дані вебхука не буде зафіксовано. В n8n використовуйте production URL (не тестовий) під час налаштування вебхука Smartsupp.

Що далі?

  • Smartsupp REST API — ознайомтеся з повним API для програмного читання й запису даних Smartsupp.

  • Автоматизації — налаштуйте автоматизації на основі правил, які запускаються прямо в Smartsupp без зовнішнього інструменту.

  • Огляд інтеграцій — перегляньте всі доступні нативні інтеграції з CRM, платформами e-commerce та іншим.

💡 Потрібна додаткова допомога? Зверніться до нашої команди підтримки — радо допоможемо!

Схожі статті
Ви отримали відповідь на своє запитання?