FFlow
ENНачать бесплатно

Все ноды/Integrations/Bitrix24

Bitrix24 REST-вызов

Универсальный вызов метода Bitrix24 REST API (crm.lead.add, crm.deal.list, ...) через входящий вебхук. Требует Bitrix24 Config через порт 'bitrix24_config'. method и params (JSON-объект) поддерживают шаблоны Jinja.

Bitrix24 REST-вызов▶
Bitrix24 ConfigSuccess
Error

Тип в графе: bitrix24_rest_call

Exec

Можно включить ветку ошибки (expose_error_output) и обработать сбой отдельным путём.

Как попробовать

Минимальный рабочий воркфлоу

Вход
Bitrix24 REST-вызов▶
Конфигурация Bitrix24
Выход▶
  • Исполнение
  • Данные
  • Исполнение + данные
Нажмите «Скопировать ноды», откройте редактор и нажмите Ctrl+V на холсте.

Перед запуском выберите своё подключение или базу знаний — в графе стоит REPLACE_ME.

Как применять

Одна нода на весь Bitrix24: вы называете метод (crm.lead.add, crm.deal.list, user.get) и его параметры, а нода собирает адрес из вебхука, отправляет запрос и разворачивает ответ. Отдельных нод под лиды, сделки и задачи нет и не нужно — API портала описывается парой «метод + параметры».

Собирать то же самое HTTP-запросом не стоит: адрес вебхука — это секрет, а подставленные в HTTP-ноду значения сохраняются в журнале запуска.

Нода — шаг графа, а не инструмент агента. Чтобы модель могла звать метод сама, оберните вызов в WF-инструмент.

Как это работает

«Метод» и «Параметры» — шаблоны. Параметры пишутся JSON-объектом ({"fields": {"TITLE": "Новый лид"}}); пустое поле означает вызов без параметров. Если шаблон подставляет уже готовый объект целиком — например {{ nodes.build_params.output }}, — он используется как есть, без повторного разбора строки.

Из ответа портала нода достаёт содержимое result и кладёт его в выход: в шаблонах это {{ nodes.<id>.output.result }}. Ошибка портала (неверный метод, отозванный вебхук, отказ по правам) останавливает ноду с текстом описания из ответа; включите «Выход ошибки», чтобы обработать её в графе.

Частые ошибки

  • Параметры не объектом. Массив или строка отклоняются с ошибкой «params must be a JSON object» — оборачивайте значения в объект, как того требует метод.
  • Сломанный JSON после подстановки. Значение из шаблона попадает в параметры как есть, поэтому строки нужно заключать в кавычки самому.
  • Ожидание постраничности в выходе. Наружу отдаётся только result; служебные поля ответа, по которым Bitrix24 сообщает об остатке выборки, туда не попадают. Смещение следующей страницы задавайте в параметрах вызова.
  • Метод с опечаткой. Портал ответит ошибкой метода, и нода остановится — это не «пустой результат».

Входы

ПортПроводДанныеПримечания
Bitrix24 Configbitrix24_configДанныеdata—

обязателен

Выходы

ПортПроводДанныеПримечания
SuccessoutputИсполнение + данныеexecute_dataobject
Erroron_errorИсполнение + данныеexecute_data—

показывается, когда expose_error_output = true

Настройки

ПолеТипПо умолчаниюОписание
Подключение Bitrix24connection_idstring""

Сохранённое подключение Bitrix24 из workspace: графу с одним вызовом не нужна отдельная нода Bitrix24 Config. Нода, подключённая к порту 'bitrix24_config', имеет приоритет над этим полем.

подключение: bitrix24перекрывается портом: bitrix24_config

Методmethodstring""

Bitrix24 REST method, e.g. crm.lead.add (поддерживаются шаблоны Jinja)

поддерживает шаблоны

Параметрыparamsstring{}

JSON-объект параметров метода, напр. {"fields": {"TITLE": "New Lead"}} (поддерживаются шаблоны Jinja)

поддерживает шаблоны

Общие поля

Эти три поля есть у каждой ноды: платформа добавляет их сама, а не автор ноды.

  • expose_error_output — Если включено, показывает выход выполнения для подключения нод, которые запускаются при сбое этого шага.