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](https://telegram.me/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.