msg8
Открыть приложение →

Подключение Bitrix24

Эта интеграция передаёт лидов из чата на вашем сайте прямо в Bitrix24 CRM: как только посетитель оставляет телефон или email, msg8 создаёт карточку (лид или контакт) и заполняет её данными, которые узнал в диалоге — имя, телефон, email, адрес, суть запроса и страницу; при желании — и саму переписку.

Всё происходит автоматически на нашей стороне. Менеджеру не нужно ничего копировать вручную, а модель ИИ для этого не используется — значит, передача лидов не тратит ваши кредиты.

⚠️ Не путайте с «1С-Битрикс: Управление сайтом» — это другой продукт той же компании, CMS для сайта. Если вам нужно загрузить в msg8 товары из 1С-Битрикса, это другая задача и другая страница: подключение каталога из вашей системы. Здесь — про Bitrix24 CRM и передачу в неё лидов.

Если вы никогда не работали с «вебхуками» Bitrix24 — не переживайте. Ниже всё разложено по шагам: нужно один раз скопировать одну ссылку из Bitrix24 и вставить её в msg8.

Что вы получите

  • Новый лид из чата сразу появляется в Bitrix24 — ничего не теряется.
  • Карточка приходит уже заполненной: контакты, запрос клиента, источник.
  • Повторы под контролем: по умолчанию каждая новая заявка создаёт новую карточку; отдельная настройка может объединять повторные заявки клиента.
  • Краткое резюме диалога — комментарием в таймлайне карточки. По желанию туда же кладётся и сам текст переписки. Если номер пришёл не в том виде, в каком его написал клиент, в комментарии есть строка «Номер как написал клиент».

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

  1. Аккаунт Bitrix24 на платном тарифе — на бесплатном тарифе Bitrix24 отключён доступ к API, и интеграция работать не сможет.
  2. Права администратора в Bitrix24, чтобы создать «входящий вебхук».
  3. Несколько минут времени.

Шаг 1. Создайте «сервисного» пользователя (рекомендуется)

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

Чтобы такого не случилось, заведите в Bitrix24 отдельного пользователя (например, «Интеграции msg8») с правами доступа к CRM и создавайте вебхук под ним. Это необязательно, но избавит вас от сюрпризов в будущем.

Шаг 2. Создайте входящий вебхук в Bitrix24

  1. В Bitrix24 откройте левое меню и найдите раздел «Разработчикам» (иногда он спрятан в пункте «Ещё» в самом низу меню).

  2. Выберите «Другое» → «Входящий вебхук».

  3. В блоке «Настройка прав» нажмите + выбрать и добавьте права доступа:

    • CRM (crm) — обязательно, чтобы создавать лиды, контакты и сделки;
    • Пользователи (user) — чтобы в msg8 можно было выбрать ответственного менеджера.

    Другие галочки (user_basic, user_brief, userfieldconfig и пр.) не нужны.

  4. Нажмите «Сохранить».

  5. Скопируйте ссылку из поля «Вебхук для вызова rest api». Она выглядит так:

    https://ваша-компания.bitrix24.ru/rest/1/abcdefg123456/

Эта ссылка — как пароль: по ней можно работать с вашей CRM. Никому её не пересылайте и не публикуйте. msg8 хранит её в зашифрованном виде.

Шаг 3. Подключите Bitrix24 в msg8

  1. В msg8 откройте Настройки → Интеграции у нужного агента.
  2. Нажмите на карточку Bitrix24 → «Подключить».
  3. Вставьте скопированную ссылку в поле «URL входящего вебхука».
  4. Нажмите «Проверить и подключить».

Если всё верно, появится зелёная плашка «Подключено к …» и название вашего портала. msg8 сам определит режим вашей CRM и подтянет списки источников, стадий и сотрудников для настройки.

Если вместо этого появилась ошибка — загляните в раздел «Если что-то пошло не так» ниже.

Шаг 4. Настройте передачу (по желанию)

Сразу после подключения всё уже работает с разумными настройками по умолчанию. При желании их можно уточнить:

  • Что создавать — «Лид» или «Контакт». По умолчанию «Авто»: msg8 сам выберет правильный вариант под режим вашей CRM (см. ниже).

  • Ответственный — менеджер, на которого назначаются новые карточки.

  • Источник — значение поля «Источник» в карточке (например, «Сайт»).

  • Стадия лида — на какую стадию воронки попадают новые лиды.

  • Защита от дублей — как найти уже существующего клиента при доставке:

    • По нашей сессии + телефону/email (рекомендуется) — находит и клиента из другого канала (звонок, форма).
    • Только по нашей сессии — ищет лишь карточки, которые раньше создал msg8.
    • Выключено — не ищет существующую карточку клиента.

    Эта настройка не объединяет отдельные заявки. По умолчанию каждая заявка создаёт отдельную рабочую карточку; объединение повторов включается отдельно в разделе «Уведомления».

  • Метки рекламы (UTM) — настраивать нечего: Bitrix24 хранит UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT и UTM_TERM в стандартных полях карточки, и msg8 заполняет их сам — настоящими значениями из ссылки, по которой пришёл этот посетитель.

    msg8 ничего не достраивает: один gclid, yclid или fbclid не превращается в придуманные UTM-значения. Идентификатор клика сохранится в msg8, а в стандартные поля Bitrix24 попадут только UTM-параметры, которые реально присутствовали в ссылке.

    Метка запоминается на входе и живёт 30 дней, поэтому доходит, даже если человек полистал сайт и написал с другой страницы. Если за последние 30 дней не было перехода с метками, поля останутся пустыми. Заполняется только при создании карточки: то, что уже записала другая ваша интеграция, msg8 не трогает.

  • Комментарий в карточке — добавлять ли комментарий в таймлайн (резюме заявки).

  • Прикладывать переписку — положить в этот комментарий текст диалога. При создании карточки — переписку целиком; при повторной заявке того же клиента, если включено объединение, — только новые сообщения. Выключено по умолчанию. Ссылка на диалог из комментария убрана — она и так попадает в поле «Источник» карточки, вместе с каналом и адресом страницы.

