Syntra Systems
Кейсы Услуги Продукты О нас Блог IT Caravan
+998 70 010 68 44 +7 999 900 22 12
RusEngUzb
Рука в синем свете держит чёрный рифлёный цилиндр на бирюзовом фоне — метафора связки Telegram-бота с системами компании
Боты и Telegram

Интеграция Telegram-бота с CRM: как это устроено

Автор: Никита Жулин · · 8 мин чтения

Telegram-бота подключают к CRM через две точки: события от Telegram бот получает вебхуком или опросом, а в CRM отправляет данные через её API. Между ними стоит ваш сервис — он переводит нажатия кнопок в поля карточки клиента и сделки. Главное ограничение задаёт сама платформа: бот не может написать человеку первым, поэтому уведомления получат только те, кто уже запустил бота.

Коротко

  • Бот получает события от Telegram двумя способами: вебхуком на HTTPS-адрес или опросом. Непрочитанные события хранятся не дольше 24 часов.
  • Обмен идёт в обе стороны: в CRM уходят контакт, ответы на вопросы и метка источника, обратно приходят номер сделки, этап и статус заказа.
  • Источник перехода передают параметром start в ссылке на бота: до 64 символов, латиница, цифры, подчёркивание и дефис.
  • Бот не может написать человеку первым, поэтому база для уведомлений собирается только из тех, кто сам запустил бота.
  • Бот для приёма заявок и записи с заведением их в CRM — от 1 200 $; разбор процессов и план автоматизации — 400 $.

Как бот получает события: вебхук или опрос

Telegram отдаёт события боту двумя взаимоисключающими способами: либо бот сам спрашивает, что нового, либо Telegram присылает события на указанный адрес. Выбор влияет на то, какая инфраструктура вам нужна.

У вебхука есть параметр количества одновременных подключений к вашему серверу: допустимы значения от 1 до 100, по умолчанию Telegram использует 40. Он и задаёт потолок нагрузки, которую бот выдержит в пиковый час.

Непрочитанные события Telegram хранит, пока бот их не заберёт, но не дольше 24 часов. Если сервер бота был недоступен сутки, обращения за это время пропадут безвозвратно — поэтому боту нужен мониторинг доступности, а не надежда на то, что он работает.

Что бот отправляет в CRM и что получает обратно

Бот работает как ещё один канал продаж, поэтому обмен идёт в обе стороны: данные клиента уходят в системы компании, а статусы и справочные сведения возвращаются в чат.

Самих данных о человеке Telegram отдаёт немного: идентификатор чата, имя, при наличии — username и язык интерфейса. Номера телефона среди них нет — он приходит отдельным контактом, когда человек сам отправляет его боту кнопкой в приватном чате. Поэтому запрос контакта ставят в сценарий осознанно, после того как человек понял, зачем ему бот, а не на первом экране.

СистемаЧто бот отправляет тудаЧто получает обратно
CRMКонтакт, текст обращения, ответы на вопросы, метку источникаНомер сделки, этап воронки, ответственного менеджера
1С или учётная системаЗаказ и реквизиты покупателяЦену, остаток, статус оплаты и отгрузки
ERP или складЗаявку, принятую в работуСтатус выполнения, срок, номер документа
Платёжный сервисСумму и описание заказаСсылку на оплату и подтверждение платежа
ТелефонияЗапрос обратного звонка с номеромИтог разговора и запись в карточке клиента
База знаний и ИИ-ассистентВопрос клиентаОтвет по документам компании и признак передачи человеку

Технически это те же API, вебхуки и коннекторы, что и в любой другой интеграции: бот здесь — обычный клиент чужого интерфейса. Как разводить направления обмена и кому принадлежит каждый справочник, разбираем в статье про интеграцию CRM с корпоративными системами.

Как заявка из бота превращается в сделку

