Перейти к основному содержимому

🤖 Telegram-бот

PulseHub подключается к Telegram через Bot API. Когда пользователи отправляют сообщения вашему Telegram-боту, сообщения появляются в PulseHub.

Предварительные требования​

Аккаунт Telegram и доступ к @BotFather для создания бота.

Шаги настройки​

1. Создайте бота через BotFather​

  1. Откройте Telegram и найдите @BotFather
  2. Отправьте /newbot
  3. Выберите отображаемое имя (например, «Поддержка Acme»)
  4. Выберите имя пользователя, заканчивающееся на bot (например, acmesupport_bot)
  5. BotFather ответит вашим Bot Token

2. Добавьте канал в PulseHub​

  1. Перейдите в Channels → Add Channel
  2. Выберите Telegram
  3. Вставьте ваш Bot Token
  4. Нажмите Save Channel
  5. Скопируйте URL Webhook

3. Зарегистрируйте Webhook в Telegram​

Откройте этот URL в браузере:

https://api.telegram.org/bot{YOUR_BOT_TOKEN}/setWebhook?url={YOUR_PULSEHUB_WEBHOOK_URL}

Telegram ответит: {"ok": true, "result": true, "description": "Webhook was set"}

4. Тестирование​

Откройте вашего бота в Telegram и отправьте сообщение. Оно должно появиться в PulseHub в течение нескольких секунд.

Требования Telegram к Webhook​

  • URL webhook должен использовать HTTPS с действительным SSL-сертификатом
  • Telegram ожидает ответ 200 в течение 60 секунд

Частые проблемы​

СимптомВероятная причина
Webhook не установленURL должен быть HTTPS с действительным сертификатом
Бот не отвечаетПроверьте, что telegram_chat_id есть в contacts.external_ids
Повторная доставка старых сообщенийНормальное явление при повторной регистрации webhook