Как передавать 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 нестабилен и не должен быть единственным ключом.
Не запрашивайте телефон, если сценарий можно завершить без него. Контакт передаётся только после понятного действия пользователя.
Надёжный поток
- Telegram отправляет update на защищённый webhook.
- Backend проверяет источник и сохраняет raw event безопасным образом.
- Нормализатор создаёт бизнес-событие с idempotency key.
- Worker создаёт или обновляет объекты CRM.
- Ошибка повторяется по политике retry и уходит в alert.
Дедупликация
- Повтор одного update не создаёт вторую заявку.
- Контакт ищется по разрешённым стабильным идентификаторам.
- Новый интерес может создать новую сделку у старого контакта.
- Общий телефон не объединяет людей автоматически.
- Ручное слияние журналируется и допускает отмену.
Источник и атрибуция
Start parameter кодирует короткий идентификатор кампании, а полная расшифровка хранится на сервере. Если пользователь переслал ссылку, параметр показывает вход, но не доказывает личный рекламный показ. Первый и последний известный источник сохраняют отдельно.
После перехода в ручной диалог менеджер не должен стирать системный источник.
Privacy и безопасность
- Токен бота хранится только на сервере.
- Webhook использует секрет и ограниченный endpoint.
- Логи маскируют контакты и не содержат токены.
- CRM-роли ограничивают экспорт и просмотр диалогов.
- Срок хранения и удаление описаны в политике.
Приёмка
Проверьте новый лид, повторный update, старый контакт с новым интересом, отсутствие телефона, неверный payload, истёкший токен CRM и восстановление после простоя. Сверьте Telegram, очередь и CRM по event ID. Taska может быть одним из получателей; связь TIPA с Taska раскрывается.
Отдельно протестируйте блокировку бота пользователем, удалённое сообщение, пересланную deep link и смену username. Эти события не должны ломать профиль контакта или заставлять систему бесконечно повторять недоставляемое уведомление.
Мониторинг показывает задержку очереди, долю ошибок и возраст старейшего события. Уведомление получает человек, который может восстановить доставку.
После исправления очередь обрабатывается с ограниченной скоростью, чтобы не перегрузить CRM и не создать повторные задачи.
Первичные источники и документация
Следующий шаг
Если хотите применить схему к своему проекту, спроектируйте надёжную передачу заявок. Сначала зафиксируем исходные данные и критерии готовности, затем оценим объём работ.
Посчитайте стоимость под вашу задачу
Ориентир. Точная смета — после аудита процессов.
Бесплатная диагностика за 24–48 часов: посмотрим ситуацию, скажем что даст результат, дадим смету.
