
CRM - система управления отношениями с клиентами. До интеграции бота с CRM согласуйте, какие данные передавать, где сохранять заявку, как обрабатывать повторы и проверять результат в CRM. Назначьте сотрудника, который разбирает ошибки передачи, и договоритесь, кто подхватывает заявки, пока менеджер не взял их в работу. Сообщение «заявка отправлена» должно соответствовать тому, что система действительно успела сделать.
Начните с результата для отдела продаж: какая карточка появляется, что в ней заполнено, кому она назначена и как заметить задержку. Затем разберите, что произойдёт при недоступности CRM, повторном сообщении или перезапуске сервера. Эти условия следует включить в задачу подрядчику до разработки.
Какой результат должна давать интеграция
Бот собирает обращение, а CRM помогает организовать дальнейшую работу с клиентом. Между ними нужен согласованный маршрут: принять данные, сохранить их, создать или обновить карточку и передать её ответственному.
Сначала определите, что считать завершённой заявкой. Например, пользователь выбрал услугу, оставил контакт и подтвердил отправку. Незаконченный диалог можно хранить как черновик, но у него должен быть отдельный статус.
Затем согласуйте, какая запись появится в CRM: карточка обращения потенциального клиента (лид), карточка продажи (сделка) или другой объект. Укажите путь продажи по этапам (воронку), начальный этап, ответственного и обязательные поля. В документации Bitrix24 по созданию элементов CRM права и заполнение обязательных полей входят в проверку запроса. Для рабочего проекта их нужно сверить с настройками конкретной системы.
Успешное создание карточки закрывает технический этап передачи. Начало работы менеджера требует отдельного события: принятия обращения, смены этапа или другого согласованного действия.
О каких данных и повторах договориться
Для каждого поля определите источник, формат и поведение при пустом значении. Разработчику важно знать, где хранить выбранную услугу, контакт, комментарий, источник обращения и вложения. Если поле CRM изменится, должно быть понятно, кто обновляет соответствие.
У каждой заявки полезно иметь собственный номер. Он связывает сообщение в боте, запись о передаче и карточку CRM. По этому номеру сотрудник сможет найти обращение, даже если на одном из этапов возникла ошибка.
Разделите два случая: повтор доставки одного события и новое обращение того же клиента. Первый случай обычно должен продолжать прежнюю обработку. Второй может создавать новую заявку или дополнять открытую - правило выбирает бизнес.
Совпадение телефона само по себе не объясняет, какая ситуация произошла. Один клиент может заказать две разные услуги. В Bitrix24 есть поиск совпадений по телефону и email, но его наличие не задаёт правила повторных заказов и не защищает автоматически от повторного создания карточки.
Какие состояния заявки нужно видеть
Полезно разделить внутренние технические статусы и сообщения клиенту. Пользователю достаточно понятного результата; поддержке нужна возможность установить, на каком этапе остановилась обработка.
| Состояние | Что подтверждено | Что можно сообщить клиенту |
|---|---|---|
| Черновик | Пользователь ещё не подтвердил обращение | «Проверьте данные перед отправкой» |
| Принята системой | Обращение надёжно сохранено | «Получили обращение» |
| Ожидает передачи | Данные сохранены, CRM ещё не подтвердила результат | «Обращение ожидает передачи» |
| Создана в CRM | Получено и проверено подтверждение CRM | «Заявка зарегистрирована» |
| Назначена ответственному | В карточке указан нужный сотрудник или очередь отдела | Сообщить о передаче в отдел, если это соответствует процессу |
| Взята в работу | Зафиксировано согласованное действие менеджера | «Менеджер принял обращение» |
| Требует разбора | Автоматическая обработка не завершилась | Объяснить дальнейший шаг по согласованному сценарию |
Формулировки в таблице - пример для проектирования. Необязательно показывать клиенту все состояния. Однако ответ «менеджер уже занимается заявкой» допустим только при наличии соответствующего подтверждения.
Что делать при недоступности CRM
Между приёмом сообщения и созданием карточки может пройти время. Чтобы пережить сбой CRM или перезапуск обработчика, принятую заявку следует сохранять в устойчивом хранилище, а задания на передачу - в очереди.
Очередь представляет собой сохранённый список заданий. После восстановления связи обработчик возвращается к ожидающим обращениям. Для заказчика важен проверяемый результат: заявки переживают перезапуск, видны поддержке и сохраняют историю попыток.
Повторы возможны и со стороны мессенджера. Например, в документации программного интерфейса обмена данными Telegram для ботов (Bot API) описано, что Telegram повторяет неуспешные запросы к обработчику бота, а затем прекращает попытки. Это не бесконечное резервное хранилище, на которое можно возложить всю ответственность за заявки.
При этом повторять любой запрос вслепую опасно. CRM могла создать карточку, а её ответ потеряться по дороге. До повторной отправки система должна проверить, не создана ли карточка по номеру обращения, переданному в CRM вместе с данными. Если две попытки идут одновременно, обе могут успеть проверить номер до появления карточки. Согласуйте обработку одного номера по очереди или ограничение уникальности на стороне принимающей системы. Если результат нельзя надёжно установить, направьте заявку на сверку сотруднику. Обработку, при которой повтор одного запроса не создаёт вторую карточку и не повторяет уже выполненное действие, называют идемпотентной.
Сетевой сбой, отсутствие прав и неверное обязательное поле требуют разных действий. Для временной ошибки задают ограниченные повторы с паузой. Ошибку доступа или данных передают на исправление; бесконечные попытки здесь лишь накапливают очередь. После установленного предела проблема должна стать видна ответственному.
Пример связи с внутренней системой
В описании проекта ТК «ЛУЧ» команда VolosnikovPro рассказывает о Telegram-боте с Mini App (веб-интерфейсом внутри Telegram) для оформления заявок на транспортные услуги. Данные передавались через программный интерфейс обмена во внутреннюю информационную систему заказчика.
Команда указывает согласование требований и протоколов обмена с ИТ-специалистами заказчика, совместное тестирование и передачу документации. Для нового проекта полезен этот порядок: договориться о данных и результате, затем проверить обмен вместе с владельцем принимающей системы.
Пример приведён по описанию команды. Тип внутренней системы в нём не назван, поэтому считать его подтверждённым внедрением конкретной CRM нельзя. Наличие у клиента иной информационной системы также требует отдельного обследования интеграции.
Как принять интеграцию перед запуском
Попросите подрядчика пройти согласованные сценарии вместе с представителем отдела продаж. Для каждого зафиксируйте входные данные, результат в CRM и запись о передаче. Слова «интеграция работает» без такой проверки слишком широко описывают результат.
| Сценарий проверки | Что должно быть видно |
|---|---|
| Обычная заявка | Правильные поля, воронка и ответственный; номер обращения связан с карточкой |
| Повтор одного события | Сохранена одна заявка, повтор отмечен и не создал лишнюю карточку |
| Новая заявка прежнего клиента | Выполнено отдельное согласованное правило повторного обращения |
| Временная недоступность CRM | Заявка остаётся в очереди, после восстановления проверяется и обрабатывается |
| Потерян ответ после создания карточки | Карточка найдена по переданному номеру обращения либо назначен согласованный разбор; слепого повторного создания нет |
| Нет прав или обязательного поля | Сохранены ошибка и заявка, ответственный получил сигнал |
| Перезапуск обработчика | Ожидающие задания восстановлены, история не исчезла |
| Менеджер не принял обращение | Отдельно видна задержка работы отдела после доставки в CRM |
Это критерии для будущей приёмки, а не отчёт о выполненных испытаниях. Нагрузку, допустимую задержку и сроки реакции поддержки нужно согласовать для конкретного проекта.
Кто следит за заявками после запуска
Назначьте владельца очереди ошибок и сотрудника, который контролирует необработанные карточки. Это могут быть разные роли: техническая поддержка восстанавливает передачу, руководитель отдела разбирает задержку работы с клиентом.
Согласуйте резервное оповещение: кому и куда приходит сообщение, если передача остановилась или заявка слишком долго ждёт. Оно должно содержать номер проблемы и способ найти подробности. Для такого сигнала обычно достаточно служебной информации без полного текста обращения и лишних контактов клиента.
В задаче на поддержку закрепите доступы, порядок обновления интеграции после изменений CRM и способ ручного повтора.
Для оценки интеграции закажите обратный звонок VolosnikovPro. Подготовьте к разговору название CRM, обязательные поля и пример заявки, по которой сегодня трудно понять, дошла ли она до менеджера.
Источники
- Telegram Bot API: доставка событий и повторы.
- Bitrix24: создание элемента CRM и проверки данных.
- Bitrix24: поиск совпадений по телефону и email.
- Пример ТК «ЛУЧ» - описание проекта, предоставленное командой VolosnikovPro.
Документация проверена 19 ноября 2026 года. Состояния заявки, схема контроля и таблица приёмки - рекомендации для постановки задачи; детали зависят от выбранной CRM и настроек бизнеса.