Как выглядит схема от сообщения до сделки в CRM?
Держите бота и CRM слабо связанными. Бот — входная дверь: он говорит с человеком и выдаёт чистую запись. CRM — рабочее место менеджера. Между ними стоит небольшой сервис со своей базой. В этом сервисе вся суть схемы.
Путь заявки состоит из семи шагов, и на каждом заявки обычно теряются:
- Человек пишет боту или приходит по рекламной ссылке. Бот читает стартовый параметр и запоминает источник.
- Бот задаёт несколько вопросов и проверяет ответы (следующий раздел). Состояние диалога хранится в базе, а не в памяти: подробности в статье про состояние диалога бота.
- Сервис записывает заявку в свою таблицу с уникальным ключом и статусом «новая». Только после этого бот отвечает человеку «заявка принята».
- Фоновый воркер берёт заявку из таблицы, ищет в CRM существующий контакт и решает: привязать к нему или создать нового.
- Воркер создаёт лид или сделку, назначает ответственного, пишет источник и краткое содержание диалога.
- Сервис сохраняет id сущности из CRM и ставит статус «доставлена». Если CRM отказала или недоступна, статус остаётся, и отправка повторяется позже.
- Менеджер получает уведомление со ссылкой на карточку.
Какие поля должен собирать телеграм бот для заявок?
Чем меньше вопросов, тем больше завершённых диалогов. Спрашивайте только то, что менеджеру нужно для первого звонка или сообщения. Остальное берите из самого Telegram и из контекста.
Из Telegram приходят id пользователя, имя и, если он задан, username. Id — стабильный идентификатор, username может смениться или отсутствовать. Номер телефона автоматически не приходит. Бот может показать кнопку, которая просит человека поделиться своим контактом, и тогда Bot API присылает объект контакта с номером и именем. Человек подтверждает отправку сам, что заодно помогает с согласием. Дайте запасной вариант с ручным вводом и проверяйте формат номера.
Задачу просите описать своими словами, одним свободным вопросом. Для менеджера это самое полезное поле, и кнопками его не заменить.
- Обязательно: как обращаться, способ связи (Telegram id всегда, телефон, если менеджер звонит) и задача в одном-двух предложениях.
- Часто полезно: продукт или услуга кнопкой, город или часовой пояс, если это влияет на звонок, удобное время связи.
- Собирается молча: Telegram id, username, стартовый параметр (кампания или страница), дата и время, язык.
- Не спрашивайте то, что менеджер всё равно уточнит по телефону, и чувствительные данные, которые для задачи не нужны. Каждое лишнее поле снижает долю дошедших до конца и увеличивает ваши обязанности по защите данных.
- Для рекламы кладите источник в предназначенные для этого поля CRM. По документации у лида в Битрикс24 есть UTM-поля (UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN и другие); в amoCRM заведите для источника своё поле.
Как не создавать дубли контактов в CRM?
Дубли возникают в двух случаях: один и тот же человек пишет боту дважды, и бот создаёт нового контакта для человека, которого CRM уже знает по звонку или форме на сайте. Оба случая лечатся, но CRM не всегда сделает это за вас.
В Битрикс24 REST-метод crm.duplicate.findbycomm принимает тип (PHONE или EMAIL) и список значений, до 20, и возвращает id лидов, контактов и компаний с такими же данными. При сравнении телефонов добавочный номер не учитывается. Воркеру этого достаточно: ищем по телефону, и если контакт найден, привязываем к нему новый лид или сделку, а не создаём ещё один.
В amoCRM метод комплексного создания (POST /api/v4/leads/complex) создаёт сделку вместе с контактом и компанией, до 50 сделок за запрос. По документации, контроль дублей может проверять добавляемые данные, если он включён для интеграции, а в ответе есть флаг merged. Считайте это страховкой, а не планом: проверьте в своём аккаунте, по чему именно срабатывает контроль дублей, и испытайте на реальных форматах номеров.
Нормализуйте данные до поиска. Храните телефон в одном формате (цифры с кодом страны), сравнивайте в нём же, а исходный текст, который ввёл человек, сохраняйте отдельно. Иначе «+7 999...» и «8 999...» окажутся двумя людьми.
- Одна заявка на пользователя Telegram и открытое обращение: если человек пишет снова, пока заявка открыта, добавляйте комментарий к ней.
- Ищите в CRM по нормализованному телефону, затем по email, если он есть. Никогда не сопоставляйте только по имени.
- Если совпало несколько контактов, не угадывайте. Привяжите к последнему активному и пометьте заявку, чтобы менеджер объединил контакты.
- Если телефона нет и есть только Telegram id, нужен стабильный ключ: сохраните id в отдельном поле и в следующий раз ищите по нему.
Как назначить ответственного менеджера?
Заявка без владельца — заявка, на которую никто не отвечает. Решите правило до кода и сделайте его таким, чтобы объяснить одной фразой.
В Битрикс24 у лида есть поле ASSIGNED_BY_ID, то есть ответственный. В amoCRM у сущности тоже есть id ответственного. В обоих случаях это просто числа, поэтому правило живёт в вашем сервисе, а в CRM уходит результат.
- Фиксированный ответственный: всё идёт одному человеку. Подходит маленькой команде и первому запуску.
- По кругу: берём следующего менеджера из списка, пропуская отсутствующих. Указатель храните в базе, а не в памяти.
- По признаку: продукт, город или язык определяют группу или человека.
- Существующий клиент: если у контакта уже есть ответственный, оставьте его. Объяснять всё заново второму менеджеру клиенты не любят.
- Запасной вариант: если выбранный менеджер неактивен или удалён в CRM, назначьте ответственного по умолчанию и пометьте заявку. Сбой назначения не должен блокировать доставку.
Как уведомить менеджера о новой заявке?
У CRM есть свои уведомления, и менеджеру, который живёт в CRM, их может хватить. Но многие продавцы весь день сидят в Telegram, и короткое сообщение там сокращает время первого ответа.
Отправляйте уведомление из вашего сервиса после того, как CRM подтвердила создание, а не до. Тогда в нём есть ссылка на карточку, и никто не ищет заявку, которой ещё нет. Текст короткий: имя, задача, телефон или username, источник, ссылка. Если хотите видеть, кто отреагировал, добавьте кнопку «Беру» и записывайте нажатие в CRM заметкой или сменой статуса.
Не отправляйте весь диалог в общий чат: персональные данные в канале с множеством участников трудно контролировать. Подробности держите в карточке, в сообщении оставьте суть.
Если менеджер не отреагировал за заданное время, шлите напоминание или передайте заявку другому. Это правило вашего сервиса, и именно его готовые коннекторы чаще всего не умеют.
Что делать, если CRM недоступна: повторная отправка, очередь и идемпотентность
CRM иногда отвечает ошибкой, не успевает ответить или ограничивает вас. Например, amoCRM в документации указывает не более 7 запросов в секунду на интеграцию и 50 на аккаунт, при превышении возвращает HTTP 429, а при повторных нарушениях может заблокировать доступ ответом 403. Бот, который шлёт запрос прямо из диалога и показывает «извините, ошибка», потеряет заявки именно тогда, когда трафика больше всего.
Лечится порядком шагов из первого раздела: сначала сохранить, потом доставить. Заявка лежит у вас в базе со статусом «новая», человеку уже ответили «принято», а воркер доставляет. Если не получилось, воркер повторяет с растущими паузами, а в конце переводит заявку в заметный статус «ошибка», о котором кому-то приходит оповещение. Часто хватает таблицы в Postgres в роли очереди; механика описана в статье про фоновые задачи и очереди на Go.
Повторы создают обратную опасность: CRM создала сделку, но ответ потерялся, и повтор создаёт вторую. Это классический случай идемпотентности, подробно разобранный в статье про идемпотентность и повторы API. Для нашей схемы практические правила короткие:
- У каждой заявки с первого сохранения есть ваш уникальный id. Id сущности из CRM записывайте сразу, как только она его вернула.
- Перед повтором запроса с неизвестным исходом сначала ищите сущность: по вашему id, если в CRM есть под него поле, иначе по телефону и времени создания.
- Повторяйте при таймаутах, 429 и 5xx с растущими паузами. Ошибки валидации не повторяйте: они повторятся снова, пометьте заявку и сообщите человеку.
- Не затягивайте ответ на вебхук Telegram. Если обработчик вернёт не 2xx, Telegram повторит запрос ограниченное число раз, поэтому обработчик бота тоже должен быть идемпотентным: помните id обработанных обновлений. О выборе режима читайте в статье вебхук или long polling.
- Настройте оповещение о растущей очереди и о заявках, которые дольше порога лежат в «новая» или «ошибка». Опаснее всего тишина.
Согласие на обработку персональных данных: что сделать в боте
Бот для заявок собирает имя, телефон и текст обращения, то есть персональные данные. Нужно ли согласие и в какой форме, зависит от вашей страны и основания обработки, поэтому формулировки согласуйте с юристом. Инженерная часть одинакова: спросить явно, записать и суметь подтвердить.
Покажите текст согласия и ссылку на политику до того, как бот попросит контакты, и сделайте согласие осознанным действием, например кнопкой. Сохраняйте факт согласия с датой, версией политики и Telegram id рядом с заявкой. Не ставьте галочки заранее и не прячьте согласие в длинное первое сообщение.
Предусмотрите удаление и выгрузку данных человека по запросу, включая копию в CRM и в вашей базе. Если храните логи диалогов, решите, как долго и кто может их читать. Не пишите персональные данные в общие логи приложения, где они останутся навсегда.
Когда достаточно формы или интеграции без кода
Не каждому бизнесу нужен свой сервис. Бота с тремя вопросами и созданием сделки можно собрать из готовых частей, и для первой проверки гипотезы это часто верное решение.
Готовые коннекторы и no-code подходят, когда объём небольшой, правило «все заявки одному человеку» и потеря редкой заявки стоит недорого. И у amoCRM, и у Битрикс24 есть собственные способы принимать диалоги из мессенджеров и формы с сайта, которых для вашего случая может хватить без отдельного бота. Где проходит граница, смотрите в статье n8n или свой код.
Свой сервис окупается, когда нужно правило, которое инструмент не выразит (круговое распределение с учётом отсутствующих, привязка к текущему ответственному), надёжная доставка с видимым состоянием сбоя, несколько CRM или источников, либо контроль над тем, куда уходят персональные данные. Если вы ещё выбираете систему, прочитайте свою CRM или готовую, а этапы и статусы продумайте заранее: как проектировать воронку продаж. Общий взгляд на обмен данными между системами — в статье про интеграцию CRM и ERP.
- Достаточно формы или no-code коннектора: малый объём, один ответственный, нет своих правил, потеря заявки обходится недорого.
- Стоит писать сервис: несколько менеджеров с правилами, повторные клиенты, нужна видимость сбоев, рекламный трафик, где каждая заявка имеет цену.
- Подумайте, нужен ли бот вообще: если люди в основном приходят с сайта, хорошая форма с той же доставкой в CRM может конвертировать не хуже, а вести её проще.