Вебхуки дають змогу Smartsupp надсилати сповіщення в реальному часі на будь-яку вибрану вами URL-адресу — щойно відкривається розмова, створюється контакт або доставляється повідомлення, ваша система дізнається про це. У цій статті пояснюється, що таке вебхуки, як налаштувати їх у панелі управління та як підключити їх до платформ автоматизації, як-от Make і n8n.
Ми розділили статтю на кілька розділів:
Для чого потрібні вебхуки?
Вебхук — це автоматичне HTTP-повідомлення, яке Smartsupp надсилає на вибрану вами URL-адресу щоразу, коли відбувається вибрана подія. Замість періодичного опитування щодо змін ваші інструменти отримують дані одразу, щойно щось відбувається.
Типові сценарії використання:
Платформи автоматизації — Запускайте робочі процеси в Make, n8n або подібних інструментах, щоб додавати контакти до CRM, публікувати сповіщення в Slack або записувати ліди в електронну таблицю
Внутрішні системи — Передавайте дані розмов і контактів до панелей управління, сховищ даних або систем обробки звернень у реальному часі
Сповіщення — Сповіщайте команду, коли розмови отримують оцінки або коли не вдається доставити повідомлення
Порада: Вебхуки доступні на Плані Plus і вище — Plus включає 1 вебхук, Expert — 3, а Ultimate пропонує індивідуальний ліміт. Порівняти плани →
Створення вебхука
Налаштування вебхука в панелі управління Smartsupp складається лише з кількох кроків:
1. Відкрийте Налаштування І перейдіть до розділу Вебхуки .
2. Натисніть, щоб додати новий вебхук, і введіть URL кінцевої точки — Адресу, на яку Smartsupp надсилатиме дані подій.
3. Виберіть Події , Які хочете отримувати (повний список наведено в наступному розділі).
4. Збережіть вебхук. Відтепер вибрані події доставлятимуться як запити HTTP POST із даними у форматі JSON.
Примітка: Раніше налаштовані вебхуки продовжують працювати у звичайному режимі. Ми працюємо над тим, щоб усі наявні вебхуки відображалися в новому розділі панелі управління та були доступні для керування.
⚠️ Створювали вебхуки раніше? Старі вебхуки ще не відображаються в цьому розділі — вони продовжують працювати як раніше. Ми об’єднуємо стару й нову системи, щоб усім можна було керувати в одному місці.
Доступні події
Smartsupp може сповіщати вашу кінцеву точку про події трьох категорій. Вибирайте лише ті події, які справді потрібні вашому робочому процесу — це зменшує навантаження на кінцеву точку й допомагає уникнути зайвого трафіку.
Контакти
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Розмови
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Відвідувачі
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Пов’язані ресурси: Документація Smartsupp для розробників — Повні схеми даних JSON для кожного типу події.
Тестування вебхука
Перед запуском скористайтеся вбудованою функцією тестування, щоб перевірити доступність кінцевої точки та правильність налаштування сценарію Make або n8n.
У налаштуваннях вебхука в панелі управління натисніть Надіслати тест. Smartsupp надішле зразок даних на URL вашої кінцевої точки. Перевірте сервіс, що отримує дані, щоб переконатися, що вони надійшли в очікуваному форматі.
Порада: У Make ваш сценарій має бути активним і очікувати на дані, перш ніж ви надішлете тест. У n8n переключіть вузол Вебхук на його робочу URL-адресу та переконайтеся, що робочий процес активний.
Доставка, повторні спроби та безпека
Smartsupp забезпечує надійну доставку подій вебхуків, навіть коли ваша кінцева точка тимчасово недоступна.
Формат — Усі події надсилаються як запити HTTP POST із тілом JSON, що описує подію та її дані
Відповідь — Ваша кінцева точка має якнайшвидше відповідати кодом стану HTTP 2xx; повільні відповіді можуть затримувати повторні спроби
Повторні спроби — Якщо доставка не вдається, Smartsupp повторює спроби зі збільшенням інтервалів протягом періоду до 3 днів
Автоматичне вимкнення — Кінцеві точки, на яких постійно виникають збої, автоматично вимикаються; ви можете будь-коли знову ввімкнути їх у панелі управління
Безпека — Кожен запит вебхука підписується, щоб ви могли перевірити, що він справді надійшов від Smartsupp; див. сайт docs.smartsupp.com Для отримання докладної інформації про перевірку підпису
Примітка: Якщо вашу кінцеву точку вимкнено через повторювані збої, знову ввімкніть її в розділі Налаштування → Вебхуки Після усунення причини проблеми. Smartsupp негайно відновить надсилання подій.
Підключення Smartsupp до Make або n8n
Підключення Smartsupp до платформи автоматизації складається з чотирьох кроків. Процес однаковий для Make і n8n — відрізняється лише вузол тригера.
1. У Make Додайте Вебхуки → Власний вебхук Як тригер і скопіюйте згенеровану URL-адресу. У n8n Додайте Вебхук Як вузол тригера та скопіюйте його робочу URL-адресу.
2. У Smartsupp перейдіть до Налаштування → Вебхуки, створіть новий вебхук і вставте скопійовану URL-адресу.
3. Виберіть потрібні події та збережіть вебхук.
4. Натисніть Надіслати тест , Щоб Make або n8n зафіксував структуру даних — потім побудуйте на її основі решту сценарію або робочого процесу.
Порада: У Make активуйте сценарій перед надсиланням тесту — інакше дані вебхука не будуть зафіксовані. У n8n використовуйте Робочу URL-адресу (а не тестову URL-адресу) під час налаштування вебхука Smartsupp.
Що далі?
Smartsupp REST API — Ознайомтеся з повним API, щоб програмно читати й записувати дані Smartsupp.
Автоматизації — Налаштуйте автоматизації на основі правил, які запускаються безпосередньо в Smartsupp без зовнішнього інструмента.
Огляд інтеграцій — Перегляньте всі доступні вбудовані інтеграції з CRM, платформами електронної комерції тощо.
💡 Потрібна додаткова допомога? Зверніться до нашої Команди підтримки — Ми радо допоможемо!