Подключение
- Перейдите в раздел «Колл-листы», выберите нужный колл-лист, откройте вкладку «Вебхуки».
- Нажмите «Создать вебхук» и выберите Битрикс24.
- Вставьте полный URL входящего вебхука, полученный из Битрикс24.
Как настроить вебхук в Битрикс24
- Зайдите в настройки Битрикс24 (шестерёнка в верхнем правом углу).
- Выберите «Разработчикам» → «Другие» → «Входящие вебхуки».
- Нажмите «Добавить вебхук».
- Выберите необходимые права доступа (минимум — «CRM (crm)»).
- Скопируйте полный URL вебхука и вставьте в поле на платформе.
- Нажмите «Подключить» — платформа проверит соединение.
Выбор событий
- На шаге «События» выберите, какие исходы обзвона передавать в CRM.
После подключения CRM вы выбираете один или несколько исходов сессии звонка. Для каждого — свой набор действий в Битрикс24 (воронка, поля, комментарий).
| Исход | Когда срабатывает | По умолчанию |
|---|---|---|
| Лиды | Нейронка квалифицировала контакт и договорилась о следующем шаге (agreements.isCommit = true) | Включён |
| Отказы | Был разговор, но до договорённости не дошли — возражение, «не интересно», не ЦА (agreements.status = close) | Опционально |
| Недозвоны | Не дозвонились ни разу за все попытки по колл-листу; передача после исчерпания попыток | Опционально |
Событие
call_session_result приходит один раз — после финальной попытки сессии, а не после каждого звонка. Платформа сама определяет исход и применяет настройки соответствующей вкладки.Что отличается между исходами
- Лиды — полный набор переменных для маппинга, комментарий в таймлайн включён по умолчанию.
- Отказы — в маппинге доступны поля звонка, контакта и сессии; из договорённостей — только имя клиента из диалога. Блок «Комментарий в таймлайн» по умолчанию выключен; если включить — комментарий в урезанном виде: имя, телефон, длительность, запись, теги, транскрипт — без договорённостей, региона, «о клиенте» и доп. полей контакта.
- Недозвоны — для маппинга доступен полный набор переменных (как у лидов). Блок «Комментарий в таймлайн» в визарде скрыт — комментарий не добавляется.
Настройка
- На шаге «Настройка» задайте отдельный маршрут для каждого выбранного исхода. В левой колонке переключайтесь между исходами — статус «Настроить» сменится на «Настроено» после включения хотя бы одной сущности (лид, контакт или компания).
Для каждого выбранного исхода — до четырёх сущностей. Каждую можно включить или отключить тумблером.
Сущность 1 — Новая компания
Привязывается к контакту и лиду. Доступные поля:- Название компании
- Телефон
- Web
- и другие дополнительные поля из вашего аккаунта
Сущность 2 — Новый контакт
Привязывается к лиду. Доступные поля:- Имя
- Телефон
- и другие дополнительные поля из вашего аккаунта
Сущность 3 — Лид или сделка
Переключатель в блоке: лид или сделка (подсказка «Нажмите, чтобы сменить на…»). Доступные поля зависят от выбранного типа:- Название (
name) - Статус лида — для классического лида
- Воронка и стадия — для сделки в воронке продаж
- и другие дополнительные поля из вашего аккаунта
Сущность 4 — Комментарий в таймлайн
Добавляет в таймлайн записи Битрикс24 сообщение с историей звонка. Содержимое по умолчанию:- Имя, телефон, длительность и время начала звонка
- Заинтересованность, запись звонка, договорённости, время договорённости
- Возможный регион, теги
- О клиенте, доп. поля контакта
- Закрывающее сообщение, лид-трансфер
- Транскрипт звонка
Маппинг полей
В каждой сущности настраиваете, какие данные из звонка попадут в конкретные поля CRM. Поля подтягиваются динамически из вашего аккаунта — видите только те, что реально существуют. В каждое поле вводите текст вручную, вставляете переменную или комбинируете оба варианта через кнопку{·}. Кастомные поля контакта из колл-листа доступны в том же списке переменных.
Для поиска нужного поля — строка «Поиск по имени поля» (от 3 символов).
Редактирование интеграции
Чтобы изменить настройки существующей интеграции, нажмите «Настройки CRM» (иконка шестерёнки) в строке вебхука. Откроется тот же экран «Настройка» — меняйте маппинг без пересоздания интеграции.Проверка
После настройки нажмите «Тест» — платформа отправит в Битрикс24 тестовый запрос со всеми настроенными полями, включая кастомные. Проверьте результат прямо в CRM, до запуска реального прозвона. Когда всё устраивает — нажмите «Сохранить». Включить или отключить интеграцию можно тумблером в списке вебхуков.Загрузка контактов из Битрикс24 в колл-лист — отдельный сценарий: раздел «Интеграции» → CRM. Подробнее — Передача контактов.