Use este guia quando você precisar configurar, entender ou validar **Como conectar e-mail na IAra** 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

Para gerenciar seu e-mail de suporte ao cliente/tickets da IAra, você pode criar uma caixa de entrada de e-mail na IAra. Este é um guia completo para colocar seu canal de e-mail em funcionamento.

Este documento está dividido em três partes:

1. Criando uma caixa de entrada de e-mail

2. Configurações para usuários do Gmail

3. Criando uma caixa de entrada de email da Microsoft

Sinta-se à vontade para pular para qualquer seção. Vamos rolar.

## Como criar uma caixa de entrada de e-mail na IAra?

**Etapa 1.** Abra o painel da IAra. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada.

**Etapa 2**. Clique no ícone "E-mail".

**Etapa 3**. Insira o nome do canal (como você gostaria de abordar este canal) e seu e-mail de suporte e clique no botão "Criar canal de e-mail".

**P.S.** Você também verá uma opção para selecionar a Microsoft como provedor de e-mail. Se você usa um e-mail do Outlook/Microsoft, vá até a seção "**Como criar um canal de e-mail da Microsoft?**" (última seção).

**Etapa 4**. "Adicionar agentes" à sua caixa de entrada de e-mail.

Você criou com sucesso uma caixa de entrada de e-mail.

**Etapa 5**. Defina suas configurações de e-mail. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia Configuração.

Você verá três configurações principais aqui:

1. Encaminhar para e-mail

2. Configurar IMAP

3. Configurar SMTP

Todas as três configurações são explicadas nas seções a seguir.

### Como encaminhar e-mails para a caixa de entrada da IAra?

**Etapa 1**. Copie o "Encaminhar para endereço de e-mail" da guia Configuração em Configurações da caixa de entrada.

**Etapa 2**. Configure o endereço de e-mail copiado como endereço de encaminhamento de e-mail na caixa de entrada de e-mail.

**P.S.** Verifique a seção Gmail abaixo para saber como adicionar um endereço de encaminhamento no Gmail.

**Etapa 3**. Envie um e-mail para a caixa de entrada do endereço de encaminhamento adicionado e verifique a caixa de entrada de e-mail da IAra para obter o novo e-mail.

### Como configurar o IMAP para o canal Email?

Se você estiver usando o Gmail, role para baixo até a seção IMAP do Gmail abaixo.

**Etapa 1**. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia Configuração.

**Etapa 2**. Marque a caixa de seleção `Ativar configuração IMAP para esta caixa de entrada`. Você poderá ver os campos obrigatórios da seguinte maneira.

1. Endereço

2. Porto

3. E-mail

4. Senha

   **P.S.** Se estiver usando um Gmail habilitado para 2FA, role para baixo até "Como gerar senha de aplicativo para Gmail?" seção. Se estiver usando uma conta normal do Gmail, role para baixo até “Como permitir acesso menos seguro ao Gmail?” seção.

\
**Etapa 3**. Teste se tudo está funcionando bem. Envie um e-mail para o e-mail configurado pelo IMAP na IAra. Verifique a caixa de entrada da IAra para obter o novo e-mail. Abra a conversa por email na IAra e verifique os detalhes do email.

### Como configurar o SMTP para o canal Email?

**Etapa 1**. Vá para Configurações -> Caixas de entrada -> página de configurações da caixa de entrada de e-mail.

**Etapa 2**. Selecione a guia "Configuração".

**Etapa 3**. Para ativar o SMTP, marque a caixa de seleção "Ativar configuração SMTP para esta caixa de entrada".

Preencha os campos abaixo e clique no botão "Atualizar configurações de SMTP".

1. Endereço

2. Porto

3. E-mail

4. Senha

   **P.S.** Se estiver usando um Gmail habilitado para 2FA, role para baixo até "Como gerar senha de aplicativo para Gmail?" seção. Se estiver usando uma conta normal do Gmail, role para baixo até “Como permitir acesso menos seguro ao Gmail?” seção.

5. Domínio

**Etapa 4**. Abra uma conversa de e-mail existente na IAra.

**Etapa 5**. Digite uma mensagem de resposta para a conversa e clique no botão “Enviar”. Verifique se a correspondência foi entregue.

