Telegram

O gatilho Telegram conecta o agente a um bot do Telegram. A partir daí, qualquer mensagem enviada para o bot — em chat privado ou em grupo onde ele esteja — é respondida pelo agente.

Antes de conectar

Você precisa de um bot do Telegram criado pelo BotFather e do token que ele gera.

Como criar:

1. No Telegram, abra @BotFather.
2. Envie /newbot e responda às perguntas (nome de exibição e username, que precisa terminar em bot).
3. O BotFather devolve o token no formato 123456789:ABCDef.... Guarde — esse valor vai para o SquadOS.

Também confirme que:

• o agente está ativo e o prompt está pronto;
• ferramentas sensíveis têm guardrails adequados.

Conectando

1. Abra o agente no painel admin.
2. Vá para Gatilhos.
3. No card Telegram, clique em Conectar.
4. Cole o Token do Bot no campo.
5. Clique em Conectar Bot.

O SquadOS valida o token, registra o webhook no Telegram e o card passa para o estado Conectado, exibindo o @username do bot. Aparece também um link Abrir @username no Telegram que abre o bot direto no app/web.

Testando

1. Abra o bot pelo link do card (ou procure pelo @username no Telegram).
2. Envie /start.
3. Mande uma mensagem — o agente responde no chat.

Em grupos, o bot precisa ser adicionado por um admin do grupo e ler todas as mensagens. Pelo padrão do Telegram, alguns bots só respondem quando mencionados — verifique no BotFather (/setprivacy) se quer que o bot responda qualquer mensagem.

Como canal de entrega de Agendamentos

O bot conectado aqui também pode receber a resposta de um Agendamento do mesmo agente. Nesse caso, você precisa informar o Chat ID de destino na configuração do agendamento.

Veja o guia Como obter o Chat ID do Telegram.

Desconectando

No card já conectado, clique em Desconectar. O SquadOS remove o webhook do bot e o canal fica inativo imediatamente. O token original (do BotFather) continua válido — você pode reconectar a qualquer momento.

Problemas comuns

• “Erro ao conectar o bot. Verifique o token.” — token incorreto, expirou, ou já está em uso por outro agente do SquadOS. Gere um novo no BotFather.
• Bot não responde — verifique se você enviou /start ao bot. Em grupo, confirme que o bot foi adicionado.
• Mensagens em grupo não chegam — o modo privacy do bot está bloqueando mensagens não-mencionadas. Desative em /setprivacy no BotFather (envie /mybots → seu bot → Bot Settings → Group Privacy → Turn off).