Webhooks позволяват на Smartsupp да изпраща известия в реално време към избран от вас URL — в момента, в който се отвори разговор, създаде се контакт или се достави съобщение, вашата система научава за това. Тази статия обяснява какво са webhooks, как да ги настроите в таблото си и как да ги свържете с платформи за автоматизация като Make и n8n.
Разделихме статията на няколко секции:
За какво са полезни webhooks?
Webhook е автоматично HTTP съобщение, което Smartsupp изпраща към избран от вас URL винаги когато се случи избрано събитие. Вместо да проверявате за промени, вашите инструменти получават данните веднага щом нещо се случи.
Типични случаи на употреба:
Платформи за автоматизация — задействайте сценарии в Make, n8n или подобни инструменти: добавяне на контакти в CRM, известия в Slack,записване на лийдове в таблица
Вътрешни системи — подавайте данни за разговори и контакти към табла, хранилища на данни или тикет системи в реално време
Известия — уведомете екипа си, когато разговор бъде оценен или доставката на съобщение се провали
Съвет: Webhooks са налични от план Plus нагоре — Plus включва 1 webhook, Expert включва 3, а Ultimate предлага персонализиран лимит. Сравнете плановете →
Създаване на webhook
Настройката на webhook отнема само няколко стъпки в таблото на Smartsupp:
1. Отворете Settings и отидете в секцията Webhooks.
2. Кликнете за добавяне на нов webhook и въведете вашия endpoint URL — адресът, на който Smartsupp ще изпраща данните за събитията.
3. Изберете събитията, които искате да получавате (пълният списък е в следващата секция).
4. Запазете webhook-а. От този момент избраните събития се доставят като HTTP POST заявки с JSON съдържание.
Забележка: По-рано настроените webhooks продължават да работят нормално. Работим по това всички съществуващи webhooks да станат видими и управляеми от новата секция в таблото.
Налични събития
Smartsupp може да уведомява вашия endpoint за събития в три категории. Избирайте само събитията, които вашият работен процес наистина изисква — така endpoint-ът остава лек и без излишен трафик.
Контакти
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 схеми на съдържанието за всеки тип събитие.
Тествайте своя webhook
Преди да пуснете в действие, използвайте вградената тестова функция, за да проверите, че endpoint-ът е достъпен и вашият сценарий в Make или n8n е настроен правилно.
От настройките на webhook-а в таблото кликнете Send test. Smartsupp ще изпрати примерни данни към вашия endpoint URL. Проверете в приемащата услуга, че данните са пристигнали в очаквания формат.
Съвет: В Make сценарият трябва да е активен и да слуша, преди да изпратите теста. В n8n превключете Webhook възела към production URL и се уверете, че работният процес е активен.
Доставка, повторни опити и сигурност
Smartsupp е проектиран да доставя webhook събития надеждно, дори когато вашият endpoint е временно недостъпен.
Формат — всички събития се изпращат като HTTP POST заявки с JSON тяло, описващо събитието и данните му
Отговор — вашият endpoint трябва да отговори с 2xx HTTP статус код възможно най-бързо; бавните отговори могат да забавят повторните опити
Повторни опити — при неуспешна доставка Smartsupp опитва отново с нарастващи интервали до 3 дни
Автоматично изключване — endpoint-и, които постоянно се провалят, се изключват автоматично; можете да ги активирате отново в таблото по всяко време
Сигурност — всяка webhook заявка е подписана, за да можете да проверите, че наистина идва от 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, създайте нов webhook и поставете копирания URL.
3. Изберете нужните събития и запазете webhook-а.
4. Кликнете Send test, за да може Make или n8n да улови структурата на данните — след това изградете останалата част от сценария върху нея.
Съвет: В Make активирайте сценария си преди да изпратите теста — иначе данните от webhook-а няма да бъдат уловени. В n8n използвайте production URL (не тестовия) при настройката на Smartsupp webhook-а.
Какво следва?
Smartsupp REST API — разгледайте пълния API за програмно четене и запис на данни в Smartsupp.
Автоматизации — настройте автоматизации по правила, които се задействат директно в Smartsupp без външен инструмент.
Преглед на интеграциите — вижте всички налични интеграции с CRM системи, e-commerce платформи и други.
💡 Нуждаете се от още помощ? Свържете се с нашия екип за поддръжка — с удоволствие ще помогнем!