Вебхуки

Вебхук передаёт события проекта вашему боту, CRM или другому сервису. Например, получатель может создать обращение по новому сообщению или обновить запись клиента после отписки. Создавать приложение для такой интеграции не требуется: вы указываете адрес получателя и выбираете нужные события.

Подключение

Откройте настройки проекта.
Выберите «Вебхуки».
На странице вебхуков нажмите «Добавить» и заполните настройки получателя.

После создания передайте секрет подписи разработчику получателя и отправьте тест.

Список вебхуков

В поиске можно найти получателя по части названия или URL. В списке показаны выбранные события, состояние, статистика доставок за 30 дней и результат последней попытки.

Нажмите строку вебхука, чтобы открыть его настройки. Если у вас есть только право просмотра, откроется история запросов.

В меню с тремя точками доступны:

«Изменить»: название, URL и события;
«Запросы»: история отправок и ответы получателя;
«Секрет подписи»: секрет для проверки входящих запросов;
«Отправить тест»: проверка подключения.

Вебхуки. Отмеченные элементы: 2. поиске; 3. меню с тремя точками — 2. поиске · 3. меню с тремя точками

Отключение и удаление

Переключатель состояния отключает или включает отправку без удаления настроек. Отключённый вебхук не получает новые события и повторные попытки; уже начатая отправка может завершиться.

Чтобы удалить получателя:

Выберите «Удалить» в его меню.
В окне подтверждения проверьте название и адрес.
Нажмите «Удалить».

Отправка на этот адрес прекратится; для подключения снова потребуется создать вебхук.

Доступ и другие интеграции

Просмотр списка и запросов доступен с правом «Просмотр вебхуков». Создание, изменение, отправка теста, просмотр секрета и удаление требуют права «Управление вебхуками». Отправка прекращается также при деактивации проекта или отзыве этого права у создателя вебхука.

Вебхук получает события, но не предоставляет боту доступ к действиям в Senler. Для действий подключите MCP Senler.io с отдельной авторизацией или используйте API-ключ проекта.

Если вы создаёте приложение для установки в разные проекты, используйте вебхуки приложения. Их настройки и секрет не связаны с отдельными вебхуками проекта.