Перейти к основному содержимому

Bitrix24

Эта инструкция поможет настроить отправку данных из звонков в вашу CRM Bitrix24: что нужно сделать по шагам и как избежать типичных ошибок.

Что умеет интеграция​

После каждого звонка система может:

  • Создать лид или сделку в Bitrix24 с названием, именем и телефоном клиента.
  • Обновить существующий лид или сделку — если включён режим обновления и у контакта заполнен ID нужной сущности в Bitrix24 (см. раздел «Режим обновления»).
  • Создать контакт и привязать его к лиду или сделке.
  • Заполнить дополнительные поля (площадь, срочность, бюджет и т.п.) — система сама «вытащит» это из разговора с помощью ИИ.
  • Прикрепить запись разговора и текст транскрипта к лиду или сделке.
  • Отправить сделку в нужную воронку — в том числе в зависимости от исхода звонка (клиент заинтересован, переведён на оператора и т.д.).
  • Поставить сделку в нужную стадию — в том числе разную для «заинтересован» и для остальных исходов звонка.

Чтобы всё это работало, нужно один раз правильно указать адрес подключения (Webhook URL) и выбрать основные настройки.

После ввода Webhook URL нажмите «Загрузить справочники из Bitrix24» — подтянутся воронки, стадии, статусы лидов, источники и кастомные поля. Вместо ручного ввода ID можно выбирать значения из списков. При повторном открытии интеграции справочники подгружаются автоматически.

С чего начать: Webhook URL​

Webhook URL — это «адрес» вашего Bitrix24, по которому наша система будет отправлять данные. Без него интеграция не заработает.

Как получить Webhook URL​

  1. Зайдите в ваш Bitrix24 под учётной записью с правами администратора.
  2. Откройте меню (слева вверху) → Разработчикам → Другое → Входящий вебхук.
  3. Нажмите Добавить вебхук (или откройте существующий).
  4. В разделе Права доступа обязательно отметьте:
    • CRM — чтение и запись (без этого лиды и сделки создаваться не будут);
    • Диск — чтение и запись (нужно только если вы хотите прикреплять к лиду/сделке запись звонка).
  5. Сохраните настройки и скопируйте выданный URL. Он выглядит примерно так:
    https://ваша-компания.bitrix24.ru/rest/1/длинный_код/
  6. Вставьте этот 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 после первого успешного создания лида или сделки — при следующих звонках обновление пойдёт по сохранённому ID.

Если сущность с таким ID была удалена в Bitrix24 — система не будет искать другую; вместо этого сразу создаст новую сделку или лид.

Шаг 2 — по контакту в Bitrix24 (fallback)

Срабатывает только если bitrix24_deal_id/bitrix24_lead_id у контакта не заполнены. В этом случае:

  1. В Bitrix24 ищется (или создаётся) контакт по телефону.
  2. Среди сделок/лидов, привязанных к этому контакту, берётся самая свежая по внутреннему номеру в Bitrix24.
  3. Если привязанных сущностей нет — создаётся новая.

В обновляемую карточку уходят те же поля, что и при создании: название, стадия/статус, воронка (для сделок), кастомные поля из ИИ, комментарии и транскрипт.

Когда режим обновления уместен​

  • Повторные звонки одного клиента должны обогащать одну сделку или лид.
  • Нужно не засорять CRM дубликатами от одного номера.
  • Список контактов загружается с уже известными ID сделок/лидов из Bitrix24.

Когда лучше оставить выключенным​

  • Каждый звонок должен давать отдельный лид или сделку (например, отдельные этапы воронки «по звонкам»).
  • У клиента в Bitrix24 несколько активных сделок на одном контакте и нет заполненного bitrix24_deal_id — в этом случае при fallback-поиске обновится только одна (самая новая по ID).

Дополнительные поля из разговора​

Система может не только записать имя и телефон, но и заполнить ваши дополнительные поля в Bitrix24 (площадь, срочность, бюджет, комментарий и т.д.). Для этого нужно:

  1. В Bitrix24 создать нужные поля у лидов или сделок и запомнить их код (например, UF_CRM_1760467864210). Код виден в адресной строке браузера при редактировании поля в настройках CRM.
  2. В настройках интеграции в блоке «Кастомные поля для отправки в Bitrix24» описать эти поля по правилу:
    • каждая строка должна начинаться со звёздочки и пробела * ;
    • дальше пишете код поля и объяснение для ИИ через - (пробел, минус, пробел).

Пример:

* UF_CRM_1760467864210 - Сколько метров площадь объекта или окон
* UF_CRM_1760467875321 - Как срочно нужна услуга
* UF_CRM_1234567890123 - Бюджет клиента в рублях

ИИ прочитает транскрипт звонка и подставит в эти поля то, что удалось понять из разговора.
Если звёздочку в начале строки не поставить, эта строка не будет учитываться, и поле заполняться не будет.

В этом же блоке можно задать воронку (category_id) и стадию сделки (stage_id) по исходу звонка — см. разделы ниже.

Воронки для сделок​

Воронки есть только у сделок, не у лидов. Если вы создаёте сделки, можно указать, в какую воронку их класть.

Одна воронка для всех сделок​

Нажмите «Загрузить справочники из Bitrix24» и выберите воронку из списка (поле воронки). ID подставится автоматически. Если список недоступен — можно вручную указать число ID воронки (в адресной строке Bitrix24 часто бывает category_id=8).

Разные воронки в зависимости от исхода звонка​

Если нужно, чтобы сделка попадала в одну воронку, когда клиент заинтересован, и в другую — когда исход другой (например, переведён на оператора или запланирован повторный звонок), это можно задать через блок «Кастомные поля для отправки в Bitrix24».

Добавьте строку (обязательно со звёздочкой в начале):

* category_id - ID воронки (целое число). По исходу звонка (action_status в данных звонка): если interested — то 1, если пусто или null — то 2

Числа 1 и 2 замените на реальные ID ваших воронок. Система передаёт ИИ уже определённый исход звонка (заинтересован / переведён / запланирован и т.д.), и ИИ по вашей инструкции подставляет нужный ID воронки. В сделке заполнится стандартное поле «Воронка», дублирования в дополнительные поля не будет.

Стадия сделки и статус лида​

Для сделок можно задать стадию (например, «Новая», «В работе»). Для лидов — статус в воронке лидов (например, «Обработан ИИ»).

Одна стадия для всех сделок​

После загрузки справочников выберите стадию из списка (список зависит от выбранной воронки). Вручную можно указать код вида C8:UC_IXC25J (STATUS_ID стадии в Bitrix24).

Если не заполнять — сделка создастся в стадии по умолчанию в 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.

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