Use este guia quando você precisar configurar, entender ou validar Como conectar Telegram na IAra.

Antes de começar na IAra

• Confirme que seu usuário tem permissão para acessar a área citada no artigo.
• Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
• Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

Etapa 1. Vá para Configurações → Caixas de entrada → “Adicionar caixa de entrada”.

Etapa 2. Clique no ícone "Telegrama".

Etapa 3. Crie um novo bot do Telegram usando o Telegram BotFather.

Etapa 4. Insira o token API do bot do Telegram e clique em “Criar canal do Telegram”.

Etapa 5. "Adicionar agentes" à sua caixa de entrada do Telegram.

A configuração da caixa de entrada está concluída.

Etapa 6. Vá para a página de configurações da caixa de entrada e verifique se o nome da caixa de entrada corresponde ao nome de usuário do bot criado usando BotFather.

Etapa 7. Envie uma mensagem para o bot do Telegram. Verifique a caixa de entrada da IAra Telegram para a nova mensagem.

Perguntas frequentes

A IAra oferece suporte a contas Telegram Business Bot?

Sim – o suporte para bots do modo Telegram Business foi adicionado na IAra v4.3.0 (18 de junho de 2025).

Como habilitar Business Bots?

1. Em @BotFather execute /business_mode, escolha seu bot e confirme.

2. Crie uma nova caixa de entrada do Telegram na IAra (Configurações → Caixas de entrada → Adicionar caixa de entrada → Telegram) e cole o mesmo token do bot.

3. A IAra detecta automaticamente o Modo Empresarial e registra o webhook correto.

4. Para obter melhores resultados, mantenha este bot Business em sua própria caixa de entrada, separado de qualquer bot padrão que você já usa. 

Problemas conhecidos com o Business Bot

• Janela de resposta de 24 horas – o Telegram só permite que o bot (e a IAra) responda dentro de 24 horas após a última mensagem do cliente. 

• Se um usuário já conversou anteriormente com o mesmo bot fora do Modo Empresarial, as respostas podem parecer vir do bot e não da conta Empresarial; criar um bot de negócios e uma caixa de entrada dedicados evita essa confusão.

• A API Telegram Business atualmente é menos rica em recursos do que a API Bot normal (por exemplo, sem indicadores de digitação, tipos de mensagens limitados). Mantenha as expectativas de acordo.

Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

• Usuário sem permissão para acessar a configuração.
• Nome de tela diferente entre versões ou contas.
• Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
• Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

• [ ] Configuração revisada por um administrador.
• [ ] Teste realizado com dado ou conversa controlada.
• [ ] Impacto para agentes e gestores entendido.
• [ ] Artigos relacionados revisados para evitar links quebrados.