Вебхуки позволяют 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.
Что дальше?
REST API Smartsupp — изучите полный API для программного чтения и записи данных Smartsupp.
Автоматизации — настройте автоматизации на основе правил, которые запускаются непосредственно в Smartsupp без внешнего инструмента.
Обзор интеграций — ознакомьтесь со всеми доступными встроенными интеграциями с CRM, платформами электронной коммерции и другими системами.
💡 Нужна дополнительная помощь? Обратитесь в нашу Службу поддержки — мы будем рады помочь!