Skip to content

HTTP-запрос из цепочки ​

Блок «HTTP-запрос» отправляет запрос на ваш сервер в нужный момент цепочки. Так цепочка может передать данные во внешнюю систему: начислить бонусы в CRM, создать задачу менеджеру, добавить клиента в сегмент рекламного кабинета, отправить сообщение через канал, которого нет в платформе.

По коду ответа цепочка выбирает ветку: например, если ваш сервер ответил 200, цепочка идет дальше по основной ветке, а при ошибке — по запасной.

Что нужно на вашей стороне ​

  1. Эндпоинт, который принимает запрос методом GET, POST, PUT, PATCH или DELETE и отвечает не дольше чем за 10 секунд.
  2. Доступ из сети платформы. Добавьте подсеть REES46 в белые списки защиты от DDoS и файрвола — см. Подсеть REES46.
  3. Авторизация. Передавайте ключ в заголовке запроса, например Authorization: Bearer <ваш токен>. Заголовки задаются в блоке и поддерживают переменные.
  4. Идемпотентность. Используйте message_code как ключ идемпотентности: он одинаков для одного блока в одном запуске цепочки у клиента. Новый запуск цепочки — это новый message_code и новый запрос.

Настройка блока ​

ПолеОписание
МетодGET, POST, PUT, PATCH, DELETE
URLАдрес эндпоинта. Поддерживает переменные: https://crm.example.com/clients/{{ external_id }}/bonus
ЗаголовкиПары «имя — значение», значение поддерживает переменные
Тело запросаПроизвольный текст, обычно JSON. Поддерживает переменные
Коды успехаКоды ответа через запятую, например 200,201. Ответ с таким кодом ведет в основную ветку
Список промокодовЕсли выбран, клиенту выдается промокод из списка, он доступен в переменной promocode

Пример тела запроса:

json
{
  "client_id": "{{ external_id }}",
  "email": "{{ email }}",
  "phone": "{{ phone }}",
  "promocode": "{{ promocode }}",
  "chain": {{ campaign_id }},
  "request_id": "{{ message_code }}"
}

Переменные подставляются шаблонизатором Liquid, поэтому доступны фильтры: {{ first_name | default: "друг" }}, {{ email | url_encode }}. Строковые значения в JSON берите в кавычки.

Переменные ​

ПеременнаяОписание
client_idИдентификатор клиента в платформе
external_idИдентификатор клиента в вашей системе
didИдентификатор последнего устройства клиента
email, phone, telegram_idКонтакты клиента
first_name, last_name, middle_nameИмя, фамилия, отчество
gender, age, birthdayПол, возраст, дата рождения
locationЛокация клиента
loyalty_status, loyalty_bonuses, loyalty_bonuses_to_next_levelДанные программы лояльности
propertiesПользовательские свойства клиента (нужна услуга CDP)
promocodeПромокод из выбранного списка
campaign_idИдентификатор цепочки
message_codeУникальный код запроса — используйте для идемпотентности

Дополнительно доступны данные события, запустившего цепочку: например, items (товары) и order для покупки, status для статуса заказа, segment_id для входа в сегмент, параметры кастомного события.

Ответ и выбор ветки ​

  • Код ответа из списка «Коды успеха» → основная ветка.
  • Любой другой код → запасная ветка. Если запасной ветки нет, цепочка для клиента завершается.
  • Сервер не ответил за 10 секунд или соединение не установилось (5 секунд на подключение) — это код 504. Если 504 есть в кодах успеха, цепочка пойдет по основной ветке.

Тело ответа платформа не разбирает. Запрос и ответ сохраняются в системном журнале проекта, там их можно посмотреть при отладке.

Повторов нет

Платформа не повторяет запрос при ошибке или таймауте: один блок отправляет не больше одного запроса на запуск цепочки. Если запрос важен, обрабатывайте сбои по запасной ветке — например, отправьте письмо менеджеру — или ставьте запрос в очередь на своей стороне и отвечайте сразу.

Режим тишины и тестовый режим ​

  • Запрос подчиняется режиму тишины так же, как сообщения: в тихие часы он откладывается до их окончания.
  • Цепочка в тестовом режиме отправляет запросы по-настоящему. Используйте тестовый эндпоинт или различайте тестовые запросы по client_id тестового клиента.

Проверка ​

  1. Создайте цепочку с блоком «HTTP-запрос» на тестовый эндпоинт, например сервис для просмотра входящих запросов.
  2. Включите тестовый режим и выполните стартовое событие под тестовым клиентом.
  3. Проверьте, что запрос пришел, переменные подставились, а цепочка пошла по нужной ветке.
  4. Посмотрите запись запроса в системном журнале проекта.