К содержимому
Обсудить проект

CRM · 25 июля 2026 г.

Как передавать Telegram-заявки в CRM

Архитектура bot → backend → CRM: start parameter, UTM, поля, webhook, дедупликация, очередь, privacy и приёмочные тесты.

Главное за 30 секунд

Telegram-заявка должна попасть в CRM с источником, контекстом и уникальным идентификатором, даже если внешняя система временно недоступна. Бот не хранит бизнес-логику только в памяти процесса: backend валидирует событие, сохраняет его и повторяет доставку.

Источники входа

  • Deep link с start parameter рекламной кампании.
  • Кнопка сайта с UTM и landing page.
  • Сообщение боту или форма Mini App.
  • Ручной диалог с корпоративным аккаунтом.
  • Повторное обращение существующего контакта.

Минимальные поля

Храните Telegram user/chat ID там, где это допустимо, язык, время, start parameter, UTM, сценарий бота, контакт, текст согласия и технический event ID. Username нестабилен и не должен быть единственным ключом.

Не запрашивайте телефон, если сценарий можно завершить без него. Контакт передаётся только после понятного действия пользователя.

Надёжный поток

  1. Telegram отправляет update на защищённый webhook.
  2. Backend проверяет источник и сохраняет raw event безопасным образом.
  3. Нормализатор создаёт бизнес-событие с idempotency key.
  4. Worker создаёт или обновляет объекты CRM.
  5. Ошибка повторяется по политике retry и уходит в alert.

Дедупликация

  • Повтор одного update не создаёт вторую заявку.
  • Контакт ищется по разрешённым стабильным идентификаторам.
  • Новый интерес может создать новую сделку у старого контакта.
  • Общий телефон не объединяет людей автоматически.
  • Ручное слияние журналируется и допускает отмену.

Источник и атрибуция

Start parameter кодирует короткий идентификатор кампании, а полная расшифровка хранится на сервере. Если пользователь переслал ссылку, параметр показывает вход, но не доказывает личный рекламный показ. Первый и последний известный источник сохраняют отдельно.

После перехода в ручной диалог менеджер не должен стирать системный источник.

Privacy и безопасность

  • Токен бота хранится только на сервере.
  • Webhook использует секрет и ограниченный endpoint.
  • Логи маскируют контакты и не содержат токены.
  • CRM-роли ограничивают экспорт и просмотр диалогов.
  • Срок хранения и удаление описаны в политике.

Приёмка

Проверьте новый лид, повторный update, старый контакт с новым интересом, отсутствие телефона, неверный payload, истёкший токен CRM и восстановление после простоя. Сверьте Telegram, очередь и CRM по event ID. Taska может быть одним из получателей; связь TIPA с Taska раскрывается.

Отдельно протестируйте блокировку бота пользователем, удалённое сообщение, пересланную deep link и смену username. Эти события не должны ломать профиль контакта или заставлять систему бесконечно повторять недоставляемое уведомление.

Мониторинг показывает задержку очереди, долю ошибок и возраст старейшего события. Уведомление получает человек, который может восстановить доставку.

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

Первичные источники и документация

Следующий шаг

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

По теме

Если решаете связанную задачу, продолжите с конкретным сценарием:

  • Сколько стоит Telegram-бот в России: как считать бюджет

● Бесплатная диагностика

Давайте поговорим.

Ответим за 15 минут в рабочее время. Разбор сайта, рекламы или CRM и предложение сделаем бесплатно.

Удобнее написать? Telegram @tipa_agency или tipaagentstvo@gmail.com

Расскажите о задаче