Как настроить Telegram-бота для рассылок в Trigly

Зачем Telegram-канал для рассылок

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

• Open Rate 70-90% (против 15-25% у email) — сообщения видны сразу в списке чатов
• Click Rate 15-30% (против 2-5% у email) — пользователи привыкли кликать в мессенджерах
• Бесплатная доставка — в отличие от SMS (2.5 рубля за сегмент) и WhatsApp (5-8 рублей за шаблон)
• Rich-контент — Markdown, изображения, inline-кнопки, мини-приложения

Trigly подключается к Telegram через Bot API с полноценным адаптером TelegramFullAdapter: отправка текста и фото, Markdown/HTML разметка, inline-клавиатуры, управление вебхуками, rate limiting 30 сообщений/сек.

Весь процесс настройки занимает 10-15 минут.

Шаг 1: Создайте бота в BotFather

1. Откройте Telegram и найдите бота @BotFather
2. Отправьте команду /newbot
3. Введите отображаемое имя бота (например, "MyShop Уведомления")
4. Введите username бота — должен заканчиваться на bot (например, myshop_trigly_bot)
5. BotFather пришлёт токен в формате 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Сохраните токен — он понадобится на следующем шаге. Никогда не публикуйте токен и не коммитьте его в репозиторий.

Дополнительные настройки в BotFather (рекомендуется):

• /setdescription — описание бота (видно при первом открытии)
• /setabouttext — текст "О боте" в профиле
• /setuserpic — аватарка бота (логотип вашей компании)
• /setcommands — список команд (например, start - Подписаться на уведомления)

Шаг 2: Подключите бота к Trigly

1. В Trigly перейдите в раздел Каналы и выберите Telegram
2. Вставьте токен бота, полученный от BotFather
3. Нажмите "Подключить"

Trigly автоматически выполнит следующие действия:

• getMe — проверит валидность токена и получит информацию о боте (username, display name)
• setWebhook — зарегистрирует URL для получения входящих сообщений: /hooks/telegram/{org_id}
• Сохранит конфигурацию в таблице channel_configs с типом telegram_bot
• Установит статус: "Подключён"

После подключения Trigly начнёт получать все входящие сообщения от пользователей бота через вебхук.

Шаг 3: Настройте deep links для привязки клиентов

Deep links — ключевая функция, которая связывает Telegram-аккаунт пользователя с его профилем в CDP. Без этой привязки вы не сможете отправлять персонализированные сообщения.

Как работают deep links в Trigly:

1. Trigly генерирует уникальную ссылку для каждого клиента через TelegramLinkService: https://t.me/myshop_trigly_bot?start=TOKEN

2. Токен содержит закодированные данные (organization_id, customer_id, timestamp), подписанные HMAC-SHA256. Срок действия — 24 часа.

3. Когда клиент нажимает ссылку и отправляет /start в боте, Trigly:

   • Проверяет подпись токена и срок действия
   • Извлекает customer_id из токена
   • Записывает telegram_chat_id в профиль клиента в CDP
   • Подтверждает привязку сообщением в чате

Где размещать deep links:

• В email-рассылках: "Подпишитесь на наш Telegram"
• На сайте через виджет подписки
• В личном кабинете клиента
• В SMS с коротким URL
• На печатных материалах (QR-код, ведущий на deep link)

Шаг 4: Первая рассылка

После того как у вас есть клиенты с привязанным telegram_chat_id, можно запускать первую рассылку:

1. Перейдите в Кампании и нажмите "Создать кампанию"
2. Канал: Telegram
3. Выберите сегмент получателей. Trigly автоматически отфильтрует только клиентов с заполненным telegram_chat_id
4. Напишите текст сообщения. Поддерживается Markdown-разметка:
   • **жирный** или __жирный__
   • *курсив* или _курсив_
   • `код`
   • [текст ссылки](https://url.com)
5. Добавьте inline-кнопки (опционально) — до нескольких рядов, каждая кнопка с текстом и URL
6. Прикрепите изображение (опционально) — Trigly отправит его через sendPhoto
7. Запустите кампанию

Trigly отправит сообщения через TelegramFullAdapter с rate limiting не более 30 сообщений в секунду (ограничение Telegram Bot API).

Шаг 5: Inline-кнопки и интерактивность

Inline-кнопки — мощный инструмент для вовлечения. В Trigly вы можете добавить кнопки двух типов:

URL-кнопки — ведут на внешнюю ссылку:

• "Перейти в каталог" → URL магазина
• "Забрать скидку" → промо-страница
• "Оставить отзыв" → форма отзыва

Callback-кнопки — отправляют callback_query боту:

• Trigly логирует нажатие как событие в ClickHouse
• Вызывает answerCallbackQuery для подтверждения
• Можно использовать в триггерах для автоматических действий

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

Шаг 6: Триггерные цепочки

В flow builder добавьте шаг Send Telegram для отправки через бота. Комбинируйте с другими шагами для сложных сценариев:

Пример: Welcome-серия в Telegram

1. Trigger: клиент подписался через deep link
2. Send Telegram: "Добро пожаловать! Вот промокод WELCOME10"
3. Wait: 2 дня
4. Condition: совершил покупку? Да → благодарность. Нет → напоминание
5. Send Telegram: рекомендации на основе первой покупки

Пример: Омниканальный сценарий

1. Send Email: основное предложение
2. Wait: 1 день
3. Condition: открыл email? Да → стоп. Нет → Send Telegram с кратким напоминанием
4. Wait: 1 день
5. Condition: прочитал в TG? Да → стоп. Нет → Send SMS (последний шанс)

Также доступен шаг smart_send, где AI автоматически выберет оптимальный канал. Подробнее в руководстве по Smart Send.

Обработка входящих сообщений

Trigly обрабатывает входящие сообщения от пользователей бота через вебхук /hooks/telegram/{org_id}:

• Команда /start с параметром — привязка через deep link (см. шаг 3)
• Текстовые сообщения — логируются как события в ClickHouse (event_type: telegram_message)
• Callback query (нажатие кнопки) — логируется как событие, вызывается answerCallbackQuery

Все входящие сообщения отображаются в таймлайне контакта с направлением "inbound".

Типичные ошибки

1. Забыть про deep links. Без привязки telegram_chat_id клиент подписан на бота, но Trigly не знает, кто это. Обязательно настраивайте deep links.
2. Слишком частые рассылки. Telegram-пользователи чувствительнее к частоте, чем email-подписчики. Рекомендация: не более 2-3 сообщений в неделю. Используйте frequency capping.
3. Длинные тексты. Telegram обрезает сообщения длиннее 4096 символов. ContentAdapterService автоматически укорачивает HTML до лимита, но лучше писать кратко.
4. Отсутствие кнопки отписки. Добавляйте inline-кнопку "Отписаться" или ссылку — это уважение к пользователю и снижение блокировок бота.

Ожидаемые метрики

• Open Rate: 70-90% (сообщения видны сразу)
• Click Rate (inline-кнопки): 15-30%
• Привязка через deep links: 40-60% от получивших ссылку
• Стоимость отправки: 0 рублей (Telegram Bot API бесплатный)
• Блокировка бота: 5-10% за первый месяц (нормально)

FAQ

Сколько сообщений можно отправить через бота? Telegram Bot API не имеет жёсткого лимита на количество сообщений, но ограничивает скорость: не более 30 сообщений в секунду и не более 20 сообщений в минуту в один чат. Trigly соблюдает эти лимиты автоматически через rate limiting в TelegramFullAdapter.

Что делать, если клиент заблокировал бота? При попытке отправки в заблокированный чат Telegram возвращает ошибку 403. Trigly помечает сообщение как failed и может автоматически отправить через fallback-канал (например, email).

Можно ли использовать один бот для нескольких организаций? Нет, каждая организация в Trigly должна иметь своего бота. Это связано с тем, что вебхук Telegram привязан к конкретному URL с org_id, и один бот может иметь только один активный вебхук.

---

Итог

Telegram — один из самых эффективных каналов маркетинга в России с Open Rate 70-90% и нулевой стоимостью отправки. Подключение бота через BotFather и Trigly занимает 15 минут. Главное — не забыть про deep links для привязки chat_id к профилю клиента и соблюдать частоту рассылок (не более 2-3 в неделю). Telegram отлично работает как основной канал для молодой аудитории и как fallback для тех, кто не читает email.

---

Подключите Telegram за 15 минут и начните общаться с клиентами там, где они проводят время. Создайте аккаунт в Trigly и настройте бота прямо сейчас.