Нажмите «Сохранить». Кнопка «Обновить справочники» перечитывает из Bitrix24 списки сотрудников, источников и стадий, если вы поменяли их в CRM.

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

  • Лид передаётся, как только в диалоге появился телефон или email.
  • Повторная доставка той же заявки может дополнить уже созданную карточку (например, уточнённым именем). Новая заявка создаёт новую карточку, если вы отдельно не включили объединение повторов.
  • Телефон и email записываются один раз при создании — так в карточке не появляются дубли номеров.
  • Никаких обращений к ИИ: поля заполняются обычным кодом, кредиты не расходуются.

Лид, контакт или сделка: режимы CRM Bitrix24

В Bitrix24 два режима работы CRM, и от него зависит, что создаётся. При варианте «Авто» (рекомендуется) msg8 определяет режим сам — менять ничего не нужно:

  • Классическая CRM (есть лиды) → msg8 создаёт Лид в разделе «Лиды» (стадия «Не обработан»).
  • Простая CRM (лидов нет — это режим Bitrix по умолчанию) → msg8 создаёт Контакт + Сделку: контакт хранит данные клиента (раздел «Клиенты»), а сделка попадает в воронку «Сделки» (стадия «Новая»), где с ней работает менеджер.

Режим вашего портала показан на зелёной плашке после подключения. Если поменяете режим CRM в Bitrix24 — нажмите в msg8 «Обновить справочники».

Поля «Стадия лида» и выбор воронки применяются только к лидам (классический режим). В простом режиме сделки идут в воронку по умолчанию, на первую стадию.

Проверьте, что всё работает

  1. Откройте чат-виджет на сайте (или в Песочнице) и напишите боту так, будто вы клиент: оставьте имя и телефон.
  2. Откройте Bitrix24:
    • классическая CRM → CRM → Лиды (новый лид со статусом «Не обработан»);
    • простая CRM → CRM → Сделки (новая сделка) и CRM → Клиенты (контакт).
  3. Убедитесь, что появилась карточка с вашими данными и комментарий «Лид из msg8» в таймлайне. Текста переписки там не будет, пока вы не включите тумблер «Прикладывать переписку» — по умолчанию он выключен.

Если что-то пошло не так

Если на карточке интеграции появилась жёлтая плашка с ошибкой, вот что она обычно означает:

  • «Подключение разорвано» / неверные данные. Чаще всего сотрудника, под которым создан вебхук, отключили, либо администратор пересоздал вебхук (тогда старая ссылка перестаёт работать). Создайте вебхук заново (лучше под сервисным пользователем из Шага 1) и вставьте новую ссылку.
  • «Недостаточно прав». При создании вебхука не было отмечено право CRM. Откройте вебхук в Bitrix24, включите доступ к CRM (и Пользователи), сохраните и нажмите в msg8 «Обновить справочники».
  • Не удалось подключиться к Bitrix24. Проверьте, что ссылка скопирована целиком (вида https://…bitrix24.ru/rest/1/код/) и что у вас платный тариф Bitrix24 — на бесплатном API недоступен.
  • Bitrix24 временно ограничивает запросы. Это временно: лиды дойдут чуть позже автоматически, ничего делать не нужно.

Частые вопросы

Будут ли дубли в Bitrix24? Нет, при включённой защите от дублей. msg8 запоминает, какую карточку он создал, и при повторных обращениях обновляет её. А режим «по телефону/email» подхватывает и тех клиентов, что уже были в CRM из других каналов.

Тратятся ли кредиты msg8 на передачу лидов? Нет. Поля заполняются обычным кодом, без обращения к ИИ.

Можно ли подключить разных агентов к одному Bitrix24? Да. Подключите каждого агента отдельно — у каждого свои настройки (ответственный, источник, стадия).

Что будет со старыми лидами при отключении? Уже созданные карточки останутся в Bitrix24. Просто новые перестанут поступать.

Что дальше

НазадTelegram-бот для клиентовДалееПодключение amoCRM