🤖 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
- Abra o Telegram e procure por
@BotFather - Envie
/newbot - Escolha um nome de exibicao (ex: "Suporte Acme")
- Escolha um nome de usuario terminando em
bot(ex:acmesupport_bot) - O BotFather responde com seu Bot Token
2. Adicionar o Canal no PulseHub
- Va ate Channels → Add Channel
- Selecione Telegram
- Cole seu Bot Token
- Clique em Save Channel
- 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
200dentro de 60 segundos
Problemas Comuns
| Sintoma | Causa Provavel |
|---|---|
| Webhook nao configurado | A URL deve ser HTTPS com certificado valido |
| Bot nao responde | Verifique se telegram_chat_id esta em contacts.external_ids |
| Mensagens antigas reenviadas | Normal ao reregistrar o webhook |