К основному содержимому

Вебхуки — подключите 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 и другим.

💡 Нужна дополнительная помощь? Свяжитесь с нашей службой поддержки — мы с радостью поможем!

Другие статьи по теме
Нашли ответ на свой вопрос?