msg8Документация
Открыть приложение →
Разделы документации

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

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

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

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

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

  • Новый лид из чата сразу появляется в Bitrix24 — ничего не теряется.
  • Карточка приходит уже заполненной: контакты, запрос клиента, источник.
  • Без дублей: если клиент вернётся, обновится та же карточка, а не создастся новая.
  • Ссылка на переписку и краткое резюме диалога — прямо в таймлайне карточки.

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

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

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

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

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

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

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

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

  3. На открывшейся странице отметьте права доступа. Обязательно включите:

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

  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 (см. ниже).
  • Ответственный — менеджер, на которого назначаются новые карточки.
  • Источник — значение поля «Источник» в карточке (например, «Сайт»).
  • Стадия лида — на какую стадию воронки попадают новые лиды.
  • Защита от дублей — как msg8 распознаёт повторные обращения:
    • По нашей сессии + телефону/email (рекомендуется) — не создаст дубль, даже если клиент уже есть в Bitrix24 из другого канала (звонок, форма).
    • Только по нашей сессии — быстрее, но клиент из другого канала может задвоиться.
    • Выключено — каждое обращение создаёт новую карточку.
  • Прикладывать переписку — добавлять резюме диалога и ссылку на него в таймлайн карточки.

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

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

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

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

В Bitrix24 есть два режима работы CRM, и от него зависит, что создавать:

  • Классический режим (есть лиды) → msg8 создаёт Лид.
  • Упрощённый режим (лидов нет, только сделки и контакты) → msg8 создаёт Контакт.

При выбранном варианте «Авто» msg8 определяет режим сам и делает правильно — менять ничего не нужно. Режим вашего портала показан на плашке после подключения.

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

  1. Откройте чат-виджет на сайте (или в Песочнице) и напишите боту так, будто вы клиент: оставьте имя и телефон.
  2. Откройте Bitrix24 → раздел CRM → Лиды (или Контакты в упрощённом режиме).
  3. Убедитесь, что появилась новая карточка с вашими данными и переписка в таймлайне.

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

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

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

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

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

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

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

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

Что дальше

НазадИнтеграцииДалееВстраивание