Подключение Telegram

Подключив Telegram-бота, вы принимаете сообщения от клиентов из Telegram в общую очередь поддержки Нотифлоу. Ответ оператора уходит обратно в Telegram через Bot API. Все двунаправленно — клиент не чувствует, что пишет не в привычный мессенджер.

Шаг 1. Создайте бота у BotFather

1. Откройте @BotFather в Telegram.
2. Отправьте команду /newbot.
3. Введите отображаемое имя (его видят клиенты, например «Поддержка Ромашки»).
4. Введите username — обязательно заканчивается на bot, например romashka_support_bot.
5. BotFather пришлет сообщение с токеном вида 123456789:AAE.... Скопируйте его целиком — вставите в Нотифлоу на шаге 2.

Опционально: задайте аватар (/setuserpic), описание (/setdescription) и приветствие (/setabouttext). Клиенты увидят это при первом открытии бота.

Шаг 2. Добавьте бота в кабинет Нотифлоу

1. В кабинете: Поддержка → Настройки → Каналы → Мессенджеры → Telegram.
2. Нажмите «Добавить бота». Откроется форма.
3. Выберите домен (привязка к одному из ваших сайтов — нужна, чтобы маршрутизация каналов работала корректно).
4. Вставьте токен из шага 1.
5. Сохраните. Нотифлоу сделает getMe к Bot API, подтянет username бота и автоматически установит webhook на POST /api/telegram/webhook/{configId} с секретным токеном (X-Telegram-Bot-Api-Secret-Token).

Шаг 3. Проверьте

Найдите своего бота в Telegram по username, отправьте /start и пару любых сообщений. В кабинете откройте Поддержка → Диалоги → Все — вы увидите новый диалог с каналом Telegram.

Ответьте из кабинета — сообщение должно прийти обратно в Telegram.

Диагностика: сообщения не приходят

В карточке бота есть раздел «События webhook». Там видно каждый входящий апдейт и код результата:

• processed — сообщение обработано и сохранено в диалог.
• rejected_disabled — конфиг помечен как неактивный. Включите toggle.
• rejected_bad_secret — Telegram прислал webhook без корректного secret-header. Скорее всего, webhook был переустановлен вручную. Нажмите «Пересохранить» в кабинете.
• rejected_no_user / rejected_no_config — Нотифлоу не смог сопоставить апдейт с конфигом. Проверьте, что токен в кабинете совпадает с текущим токеном у BotFather (/token).
• confirmation — Telegram проверил webhook. Это нормальное событие при сохранении.
• error — ошибка внутри Нотифлоу. Смотрите error_message в деталях события.

Если событий нет вообще 24 часа при активном боте, запустите диагностическую команду (нужен доступ к серверу):

php artisan support-chat:verify-webhooks --channel=telegram

Она опрашивает Bot API через getWebhookInfo и показывает статус webhook, pending_update_count и последнюю ошибку от Telegram.

Что если токен скомпрометирован

Отправьте /revoke у BotFather — получите новый токен. Откройте карточку бота в Нотифлоу, нажмите «Изменить», вставьте новый токен. Нотифлоу автоматически переустановит webhook.

Лимиты

Telegram ограничивает отправку 30 сообщениями в секунду в один чат и 20 разным пользователям. Нотифлоу уважает эти лимиты на бэкенде — при превышении сообщения ставятся в очередь. Для 95% команд это не ощущается; если у вас массовые рассылки, пишите через сценарии с задержкой.