Путь от нажатия кнопки до задачи менеджеру состоит из шести шагов, и каждый из них нужно описать до разработки — иначе в CRM приедет свободный текст, с которым нечего делать.

  1. Переход по ссылке. Человек открывает бота по ссылке с меткой источника и нажимает кнопку запуска.
  2. Сценарий вопросов. Бот задаёт вопросы по шагам и складывает ответы в отдельные поля: город, услуга, бюджет, удобное время.
  3. Поиск клиента. Сервис бота ищет человека в CRM по номеру телефона: нашёл — дополняет карточку, не нашёл — создаёт новую.
  4. Создание сделки. Сделка появляется на нужном этапе воронки с меткой источника и ответами на вопросы квалификации.
  5. Задача менеджеру. CRM назначает ответственного, ставит задачу со сроком и отправляет уведомление в рабочий чат.
  6. Обратная связь клиенту. Смена статуса в CRM возвращается сообщением в чат — при условии, что человек запускал бота и не заблокировал его.

Так же была устроена регистрация на выставке в кейсе UzFranchise Expo: бот регистрировал гостя, задавал вопросы о целях визита и выдавал электронный билет, а CRM собирала сегменты и рассылки по ответам.

Отдельная деталь того же проекта: компании-участники сканировали QR гостя своим телефоном, и контакт сразу попадал в их базу. Бот в такой схеме не только собирает заявки, но и раздаёт данные другим участникам процесса.

Как узнать, откуда пришёл клиент в бота

Источник передают прямо в ссылке на бота: к адресу вида t.me/имя_бота добавляют параметр start с меткой, и Telegram отдаёт эту метку боту в первом же событии. Дальше метка кладётся в поле сделки и живёт в CRM вместе с клиентом.

Ограничения у параметра простые: длина до 64 символов, допустимы латинские буквы, цифры, подчёркивание и дефис. Для сложных значений документация советует кодировать параметр в base64url, а не изобретать свой формат.

Поэтому метки делают короткими и читаемыми: ig_sept, qr_stand12, site_pricing. В отчёте по сделкам потом видно, какая ссылка привела платящих клиентов, а какая — только подписчиков. Как та же задача решается для мобильных приложений и рекламных кампаний, разбираем в статье про аналитику приложений и deep link tracking.

Одной метки мало, когда ссылок много. Заведите справочник меток и правило именования — канал, кампания, место размещения, — иначе через полгода в отчёте окажется два десятка значений, про половину из которых никто не вспомнит, откуда они взялись.

Чего Telegram-бот не умеет

Часть привычных задач боту недоступна по правилам платформы. Об этом честнее договориться до разработки, чем обнаружить на запуске рассылки.

Важно Бот не может начать разговор первым — в документации Bot API это сформулировано прямо: пользователь должен сам написать боту или добавить его в группу. Значит, база для уведомлений собирается только из тех, кто нажал кнопку запуска, а купленные списки номеров в Telegram бесполезны.

Обойти эти правила нельзя, зато можно построить сценарий вокруг них: собирать запуск бота на первом касании, дублировать критичные уведомления вторым каналом и не рассчитывать на бота в работе с холодной базой. Зачем бизнесу бот и какие задачи он закрывает помимо заявок, разбираем в статье про Telegram-боты для бизнеса.

Как проходит подключение

Подключение идёт в шесть шагов, и первые два делаются на бумаге: пока не описаны поля и события, настраивать нечего.

  1. Сценарий. Описываем, какие вопросы бот задаёт и какие поля получаются из ответов. Свободный текст в CRM не нужен никому.
  2. Схема обмена. Решаем, что бот отправляет в CRM, что забирает обратно и по какому событию: новая заявка, оплата, смена статуса.
  3. Учётная запись интеграции. Заводим в CRM отдельного пользователя для бота с минимальными правами и собственным ключом доступа.
  4. Разработка и вебхук. Поднимаем сервис бота, ставим вебхук на HTTPS-адрес, настраиваем повторные попытки и очередь на случай, когда CRM недоступна.
  5. Проверка сценариев. Прогоняем путь клиента целиком и отдельно — дубли контактов, отказ оплаты, блокировку бота и недоступность CRM.
  6. Запуск и наблюдение. Читаем первые диалоги, правим формулировки и следим за журналом ошибок обмена.

