Чат-бот Геткурс: архитектура связки с Telegram, лимиты рассылок и маршрутизация
Чат-бот Геткурс — это канал связи, который превращает аккаунт пользователя в платформе в активный диалог внутри мессенджера. Технически это работает через систему вебхуков: учебная платформа формирует текст и отправляет запрос, а серверы Telegram доставляют его на устройство клиента. Основная задача при внедрении — правильно связать профиль ученика с его идентификатором в мессенджере, чтобы транзакционные уведомления уходили адресно, а ответы не терялись во входящих.
Архитектура: как платформа связывает профили
Технически интеграция Телеграм Геткурс строится на строгом правиле площадки: бизнес не может написать пользователю первым, зная только его номер телефона. Чтобы канал открылся, человек обязан инициировать диалог сам, нажав кнопку /start в интерфейсе мессенджера. До этого момента любые попытки отправить сообщение через процессы завершатся ошибкой.
Для корректной привязки используется диплинк (deeplink) — уникальная ссылка с зашитым payload-кодом. Когда ученик переходит по ней из письма или с закрытой страницы тренинга, система сопоставляет его Telegram-ID с существующей карточкой пользователя. Если дать прямую ссылку на бота без кода привязки, мессенджер создаст новый пустой профиль. Управлять такими дублями придется вручную, сливая карточки через GetCourse API: негласные лимиты, экспорт данных и логика вебхуков.
При смене аккаунта в мессенджере старая связка перестает работать. В карточке клиента визуально остается подключенный канал, но отправка сообщений на него замораживается. Отследить такие отвалы можно только по статусу ошибки в истории отправки конкретного сообщения.
Запуск массовых сообщений и лимиты мессенджера
Массовая рассылка телеграм getcourse запускается через блок процессов «Отправить сообщение» или встроенный инструмент рассылок. Главное узкое место здесь диктует не учебная платформа, а сам мессенджер. Telegram API пропускает около 30 сообщений в секунду для одного токена. Если отправить уведомление о старте вебинара сразу на базу в пятьдесят тысяч человек, образуется очередь фоновых задач. Последние пользователи в списке получат ссылку, когда эфир уже закончится.
Чтобы избежать задержек, базу дробят. Процесс настраивают с шагом задержки между блоками или используют Геткурс сегменты: логика сборки, условия для рассылок и чистка базы, чтобы отправлять транзакционные уведомления раньше маркетинговых. Разделение по часовым поясам и активности в последних заказах снижает нагрузку на API.
Мы не обходим ограничения площадок и не занимаемся накруткой: алгоритмы мессенджера безвозвратно блокируют токен бота за агрессивный спам. Восстановить заблокированного бота нельзя, придется регистрировать нового в BotFather и заново просить всю базу нажать /start.
Маршрутизация ответов и подключение автоматизации
Когда telegram bot getcourse получает ответную реплику клиента, она падает во внутренний раздел диалогов. При запусках или активных рассылках входящий поток парализует отдел продаж: менеджеры тонут в однотипных вопросах про доступ к урокам, рассрочку и ссылки на оплату. Базовая маршрутизация позволяет раскидать диалоги по папкам в зависимости от тегов пользователя, но печатать ответы всё равно приходится руками.
Чтобы снять типовые ответы с первой линии, к каналу подключают платформенного ассистента. ИИ-агент работает поверх системы: квалифицирует лиды, отрабатывает возражения по заложенной базе знаний и отправляет ссылки на оплату. Внутри учебной платформы он умеет самостоятельно создавать заказы и добавлять пользователей в группы.
Агент ведет диалог 24/7, удерживая контекст переписки годичной давности, и зовет живого человека только при жалобе или прямой просьбе позвать менеджера. Благодаря настройке окон тишины и стоп-слов, алгоритм умеет молчать там, где отвечать не надо, и не встревает в диалог, который уже перехватил живой сотрудник.
Чек-лист: что проверить перед массовой отправкой
- Создайте тестового пользователя со своим адресом почты и привяжите к нему личный аккаунт мессенджера через диплинк из кабинета.
- Соберите черновик рассылки и в условиях сегмента жестко укажите только созданный тестовый профиль.
- Отправьте сообщение и замерьте время доставки: задержка больше десяти секунд говорит о зависшей очереди фоновых задач на проекте.
- Напишите ответную реплику в мессенджере со смартфона и проверьте, появился ли диалог во входящих платформы.
- Отправьте в бота файл (PDF или фотографию), чтобы убедиться, что права доступа позволяют платформе скачивать вложения.
- Проверьте текст на наличие прямых ссылок на сторонние платежные системы: мессенджер может помечать их как подозрительные.
Что чаще всего идёт не так
| Симптом | Причина | Что делать |
|---|---|---|
| Ответы от ИИ-агента или интеграции не доставляются в Telegram | У учетной записи нет нужных прав | Выдать роль admin пользователю, через которого работает интеграция (без неё платформа блокирует запись в диалоги) |
| Сообщения висят непрочитанными в платформе, хотя клиент их прочитал | Техническое ограничение архитектуры | Ориентироваться на наличие ответной реплики; пометить сообщение прочитанным через API нельзя |
| Бот отвечает невпопад или перебивает менеджера в диалоге | Не настроены стоп-слова и окна тишины | Задать паузу после реплики живого сотрудника в настройках агента |
| Создаются дубли карточек пользователей | Клиенты переходят в бота по прямой ссылке без payload-кода | Заменить прямые ссылки на системные макросы привязки в письмах |
Что НЕ помогает: пересоздание токена в BotFather при задержках отправки. Смена токена не ускоряет очередь фоновых задач на сервере платформы, а только сбрасывает текущие сессии пользователей.
С чего начать настройку связки
Сначала соберите схему точек касания. Выпишите все этапы, где пользователь должен получать уведомления в мессенджер: успешная оплата, открытие модуля, напоминание о вебинаре за час и за пятнадцать минут. Под каждый этап создайте свой шаблон текста. Затем проверьте права доступа: для корректной работы внешних интеграций учетная запись обязана иметь роль admin, иначе ответы в диалоги просто не пройдут.
Настройте базовые Сообщения в Геткурсе: маршрутизация, логика фильтров и шаблоны ответов, чтобы отделить технические запросы от вопросов по продукту. Разделите потоки так, чтобы кураторы видели только домашки, а продажники — только вопросы по тарифам.
Когда структура каналов готова и протестирована на фокус-группе, к ней подключают ИИ-менеджера. Он заберет на себя до 100% диалогов по типовым сценариям, проверит домашние задания через модуль ИИ-куратора и освободит команду для работы со сложными сделками.
Частые вопросы
Можно ли написать клиенту в Telegram первым по номеру телефона?
Нет. Пользователь должен сам запустить бота командой /start. До этого момента API мессенджера не пропустит ни одно сообщение от платформы.
Как пометить сообщение прочитанным через API?
Никак. Это техническое ограничение архитектуры платформы: API не поддерживает передачу статуса прочтения для входящих сообщений.
Умеет ли ИИ-агент проверять домашние задания из Telegram?
Да, специализированный ИИ-куратор распознает вложения любых форматов (текст, фото, видео, аудио, PDF), дает развернутую обратную связь и принимает работу.
Почему при рассылке образуются дубли профилей?
Дубли возникают, когда клиент переходит в бота по прямой ссылке (@botname), а не по индивидуальному диплинку из платформы. Система не может опознать его и создает новую карточку.