Você também pode verificar a caixa de entrada do destinatário do e-mail entregue.

## Configurações para usuários do Gmail

### Como ativar o IMAP para a caixa de entrada do Gmail?

**Etapa 1**. Abra sua caixa de entrada do Gmail e clique no ícone Configurações no canto superior direito. Clique no botão "Ver todas as configurações".

**Etapa 2**. Selecione a guia "Encaminhamento e POP/IMAP" na página Configurações.

**Etapa 3**. Escolha a opção “Ativar IMAP” na seção de acesso IMAP e clique no botão “Salvar alterações”.

### Como permitir acesso menos seguro ao Gmail?

**Observação:** esta opção não está disponível para contas do Gmail com verificação em duas etapas ativada ou gerenciadas por uma organização.

**Etapa 1**. Acesse [Segurança da Conta do Google](https://myaccount.google.com/security).

**Etapa 2**. Clique em “Ativar acesso” na seção “Acesso a aplicativos menos seguros” na página Segurança.

**Etapa 3**. Alterne "Permitir aplicativos menos seguros" para "ATIVADO". Agora você pode usar a senha da sua conta do Gmail para configurar IMAP/SMTP.

### Como gerar senha de aplicativo para Gmail?

**Observação:** esta opção é válida para contas do Gmail com verificação em duas etapas ativada ou gerenciadas por uma organização.

**Etapa 1**. Acesse [Segurança da Conta do Google](https://myaccount.google.com/security).

**Etapa 2**. Clique em “Senhas de aplicativos” na seção “Fazer login no Google” na página Segurança.

**Etapa 3**. Selecione o aplicativo Mail, selecione um dispositivo e clique em "GERAR". Use a senha gerada para configurar IMAP/SMTP.

### Como adicionar um endereço de encaminhamento para o Gmail?

**Etapa 1**.  Abra sua caixa de entrada do Gmail e clique no ícone Configurações no canto superior direito. Clique no botão "Ver todas as configurações".

**Etapa 3**. Clique no botão "Adicionar um endereço de encaminhamento". Ele solicitará o endereço de e-mail de encaminhamento. Digite aquele da IAra e clique no botão "Avançar".

\
**Etapa 4**. Confirme o endereço de encaminhamento no pop-up do navegador. A caixa de entrada do e-mail enviará um código de verificação para o endereço de e-mail de encaminhamento.

**Etapa 5**. Copie o código de verificação da caixa de entrada de e-mail da IAra.

**Etapa 6**. Cole o código de verificação e clique no botão "Verificar".

**Etapa 7**. Selecione a opção “Encaminhar uma cópia do e-mail recebido”. Escolha a ação necessária no segundo menu suspenso e clique no botão "Salvar alterações".

## Como criar um canal de email da Microsoft?

**Etapa 1.** Abra o painel da IAra. Vá para Configurações → Caixas de entrada → Adicionar Caixa de entrada.

**Etapa 2**. Clique no ícone "E-mail".

**Etapa 3**. Clique no ícone “Microsoft”.

**Etapa 4**. Adicione seu e-mail do Outlook/Microsoft.

**Etapa 5**. Insira suas credenciais do Microsoft/Outlook.

**Etapa 6**. Permita que o aplicativo "IAra" leia e responda seu e-mail.

**Etapa 7**. "Adicionar agentes" à sua caixa de entrada de e-mail.

Você criou com sucesso uma caixa de entrada de e-mail da Microsoft.

**Etapa 5**. Defina suas configurações de e-mail. Vá para Configurações → Caixas de entrada → Configurações da caixa de entrada de e-mail → guia Configuração.

Nota: Por enquanto, não altere nada em Configurações, pois usamos os valores padrão para IMAP e SMTP. Em breve tornaremos esses campos não editáveis para contas do Outlook.

\
Usamos configurações IMAP padrão para buscar e-mails e SMTP para enviar; você não precisa definir nada por meio da configuração.

**Etapa 6**. Se o seu token de acesso expirar, você deverá autorizar novamente sua conta da Microsoft acessando Configurações -> Configuração.

---

## 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.