Telegram
A integração com o Telegram permite que o agente converse com usuários diretamente no Telegram por meio de um bot.
Acesse pelo ícone Configurações → aba Integrações → card Telegram.
Habilitar a integração
Ative o toggle no card do Telegram. Os campos de configuração ficam visíveis após a ativação.
Campos de configuração
| Campo | Obrigatório | Descrição |
|---|---|---|
| Bot Token | Sim | Token fornecido pelo @BotFather ao criar o bot |
| Secret Token | Não | String de segurança — deve ser a mesma usada no parâmetro secret_token da chamada setWebhook |
| Allowed Chat IDs | Não | IDs de chats separados por vírgula (ex.: 123456789,-100987654321). Quando preenchido, o bot responde somente nesses chats |
Criando o bot no Telegram
- Inicie uma conversa com @BotFather no Telegram.
- Envie
/newbote siga as instruções para nomear o bot. - O BotFather fornece o Bot Token ao final do processo.
- Configure o webhook do Telegram apontando para a URL de webhook do agente usando a API
setWebhook.
info
Para obter o Chat ID de um grupo ou canal, adicione o bot ao chat e envie uma mensagem. O ID aparece nos logs de mensagens recebidas ou pode ser obtido via API getUpdates.
Use o ID do Agente exibido no topo da aba Integrações para montar a URL de webhook.