Шаг HTTP request в Chat Flows

Chat Flow может задать внешней системе вопрос по HTTPS и использовать ответ в переписке: найти заказ, проверить баланс, узнать дату доставки. Шаг называется HTTP request (группа палитры Integrate) в редакторе Chat Flows приложения WASync в Bitrix24.

Что делает шаг

1. Собирает запрос из настроек шага: метод (GET или POST), URL, заголовки и, для POST, тело запроса. Подставляются {{VARIABLES}} из предыдущих шагов и из лида или сделки: в URL они кодируются как URL, в JSON-теле экранируются как JSON.
2. Выполняет запрос и ждёт ответ до 10 секунд.
3. Сопоставляет JSON-ответ с переменными потока с помощью response mapping: слева — JSON-путь (data.order.status, items[0].id), справа — имя переменной (ESTADO). Следующие шаги используют их как любой другой ответ: {{ESTADO}} в сообщении, условие в Branch, значение в Fill in a field.

Каждый вызов также задаёт три переменные:

Два исходящих ребра

У узла есть обычное ребро (успех) и красное ребро error. Ребро ошибки срабатывает, если истекло время ожидания, URL отклонён, система ответила 4xx или 5xx либо произошёл сбой сети. Если ребро ошибки не подключено, поток продолжается по обычному ребру с HTTP_OK = false, поэтому Branch по HTTP_OK всё равно может отреагировать.

Откуда выполняется запрос

Запрос выполняется не с серверов WASync. Его делает отдельный Cloudflare Worker (egress.wasync.app), у которого нет доступа к внутренним системам WASync. Из этого следуют два вывода:

• Вызов приходит в вашу систему из диапазонов IP-адресов Cloudflare, а не с фиксированного адреса WASync. Если ваш API разрешает только перечисленные IP, используйте API key или подпись; IP-адреса WASync для списка разрешённых нет.
• Медленный или неработающий API никогда не задержит и не продублирует сообщения WhatsApp: вызов выполняется вне конвейера сообщений, а поток ждёт на этом шаге ответа или истечения времени ожидания.

К чему может обращаться шаг

User agent всегда WASync-Flows/1.0 (+https://wasync.app).

Секреты

Отметьте заголовок как secret (API key, bearer-токен), и WASync сохранит его в зашифрованном виде. В редакторе он больше никогда не отображается, не экспортируется вместе с потоком и не попадает ни в журналы, ни в журнал аудита. Чтобы изменить его, введите новое значение; чтобы оставить прежним, при сохранении не заполняйте поле.

Проверьте перед сохранением

Кнопка Test request в панели шага выполняет настоящий вызов с примерами значений переменных и показывает статус, затраченное время, сопоставленные переменные и тело ответа. Кнопка Use as sample response сохраняет это тело в шаге: симулятор использует его вместо обращения к системе, поэтому весь поток можно посмотреть офлайн.

Пример: статус заказа

• Question: «¿Cuál es tu número de pedido?» (сохраняется как PEDIDO)
• HTTP request: GET https://erp.example.com/api/orders/{{PEDIDO}}, заголовок X-Api-Key (secret), сопоставление data.status → ESTADO, data.eta → ENTREGA
• Branch по HTTP_OK: true → Message Tu pedido está {{ESTADO}}, llega el {{ENTREGA}}. · false → Message No pude consultar tu pedido ahora, un asesor te escribe en breve. → Hand to a person

Чего нет в этой версии

PUT, PATCH и DELETE; OAuth для обращения к внешней системе; автоматические повторы; скачивание файлов; ожидание обратного вызова от системы. Для таких случаев используйте соседний рецепт: поток записывает поле CRM, правило автоматизации Bitrix24 уведомляет вашу систему, ваша система записывает результат обратно через Bitrix24 REST API, а правило WASync: Send WhatsApp Message отправляет его.

Каждый вызов записывается в журнал аудита рабочего пространства (хост и путь, статус, длительность, какие переменные были заданы; никогда не тело и не заголовки).