Appearance
HTTP-запрос из цепочки
Блок «HTTP-запрос» отправляет запрос на ваш сервер в нужный момент цепочки. Так цепочка может передать данные во внешнюю систему: начислить бонусы в CRM, создать задачу менеджеру, добавить клиента в сегмент рекламного кабинета, отправить сообщение через канал, которого нет в платформе.
По коду ответа цепочка выбирает ветку: например, если ваш сервер ответил 200, цепочка идет дальше по основной ветке, а при ошибке — по запасной.
Что нужно на вашей стороне
- Эндпоинт, который принимает запрос методом
GET,POST,PUT,PATCHилиDELETEи отвечает не дольше чем за 10 секунд. - Доступ из сети платформы. Добавьте подсеть REES46 в белые списки защиты от DDoS и файрвола — см. Подсеть REES46.
- Авторизация. Передавайте ключ в заголовке запроса, например
Authorization: Bearer <ваш токен>. Заголовки задаются в блоке и поддерживают переменные. - Идемпотентность. Используйте
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тестового клиента.
Проверка
- Создайте цепочку с блоком «HTTP-запрос» на тестовый эндпоинт, например сервис для просмотра входящих запросов.
- Включите тестовый режим и выполните стартовое событие под тестовым клиентом.
- Проверьте, что запрос пришел, переменные подставились, а цепочка пошла по нужной ветке.
- Посмотрите запись запроса в системном журнале проекта.