Bitrix24
Эта инструкция поможет настроить отправку данных из звонков в вашу CRM Bitrix24: что нужно сделать по шагам и как избежать типичных ошибок.
Что умеет интеграция
После каждого звонка система может:
- Создать лид или сделку в Bitrix24 с названием, именем и телефоном клиента.
- Обновить существующий лид или сделку — если включён режим обновления и у контакта заполнен ID нужной сущности в Bitrix24 (см. раздел «Режим обновления»).
- Создать контакт и привязать его к лиду или сделке.
- Заполнить дополнительные поля (площадь, срочность, бюджет и т.п.) — система сама «вытащит» это из ра зговора с помощью ИИ.
- Прикрепить запись разговора и текст транскрипта к лиду или сделке.
- Отправить сделку в нужную воронку — в том числе в зависимости от исхода звонка (клиент заинтересован, переведён на оператора и т.д.).
- Поставить сделку в нужную стадию — в том числе разную для «заинтересован» и для остальных исходов звонка.
Чтобы всё это работало, нужно один раз правильно указать адрес подключения (Webhook URL) и выбрать основные настройки.
С чего начать: Webhook URL
Webhook URL — это «адрес» вашего Bitrix24, по которому наша система будет отправлять данные. Без него интеграция не заработает.
Как получить Webhook URL
- Зайдите в ваш Bitrix24 под учётной записью с правами админ истратора.
- Откройте меню (слева вверху) → Разработчикам → Другое → Входящий вебхук.
- Нажмите Добавить вебхук (или откройте существующий).
- В разделе Права доступа обязательно отметьте:
- CRM — чтение и запись (без этого лиды и сделки создаваться не будут);
- Диск — чтение и запись (нужно только если вы хотите прикреплять к лиду/сделке запись звонка).
- Сохраните настройки и скопируйте выданный URL. Он выглядит примерно так:
https://ваша-компания.bitrix24.ru/rest/1/длинный_код/ - Вставьте этот URL в поле «Webhook URL» в настройках интеграции у нас.
Важно: вставляйте URL целиком, без лишних цифр или путей в конце. Если в конце случайно окажется что-то вроде /111, Bitrix24 будет выдавать ошибку «Метод не найден».
Что создавать в Bitrix24: лид или сделка
В настройках интеграции нужно выбрать: после звонка создаётся лид или сделка.
- Лид — подойдёт для холодных звонков и новых обращений: человек только оставил заявку или первый раз созвонился. Лиды потом можно вручную или по правилам переводить в сделки.
- Сделка — подойдёт, когда вы уже ведёте клиента по этапам (воронкам): «Новая», «В работе», «Договор» и т.д. У сделки можно указать воронку и стадию.
Выберите тот вариант, который соответствует тому, как вы работаете в CRM: в основном «принимаете заявки» — берите лид; ведёте клиентов по этапам — сделку.
Отправка записей и только заинтересованных
Отправлять аудиозапись звонка в Bitrix24
Если включить эту опцию, к лиду или сделке будет прикреплять ся файл с записью разговора. Для этого у вебхука в Bitrix24 должны быть права на Диск (см. раздел про Webhook URL).
Отправлять только заинтересованные диалоги
Если включить:
- в Bitrix24 попадут только те звонки, по которым система пометила исход «Заинтересован»;
- звонки без интереса в CRM отправляться не будут.
Если выключить — в Bitrix24 будут уходить данные по каждому завершённому звонку. Для холодных обзвонов часто удобнее включать «только заинтересованные», чтобы не засорять CRM.
Создание контакта
Опция «Создавать контакт в Bitrix24»:
- Включено — вместе с лидом или сделкой будет создан контакт (имя, телефон) и привязан к этой лиду/сделке. Обычно так и нужно.
- Выключено — создаётся только лид или сделка, без контакта. Имеет смысл, если контакты вы создаёте сами или подтягиваете из другого источника.
Важно для режима об новления: основной способ поиска сущности — по полям bitrix24_lead_id / bitrix24_deal_id в карточке контакта вашей системы (заполняются при импорте или вручную). Если эти поля заполнены, создание контакта в Bitrix24 для поиска не требуется. Если поля не заполнены — система ищет сущность по контакту в Bitrix24: оставьте «Создавать контакт» включённым и убедитесь, что контакт с тем же телефоном есть в CRM и к нему привязан нужный лид или сделка.
Режим обновления лидов и сделок
По умолчанию после каждого подходящего звонка создаётся новый лид или новая сделка. Если вам нужно дополнять карточку при повторных звонках одного клиента и не плодить дубликаты, включите настройку обновления существующих записей (в форме интеграции это может называться в духе «Обновлять существующие» / «Режим обновления» — значение «да» / true).
Как это работает
Система ищет сущность для обновления в два шага:
Шаг 1 — по заранее известному ID (приоритетный)
Если в карточке контакта вашей системы заполнено поле bitrix24_deal_id (для сделок) или bitrix24_lead_id (для лидов), система сразу обновляет именно эту сущность — без поиска по телефону или контакту. Это самый точный и надёжный способ.
Поля заполняются при импорте контактов: достаточно добавить колонку bitrix24_deal_id или bitrix24_lead_id с ID нужной сущности из Bitrix24.
Если сущность с таким ID была удалена в Bitrix24 — система не будет искать другую; вместо этого сразу создаст новую сделку или лид.
Шаг 2 — по контакту в Bitrix24 (fallback)
Срабатывает только если bitrix24_deal_id/bitrix24_lead_id у контакта не заполнены. В этом случае:
- В Bitrix24 ищется (или создаётся) контакт по телефону.
- Среди сделок/лидов, привязанных к этому контакту, берётся самая свежая по внутре ннему номеру в Bitrix24.
- Если привязанных сущностей нет — создаётся новая.
В обновляемую карточку уходят те же поля, что и при создании: название, стадия/статус, воронка (для сделок), кастомные поля из ИИ, комментарии и транскрипт.
Когда режим обновления уместен
- Повторные звонки одного клиента должны обогащать одну сделку или лид.
- Нужно не засорять CRM дубликатами от одного номера.
- Список контактов загружается с уже известными ID сделок/лидов из Bitrix24.
Когда лучше оставить выключенным
- Каждый звонок должен давать отдельный лид или сделку (например, отдельн ые этапы воронки «по звонкам»).
- У клиента в Bitrix24 несколько активных сделок на одном контакте и нет заполненного
bitrix24_deal_id— в этом случае при fallback-поиске обновится только одна (самая новая по ID).
Дополнительные поля из разговора
Система может не только записать имя и телефон, но и заполнить ваши дополнительные поля в Bitrix24 (площадь, срочность, бюджет, комментарий и т.д.). Для этого нужно:
- В Bitrix24 создать нужные поля у лидов или сделок и запомнить их код (например,
UF_CRM_1760467864210). Код виден в адресной строке браузера при редактировании поля в настройках CRM. - В настройках интеграции в блоке «Кастомные поля для отправки в Bitrix24» описать эти поля по правилу:
- каждая строка должна начинаться со звёздочки и пробела
*; - дальше пишете код поля и объяснение для ИИ через
-(пробел, минус, пробел).
- каждая строка должна начинаться со звёздочки и пробела
Пример:
* UF_CRM_1760467864210 - Сколько метров площадь объекта или окон
* UF_CRM_1760467875321 - Как срочно нужна услуга
* UF_CRM_1234567890123 - Бюджет клиента в рублях
ИИ прочитает транскрипт звонка и подставит в эти поля то, что удалось понять из разговора.
Если звёздочку в начале строки не поставить, эта строка не будет учитываться, и поле заполняться не будет.
В этом же блоке можно задать воронку (category_id) и стадию сделки (stage_id) по исходу звонка — см. разделы ниже.
Воронки для сделок
Воронки есть только у сделок, не у лидов. Если вы создаёте сделки, можно указать, в какую воронку их класть.
Одна воронка для всех сделок
В поле «ID категории (воронки) для сделок Bitrix24» укажите число — ID нужной воронки (например, 8). Тогда все сделки из этой интеграции будут попадать в эту воронку. Как узнать ID: откройте в Bitrix24 раздел «Сделки», переключите воронку и посмотрите в адресную строку браузера — там часто бывает category_id=8 (число 8 и есть ID).
Разные воронки в зависимости от исхода звонка
Если нужно, чтобы сделка попадала в одну вор онку, когда клиент заинтересован, и в другую — когда исход другой (например, переведён на оператора или запланирован повторный звонок), это можно задать через блок «Кастомные поля для отправки в Bitrix24».
Добавьте строку (обязательно со звёздочкой в начале):
* category_id - ID воронки (целое число). По исходу звонка (action_status в данных звонка): если interested — то 1, если пусто или null — то 2
Числа 1 и 2 замените на реальные ID ваших воронок. Система передаёт ИИ уже определённый исход звонка (заинтересован / переведён / запланирован и т.д.), и ИИ по вашей инструкции подставляет нужный ID воронки. В сделке заполнится стандартное поле «Воронка», дублирования в дополнительные поля не будет.
Стадия сделки и статус лида
Для сделок можно задать стадию (например, «Новая», «В работе»). Для лидов — статус в воронке лидов (например, «Обработан ИИ»).
Одна стадия для всех сделок
В поле «ID стадии для сделок Bitrix24» укажите значение в формате C8:UC_IXC25J (номер воронки и код стадии). Эти коды можно посмотреть в настройках воронок в Bitrix24: у каждой стадии в API и в настройках есть поле STATUS_ID — именно его и нужно подставлять (например, C9:PREPARATION, C9:PREPAYMENT_INVOICE).
Если не заполнять — сделка создастся в той стадии/статусе, которая в Bitrix24 стоит по умолчанию.
Разные стадии в зависимости от исхода звонка
Если нужно, чтобы сделка попадала в одну стадию, когда клиент заинтересован, и в другую — когда исход другой (пусто, переведён, запланирован и т.д.), это задаётся через блок «Кастомные поля для отправки в Bitrix24».
Добавьте строку (обязательно со звёздочкой в начале):
* STAGE_ID - ID стадии сделки. По исходу звонка (action_status): если interested — то C9:PREPAYMENT_INVOICE, если пусто или null — то C9:PREPARATION
Значения C9:PREPAYMENT_INVOICE и C9:PREPARATION замените на реальные STATUS_ID ваших стадий (формат C{ID воронки}:{код стадии}). Как узнать STATUS_ID: в Bitrix24 в настройках воронки сделок у каждой стадии в ответе API или в интерфейсе есть поле STATUS_ID — его и нужно указывать.
Система передаёт ИИ уже определённый исход звонка, и ИИ по этой инструкции подставляет нужный ID стадии. В сделке заполнится стандартное поле «Стадия».
Статус лида
Для лидов можно задать статус в воронке лидов в поле «ID статуса лида в воронке лидов» (например, UC_Q3ARRP). Коды есть в настройках воронки лидов в Bitrix24.
Если не заполнять — лид создастся в том статусе, который в Bitrix24 стоит по умолчанию.
Разные статусы лида в зависимости от исхода звонка
По такому же принципу, как STAGE_ID для сделок, можно задать разные статусы лида через блок «Кастомные поля для отправки в Bitrix24».
Добавьте строку (обязательно со звёздочкой в начале):
* STATUS_ID - Статус лида. По исходу звонка (action_status): если interested — то UC_ABCDEF, если пусто или null — то UC_Q3ARRP
Коды UC_ABCDEF и UC_Q3ARRP замените на реальные коды ваших статусов из воронки лидов Bitrix24. В лиде заполнится стандартное поле «Статус», в кастомные поля ничего лишнего не попадёт.
Источник клиента
В поле «ID поля Bitrix24 для передачи источника контакта» нужно указать куда в Bitrix24 писать источник. Поведение зависит от выбранного типа поля:
Тип «Стандартное»
В стандартное поле SOURCE_ID лида или сделки подставляется фиксированный код, который вы указали в настройках интеграции — например WEB или CALL. Это код из справочника источников Bitrix24 (CRM → Настройки → Справочники → Источники). Значение поля «Источник» карточки контакта в нашей системе при этом не используется.
Тип «Кастомное»
В дополнительное поле лида или сделки с указанным кодом (например UF_CRM_1760467864210) записывается текстовое значение источника из карточки контакта вашей системы (например: «Лендинг», «Реклама ВК», «Заявка с сайта»). Если у контакта источник не заполнен — поле в Bitrix24 останется пустым.
Если поле «ID поля Bitrix24 для передачи источника контакта» не заполнять, источник в Bitrix24 передаваться не будет.
Проверка подключения
После того как вы заполнили Webhook URL и сохранили настройки интеграции, нажмите кнопку «Протестировать подключение».
Система создаст в Bitrix24 тестовый лид (или сделку) с тестовыми данными и комментарием. Если тест прошёл успешно — подключение настроено верно, можно по льзоваться. Если появилась ошибка «Метод не найден» (404) — проверьте Webhook URL и права вебхука (обязательно CRM, при отправке записей — ещё и Диск).
Что делать, если что-то не работает
| Что происходит | Что проверить |
|---|---|
| Ошибка «Метод не найден» (404) при создании лида/сделки или контакта | URL вебхука скопирован полностью и без лишних символов в конце. В настройках входящего вебхука в Bitrix24 выданы права CRM (чтение и запись). |
| Дополнительные поля не заполняются, воронка не подставляется | В блоке кастомных полей каждая нужная строка начинается со звёздочки и пробела (* ). Для воронки по исходу звонка добавлена строка с полем category_id и понятным описанием для ИИ. |
| Сделки создаются без воронки | Вы создаёте именно сделки (не лиды). Заполнено поле «ID категории (воронки)» или в кастомных п олях добавлена строка с category_id и правилами по исходу звонка. |
| Сделки создаются без нужной стадии или стадия не меняется по исходу звонка | Заполнено поле «ID стадии для сделок Bitrix24» (одна стадия для всех) или в кастомных полях добавлена строка с полем STAGE_ID и инструкцией для ИИ по исходу звонка (interested / пусто или null). Убедитесь, что строка начинается со звёздочки и в описании указаны реальные STATUS_ID стадий из Bitrix24. |
| Запись звонка не прикрепляется к лиду/сделке | В настройках вебхука в Bitrix24 включены права на Диск. У нас в интеграции включена опция «Отправлять аудиозапись звонка в Bitrix24». |
| Режим обновления включён, но каждый раз появляется новый лид/сделка | Проверьте, заполнено ли поле bitrix24_deal_id / bitrix24_lead_id у контакта в вашей системе. Если поля пусты, система ищет по контакту в Bitrix24: убедитесь, что включено «Создавать контакт», у контакта есть телефон, и в Bitrix24 к этому контакту привязана сделка или лид нужного типа. |
| Обновляется «не та» сделка | Заполните поле bitrix24_deal_id у контакта — тогда система обновит именно указанн ую сделку. Без этого поля при fallback-поиске по контакту обновляется сделка с наибольшим ID среди привязанных. |
| Режим обновления включён, сущность была удалена в Bitrix24 — вместо обновления создаётся новая | Это ожидаемое поведение: если сущность удалена и bitrix24_deal_id/bitrix24_lead_id недействителен, система создаёт новую запись. Обновите поле в карточке контакта на актуальный ID. |
Если проблема не решается — сохраните текст ошибки из логов или с экрана и обратитесь в поддержку, указав, на каком шаге возникает ошибка (тест подключения, первый реальный звонок и т.д.).