Интеграция бота с CRM: как передавать заявки из Telegram и MAX
Представим мастерскую: клиент выбирает в боте услугу, описывает поломку и оставляет телефон. Бот присылает ответы в рабочий чат. Чтобы начать работу, менеджеру ещё нужно создать карточку в CRM и перенести туда данные.
Содержание
Интеграцию можно настроить так, чтобы карточка создавалась после отправки анкеты. Но до разработки придётся решить, куда попадёт обращение, как найти существующего клиента и что делать, если CRM не ответила. Разберём это на примере Битрикс24. Сценарий с мастерской условный, это не клиентский кейс.
Сначала определите результат для менеджера
«Подключить бота к CRM» — слишком общее описание задачи. Для первой версии полезнее договориться о конкретном результате:
После отправки анкеты в CRM появляется обращение с выбранной услугой, описанием задачи и контактом для связи. У него есть ответственный сотрудник. Менеджер получает уведомление со ссылкой на карточку.
Отдельно решите, что именно создавать. Если обращения сначала оценивают и отсеивают, может подойти лид. Если клиент уже выбрал услугу и дальше идёт работа по заказу, можно рассмотреть сделку с привязкой к контакту. Выбор зависит от принятого у вас процесса, а не от мессенджера.
В REST API Битрикс24 предусмотрено создание лидов, сделок, контактов и компаний. Это разные объекты: один человек может обратиться повторно, и его новый заказ не обязательно требует нового контакта.
Какие данные передавать из бота
Начните с полей, по которым менеджер действительно принимает решение. Для примера с мастерской это:
- выбранная услуга;
- описание поломки;
- имя и способ связи;
- источник обращения: Telegram или MAX;
- внутренний номер заявки.
Номер нужен для разбора сбоев и повторной отправки. Его стоит записывать в отдельное согласованное поле CRM, чтобы затем можно было сопоставить карточку с заявкой в боте.
Для каждого ответа заранее укажите место в CRM. Телефон должен попадать в поле телефона. Услуга, по которой строится отчёт, должна храниться в согласованном поле или справочнике. Свободное описание задачи можно оставить комментарием. Если сложить всю анкету одним текстом, менеджер прочитает её, но фильтровать обращения по отдельным ответам будет неудобно.
Проверьте обязательные поля именно вашей CRM. Не стоит требовать от клиента бюджет или адрес только потому, что кто-то сделал их обязательными для более позднего этапа сделки. Возможно, для новых обращений нужна другая стадия или настройка полей.
Идентификатор пользователя в мессенджере храните вместе с названием платформы. Между Telegram, MAX и CRM нужно создать явную связь записей. Условное правило «одинаковое имя означает одного клиента» для этого не подходит.
Повторное обращение и повторная доставка — разные ситуации
Допустим, человек уже обращался в мастерскую, а теперь хочет заказать другую услугу. Это новое обращение существующего клиента. Интеграция должна действовать по согласованному правилу: например, создать отдельную сделку и связать её с прежним контактом.
В другом случае клиент заполнил анкету один раз, а сервер получил то же событие повторно. Так бывает при повторной доставке вебхука: Telegram и MAX повторяют запросы при неудачной доставке. Здесь новая карточка не нужна.
Поэтому в интеграции стоит предусмотреть две отдельные проверки:
- Обрабатывалась ли уже эта заявка или это событие? Для этого нужны внутренний номер заявки и учёт обработанных событий.
- Есть ли такой клиент в CRM? Для поиска можно использовать согласованные контактные данные.
У Битрикс24 есть метод поиска по телефону и email. Он возвращает идентификаторы совпавших лидов, контактов и компаний. Решение, какую запись использовать, остаётся за интеграцией или сотрудником. Например, общий телефон организации может встречаться у нескольких контактов; автоматически объединять их по одному совпадению рискованно.
Что делать, если CRM не ответила
Рабочую схему лучше строить с сохранением заявки до обращения к CRM:
Бот → сохранённая заявка → очередь отправки → CRM → сохранённый номер карточки.
Если заявка уже сохранена на сервере бота, при временной недоступности CRM клиенту не нужно заполнять её заново. Бот сможет сообщить о сохранении, а отправка продолжится через очередь. Хранение заявки, повторные попытки и восстановление очереди после перезапуска нужно проверить до запуска.
Есть неоднозначный случай: CRM создала карточку, но ответ потерялся по дороге. Повторное создание без проверки может дать дубль. Перед повтором нужно проверить, не появилась ли карточка с внешним номером этой заявки. Одновременные попытки обработки одной заявки также нужно ограничить на стороне интеграции.
Разделяйте временные сбои и ошибки, которые повтор не исправит. При сетевой ошибке или ограничении частоты запросов может помочь отложенная попытка. Если у интеграции отозваны права или не заполнено обязательное поле, нужен разбор причины и уведомление ответственному.
Для контроля достаточно начать с понятного журнала: номер заявки, состояние отправки, время последней попытки и номер карточки в CRM. Секреты доступа и полные анкеты в технические уведомления отправлять не нужно.
Как подключиться к Битрикс24 и не раскрыть доступ
Для локальной интеграции с одним Битрикс24 можно рассмотреть входящий вебхук. Через него сервер вызывает REST API. Права зависят от сотрудника, который создал вебхук, и выбранных разрешений. Перед разработкой проверьте доступность REST API для вашего Битрикс24 и права на нужные операции.
В URL вебхука есть секретный код. Документация прямо предупреждает: адрес нельзя передавать посторонним или публиковать в клиентском коде. Вызовы CRM должны идти с сервера; код вебхука не должен попадать в страницу мини-приложения, публичный репозиторий или скриншот инструкции.
Обратное направление настраивается отдельно. Исходящий вебхук Битрикс24 сообщает вашему серверу о событии в CRM. Если после смены стадии сделки клиент должен получить сообщение в боте, потребуется обработчик этого события, проверка его подлинности и связь сделки с получателем в мессенджере.
Один факт создания карточки ещё не настраивает такие уведомления. Для первой версии можно ограничиться передачей заявки менеджеру, а сообщения о ходе заказа добавить следующим этапом.
Как принимать готовую интеграцию
Проверять только новую анкету с новым телефоном недостаточно. До запуска пройдите сценарии, которые могут создать дубли или оставить заявку без обработки:
- новый клиент отправляет заполненную анкету;
- существующий клиент обращается с другой задачей;
- одна заявка обрабатывается повторно;
- по телефону найдено несколько контактов;
- CRM временно недоступна, затем связь восстанавливается;
- карточка создана, но подтверждение её создания не дошло;
- права интеграции отозваны или изменено обязательное поле;
- менеджер меняет стадию, если предусмотрено сообщение клиенту.
Для каждого теста заранее запишите ожидаемый результат. Например: «После повторной обработки той же заявки остаётся одна карточка, а в журнале виден её номер». Такие условия полезнее обещания «интеграция работает без ошибок».
Что подготовить перед заказом
Пришлите пример анкеты бота и опишите, что менеджер должен увидеть в CRM. Добавьте название CRM, нужную воронку, правило для повторных обращений и список уведомлений. На этом этапе можно использовать вымышленные данные и обезличенные скриншоты без секретов доступа.
Если CRM пока нет, сначала опишите, кто и как будет обрабатывать заявки. Для простого процесса может хватить формы и таблицы. Когда появляются ответственные, повторные обращения и работа по стадиям, будет понятнее, какую часть процесса связывать с ботом.
Технические сведения сверены с официальной документацией 9 ноября 2026 года.