Уебхуковете позволяват на 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 системи, платформи за електронна търговия и други.
💡 Нуждаете се от още помощ? Свържете се с нашия Екип за поддръжка — с радост ще Ви помогнем!