Экспертиза
Материалы
контент
продукт
подкаст
Слушать последний подкаст:
Ссылки:
наши соцсети
ТГ каналы
Создавайте
любые
интеграции
с обновлённым
Webhook
SENSEI DAY/ИЮЛЬ
Одна из самых популярных механик в бизнес-процессах — это взаимодействие со сторонними сервисами с помощью отправки Webhook. Ранее для работы с этим элементом в Sensei, в некоторых случаях приходилось привлекать разработчиков для написания дополнительных скриптов.

В июльском обновлении мы доработали элемент Отправить Webhook и теперь взаимодействие со сторонними сервисами через API сможет осуществлять аналитик, без единой строчки кода. Давайте расскажем подробнее:

Возможность записывать и обрабатывать ответы

Теперь вебхуки могут записывать значения, пришедшие в теле ответа от сервера, если они в формате JSON, а также HTTP-статус и заголовки в локальные параметры.

Раньше, для обработки ответа от сервера и записи данных в локальные параметры нужен был отдельный скрипт-обработчик. Теперь записывать ответ в параметры можно прямо из конструктора.

Это упростит построение процессов, в которых важно сразу использовать полученный ответ, и расширит возможные сценарии развития процесса.

Например, в вашу воронку поступают заявки от клиентов из разных регионов, и вы хотите учитывать данные о часовом поясе клиента при постановке задач. Добавляем вебхук, который будет обращаться к стороннему сервису, чтобы определить часовой пояс клиента по номеру телефона.

Новые методы передачи данных: GET, PATCH, PUT, DELETE

Теперь в разделе "Настройки" в меню элемента появилась возможность выбора метода запроса. Это позволяет отправлять различные типы запросов вебхуками, включая GET, PATCH, PUT и DELETE. Выбор метода особенно полезен, когда вам необходимо взаимодействовать с серверами, которые поддерживают только определенные методы запросов.

Для повышения удобства использования, GET-параметры были вынесены в отдельный блок. Теперь их можно добавлять без необходимости указывать их в URL-адресе запроса.
Поддержка GET-запросов расширяет возможности пользователей при отправке вебхуков. Так, если вы работаете в компании из автомобильной отрасли и хотите передавать данные о новом клиенте из воронки продаж во внутреннюю базу данных N. И если N понимает только GET-запросы, то раньше переформатировать POST-запрос можно было только с помощью стороннего скрипта. Теперь вы можете сразу выбрать метод GET и передавать данные в нужном формате.

Возможность передавать заголовки

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

Поддержка заголовков позволяет добавлять дополнительную информацию в HTTP запросы при отправке вебхуков. Заголовки могут содержать метаданные или аутентификационные токены, что сильно расширяет возможности элемента.

Например, вы работаете в компании из отрасли онлайн-образования и хотите отправлять студентам письмо об успешной оплате счета, когда сделка попадет на соответствующий этап. Шаблоны писем хранятся в транзакционном сервисе-мейлере, который работает с большим потоком отправок. И вам необходимо передать ему авторизационный токен, нужные данные контакта и указать, какой шаблон использовать.

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

Передача POST-параметров в body

В разделе настроек отправки POST-запроса появилась возможность передавать параметры в теле запроса.

Вместо того чтобы передавать параметры в формате urlencoded (параметр и значение), можно передать всё тело запроса. Это позволяет отправлять более сложные данные, такие как JSON, XML, текстовые данные и т.д.

Вы сможете отправлять структурированные данные в разных форматах с различными полями и значениями без ограничения по длине символов.

Допустим, компании из отрасли недвижимости важно создавать счёт после того, как сделка в CRM-системе перейдёт на этап «Договор подписан». Счёт можно создать в сервисе автоматической генерации документов, но передать данные можно только в формате JSON.

Раньше для этой задачи создавался отдельный скрипт, который переформатировал передаваемые данные в JSON. Теперь достаточно указать значение JSON в заголовке Content-Type и передать данные в теле запроса.