Отдельно стоит договориться, кто смотрит за ботом после запуска. Бот без присмотра ломается тихо: Telegram перестаёт достукиваться до вебхука, заявки копятся, и о проблеме узнают по звонку клиента.

Сколько стоит подключение бота к CRM

Цена зависит от того, разрабатываете вы бота с нуля или связываете с CRM уже работающего. На странице услуги это три разных формата.

Выше стартовой цены бюджет поднимают три вещи: число подключаемых систем, закрытые или самописные программы без API и длина сценария — каждый дополнительный шаг диалога нужно продумать, написать и проверить. Состав работ по каждому формату описан на странице ботов и ИИ-ассистентов.

После запуска у бота остаются постоянные расходы: сервер, на котором он живёт, — от 30 $ в месяц, и присмотр за обменом. Поддержка рабочих систем компании, включая CRM и интеграции, стоит от 700 $ в месяц; что в неё входит, описано на странице технической поддержки.

Как мы подключаем ботов к CRM

Syntra Systems начинает со сценария и полей, а не с кода: разбираем, с какими вопросами приходят клиенты, что из этого закрывается без человека и какие данные должны оказаться в CRM. После этого фиксируем схему обмена и собираем связку — бот, сервис обмена, CRM, оплата и учётная система.

Заявки заводим в CRM с меткой источника, уведомления отправляем ответственным, статусы возвращаем клиенту в чат. Настраиваем повторные попытки и журнал ошибок, чтобы недоехавшую заявку было видно сразу, и остаёмся на связи после запуска: первые диалоги всегда показывают, какие формулировки в сценарии стоит переписать.

Обсудим вашу задачу

Расскажите, что нужно сделать, — оценим сроки и стоимость и предложим решение.

Обсудить бота и CRM

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

У нас уже работает CRM — бота можно подключить к ней?

Подойдёт любая CRM с API или приёмом вебхуков: через них бот создаёт контакт, сделку и задачу. Если открытого интерфейса нет, остаются выгрузка файлами или промежуточный сервис, и заявки доходят по расписанию, а не сразу.

Может ли бот сам написать клиенту, который оставил телефон на сайте?

Нет. Бот не начинает разговор первым: человек должен сам открыть бота и нажать кнопку запуска. Поэтому в форму на сайте добавляют ссылку на бота с меткой, а после первого запуска боту уже можно отправлять уведомления по заказу.

Как передать в CRM, из какой рекламы пришёл человек?

Для каждого объявления делают свою ссылку на бота с меткой, например t.me/имя_бота?start=ig_sept. Метка приходит боту при первом запуске и сохраняется в сделке, поэтому в отчёте видно, какая реклама привела платящих клиентов. Названия меток заведите в справочник заранее, иначе через полгода никто не вспомнит, что значит половина из них.

Что произойдёт, если CRM недоступна в момент заявки?

Заявка не должна пропасть: сервис бота складывает её в очередь и повторяет отправку, пока CRM не ответит. Без очереди и повторных попыток такие обращения теряются молча, и заметить это можно только по расхождению между числом диалогов и числом сделок.

Нужен ли боту отдельный пользователь в CRM?

Да. Интеграция должна ходить под собственной учётной записью с минимальными правами и своим ключом доступа. Если бот работает под логином сотрудника, то при его увольнении и блокировке доступа обмен остановится в тот же день.

Бот может сразу создать сделку и прислать ссылку на оплату?

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

Что будет с заявками, если сервер бота упал на ночь?

Telegram хранит непрочитанные события, пока бот их не заберёт, но не дольше 24 часов. Ночной сбой бот переживёт, суточный — нет: обращения за это время пропадут безвозвратно, поэтому за ботом нужен мониторинг доступности.

Читайте также