Консоль
Интеграции

Bitrix24

Настройка Bitrix24 через входящий webhook и маппинг полей CRM

Интеграция Bitrix24 подключает портал команды через входящий webhook. После сохранения Айва может подтянуть каталог полей и использовать подготовленный маппинг в агентах.

Что понадобится

  • входящий Webhook URL Bitrix24
  • доступ webhook к CRM-методам портала
  • понимание, в какие поля лида или другого CRM-объекта нужно записывать данные агента

Как добавить интеграцию

  1. В Bitrix24 откройте Еще -> Настройка -> Интеграции -> REST API -> Другое -> Входящий вебхук.
  2. Создайте webhook и скопируйте его URL.
  3. В консоли Айва откройте Integrations -> Bitrix24 -> Добавить интеграцию.
  4. Вставьте Webhook URL и сохраните запись.

Backend проверяет webhook через Bitrix profile method до сохранения.

Что сделать после сохранения

  • Откройте страницу интеграции и нажмите Обновить поля.
  • В блоке Маппинг полей включите только те поля Bitrix24, которые должен заполнять агент.
  • Для поля comments можно добавить отдельную инструкцию, что именно LLM должна туда записывать.
  • Если схема CRM изменилась, снова нажмите Обновить поля.

Как назначить агенту

  1. Откройте агента и перейдите в его интеграции.
  2. Выберите подготовленную интеграцию Bitrix24.
  3. Если рядом есть пометка требует настройки, сначала вернитесь в карточку интеграции и завершите маппинг полей.
  4. Сохраните агента.

Безопасный пример

Webhook URL: https://example.bitrix24.ru/rest/1/demo-webhook/
Target fields: NAME, PHONE, EMAIL, COMMENTS
Comments instruction: Кратко опиши итог разговора и следующий шаг менеджера.

Если данные не записываются

  • убедитесь, что webhook все еще действителен
  • обновите каталог полей после изменений в Bitrix24
  • проверьте, что нужные поля включены в маппинге, а не только отображаются в списке