Este guia mostra a forma recomendada de conectar um bot do Telegram ao SendBot.

​
1. Crie o bot no Telegram

  1. Abra o @BotFather no Telegram.
  2. Envie /newbot.
  3. Escolha o nome que seus clientes verão.
  4. Escolha um username único. Para bots padrão criados pelo BotFather, use um username terminado em bot, por exemplo minha_empresa_bot.
  5. Copie o token entregue pelo BotFather.
Trate o token do bot como uma senha. Quem tiver esse token poderá controlar o bot.

​
2. Conecte o bot no SendBot

  1. Abra o bot no Studio.
  2. Vá em Compartilhar → Telegram.
  3. Escolha Criar nova conta.
  4. Opcionalmente dê um nome à conexão e cole o Bot token.
  5. Salve a conexão.
O SendBot valida o bot no Telegram, persiste o vínculo da credencial, gera o segredo de segurança do webhook no servidor, registra o webhook e ativa o canal Telegram. Você não precisa criar um secret token nem chamar setWebhook manualmente.

​
3. Verifique a conexão

Depois da conexão, o Studio mostra a identidade do bot do Telegram e o status. Uma conexão saudável deve mostrar:
  • o username esperado do Telegram;
  • Conexão ativa;
  • nenhum erro do webhook do Telegram;
  • atualizações pendentes voltando para zero depois do processamento.
Use Reconectar Telegram apenas quando o webhook precisar ser registrado novamente. A URL do webhook fica disponível para diagnóstico. O segredo de segurança é gerenciado pelo SendBot e não faz parte da configuração normal.

​
4. Configurações avançadas opcionais

Em Configurações avançadas você pode:
  • pausar ou reativar o canal Telegram;
  • alterar o tempo de expiração da sessão;
  • definir uma condição de início.
Essas opções são opcionais. Um bot recém-conectado é ativado automaticamente.

​
5. Publique

Publique o bot quando a conexão do Telegram estiver saudável. A publicação disponibiliza o fluxo atual para novas sessões recebidas pelo Telegram.

​
Solução de problemas

​
Token rejeitado

Volte ao @BotFather e confirme que copiou o token atual do bot correto. Se um token tiver sido exposto, revogue-o no BotFather e gere outro.

​
Webhook desconectado

Use Reconectar Telegram no Studio e depois Verificar status.

​
A mensagem chega ao Telegram, mas nenhuma sessão é criada no SendBot

Confirme que:
  • o Studio mostra a mesma credencial Telegram que possui o webhook ativo;
  • o canal Telegram está ativo;
  • o bot foi publicado;
  • o status do webhook não mostra erro do provedor.
Se o webhook estiver saudável e o runtime ainda não criar uma sessão, envie para análise técnica o bot/workspace afetado e o horário aproximado da mensagem.