Pular para o conteúdo principal

🤖 Bot do Telegram

O PulseHub conecta-se ao Telegram atraves da Bot API. Quando usuarios enviam mensagens ao seu bot do Telegram, as mensagens aparecem no PulseHub.


Pre-requisitos

Uma conta Telegram e acesso ao @BotFather para criar um bot.


Passos de Configuracao

1. Criar um Bot com o BotFather

  1. Abra o Telegram e procure por @BotFather
  2. Envie /newbot
  3. Escolha um nome de exibicao (ex: "Suporte Acme")
  4. Escolha um nome de usuario terminando em bot (ex: acmesupport_bot)
  5. O BotFather responde com seu Bot Token

2. Adicionar o Canal no PulseHub

  1. Va ate Channels → Add Channel
  2. Selecione Telegram
  3. Cole seu Bot Token
  4. Clique em Save Channel
  5. Copie a URL do Webhook

3. Registrar o Webhook no Telegram

Abra esta URL no seu navegador:

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

O Telegram responde com: {"ok": true, "result": true, "description": "Webhook was set"}

4. Testar

Abra seu bot no Telegram e envie uma mensagem. Ela deve aparecer no PulseHub em segundos.


Requisitos de Webhook do Telegram

  • A URL do webhook deve usar HTTPS com um certificado SSL valido
  • O Telegram espera uma resposta 200 dentro de 60 segundos

Problemas Comuns

SintomaCausa Provavel
Webhook nao configuradoA URL deve ser HTTPS com certificado valido
Bot nao respondeVerifique se telegram_chat_id esta em contacts.external_ids
Mensagens antigas reenviadasNormal ao reregistrar o webhook