Полная интеграция SaleBot с Bitrix24
Переписка · сделки · контакты · файлы · маппинг полей · события Bitrix24 · защита от дублей
Что входит в полную интеграцию SaleBot с Bitrix24?
Полная интеграция соединяет сообщения, данные клиента и бизнес-события. Она передаёт переписку из бота в Открытую линию Bitrix24, возвращает ответы оператора в исходный мессенджер, создаёт или обновляет контакты и сделки, заполняет поля, синхронизирует стадии и сообщает SaleBot об изменениях в CRM.
Для этого используется приложение Bitrix24 и отдельный серверный сервис. Простой входящий вебхук не обеспечивает всю функциональность Открытых линий и подписки на события.
SaleBot и Bitrix24 работают рядом, но не работают вместе
Без полноценной интеграции менеджеры вручную переносят заявки, теряют контекст переписки и переключаются между интерфейсами. Бот не знает, что произошло со сделкой в CRM, а Bitrix24 не понимает, на каком шаге сценария находится клиент.
Типичные последствия:
- заявки создаются с задержкой;
- контакты и сделки дублируются;
- UTM-метки и ответы анкеты теряются;
- оператор не видит историю диалога;
- клиент получает несвоевременные сообщения;
- стадия сделки и сценарий бота расходятся;
- изменение бизнес-логики требует участия разработчика.
Как выглядит решение
Клиент пишет в бот
SaleBot принимает сообщение из подключённого мессенджера и передаёт его в сервис интеграции вместе с идентификатором пользователя и контекстом.
Сообщение попадает в Открытую линию
Интеграция создаёт или находит диалог в Bitrix24. Оператор видит сообщение и историю общения в привычном интерфейсе.
Оператор отвечает из Bitrix24
Ответ проходит через сервис-мост и отправляется клиенту в тот же диалог и мессенджер. Для клиента общение остаётся непрерывным.
CRM обновляется автоматически
Система находит или создаёт контакт, проверяет активные сделки, заполняет поля, передаёт UTM-метки, ответы анкеты и другие данные.
Bitrix24 сообщает SaleBot об изменениях
Приложение подписывается на нужные события Bitrix24. Изменение стадии, поля или другой сущности передаётся в SaleBot и может запустить сообщение, ветку или внутреннее действие.
Возможности интеграции
Открытые линии и единое окно оператора — сообщения клиента отображаются в Bitrix24, оператор отвечает из CRM, история не распадается между системами, поддерживается передача изображений и документов, клиент продолжает общение в исходном мессенджере.
Контакты и сделки — поиск существующего контакта, создание нового, проверка активной сделки, создание или обновление сделки, выбор воронки и стадии, назначение ответственного, передача UTM-меток и пользовательских полей, защита от дублей.
Гибкий маппинг полей — данные SaleBot можно сопоставить с полями контакта и сделки Bitrix24. В расширенной конфигурации маппинг выносится в панель настроек, чтобы бизнес мог изменять соответствия без доработки кода.
События Bitrix24 → SaleBot — интеграция может реагировать на согласованные события CRM: создание или изменение сделки, изменение стадии, обновление полей и другие действия.
События SaleBot → Bitrix24 — сценарий бота может создать сделку, обновить поля, передвинуть сделку на нужную стадию или передать новые сведения о клиенте.
Файлы и изображения — фотографии и документы передаются между клиентом и оператором в обе стороны.
Надёжность — защита от повторной обработки сообщений, предотвращение «эха» собственных сообщений, журналирование обмена, повторные попытки при временной недоступности системы, контроль соответствия пользователей, чатов, контактов и сделок, изоляция ключей и токенов на сервере.
Чем полная интеграция отличается от простого вебхука
| Возможность | Простой вебхук | Полная интеграция |
|---|---|---|
| Создать сделку по заявке | Да | Да |
| Найти контакт и исключить дубли | Ограниченно | Да |
| Показать переписку в Открытой линии | Нет | Да |
| Ответить клиенту из Bitrix24 | Нет | Да |
| Передавать файлы в обе стороны | Обычно нет | Да |
| Реагировать на события CRM | Ограниченно | Да |
| Синхронизировать стадии | Обычно в одну сторону | В обе стороны |
| Настраивать маппинг полей | В коде | Через конфигурацию или панель |
| Защищаться от дублей и «эха» | Требует отдельной разработки | Предусмотрено архитектурой |
Объединили чат-бот и отдел продаж в одну систему
Ситуация. Онлайн-школа вела первичное общение через SaleBot, а отдел продаж работал в Bitrix24. Заявки переносились вручную, менеджеры не видели переписку, а стадии сделки не были связаны со сценарием бота.
Результат. Путь от первого сообщения до сделки стал автоматическим. Операторы работают в Bitrix24 и видят контекст общения, а настройки полей и воронок находятся в руках бизнеса. Решение работает на реальном потоке обращений.
Технологии
Для подобных проектов может использоваться отдельный серверный контур: Python и FastAPI, PostgreSQL, Redis, Docker, OAuth-приложение Bitrix24, REST API и события Bitrix24, API и внешние запросы SaleBot, журналирование и мониторинг. Конкретный стек выбирается после аудита существующей инфраструктуры и требований к нагрузке.
Этапы проекта
Аудит
SaleBot, Bitrix24, воронок и ролей пользователей.
Описание потоков
Сообщений, данных и событий.
Проектирование модели
Контактов, сделок, чатов и идентификаторов.
Создание приложения
Приложение Bitrix24 и серверный сервис.
Настройка
Открытые линии, CRM, маппинг и подписки.
Тестирование
На тестовой воронке и диалогах.
Запуск
Наблюдение и гарантийное сопровождение.
Срок и стоимость определяются после бесплатного аудита, потому что объём зависит от количества воронок, полей, событий, мессенджеров и требований к отказоустойчивости.
Частые вопросы об интеграции
Можно ли отвечать клиенту из Bitrix24, если он пишет в SaleBot?
Создаёт ли интеграция контакты и сделки автоматически?
Можно ли передавать UTM-метки и ответы анкеты?
Может ли SaleBot узнать об изменении стадии сделки?
Можно ли передавать изображения и документы?
Подойдёт ли обычный входящий вебхук Bitrix24?
Где работает сервис интеграции?
Можно ли менять соответствие полей без разработчика?
Покажите, как сейчас связаны SaleBot и Bitrix24
Проведём бесплатный аудит, найдём ручные операции и разрывы данных, после чего предложим архитектуру интеграции — от создания сделок до полноценной работы через Открытые линии.