Quando usar
-
Você quer conectar uma caixa de e-mail ao Cloud Chat para receber e responder e-mails de clientes na mesma inbox que chat e WhatsApp
-
Sua caixa é Gmail / Google Workspace, Outlook / Microsoft 365 ou de outro provedor (Zimbra, Yahoo, provedor próprio, etc.)
-
Você precisa reconectar uma caixa existente que está com erro
Pré-requisitos
Desligue a ClaudIA para a caixa que está criando antes da conexão. Quando um e-mail novo é conectado, o Cloud Chat puxa o histórico de e-mails como novas conversas — se a ClaudIA estiver ligada, ela passará a respondê-los.
-
Estar logado como administrador no Cloud Chat
-
O e-mail deve ser uma caixa de usuário (login + senha) — não pode ser grupo
-
Para Microsoft: o e-mail precisa ser a conta principal da conta Microsoft
-
Para IMAP/SMTP: acesso às configurações do provedor para ativar IMAP e obter endereço/porta dos servidores
Sobre este tutorial
O Cloud Chat suporta três caminhos para conectar uma caixa de e-mail:
-
Google (OAuth) — para Gmail e Google Workspace, via Sign in with Google
-
Microsoft (OAuth) — para Outlook.com e Microsoft 365, via Sign in with Microsoft
-
Outros provedores (IMAP/SMTP) — para qualquer outro provedor, com configuração manual
Google e Microsoft deprecaram suporte a integrações via IMAP — para esses dois, usamos integrações nativas (OAuth). Para todos os outros provedores, IMAP/SMTP é o caminho.
Pule direto para a etapa do seu provedor:
Vídeos de referência:
https://www.loom.com/embed/f97da4387d464ce998ca54a6c271dcc9
https://www.loom.com/embed/c28480dab2b5482c93f2801b4c9355a9
https://www.loom.com/embed/1114432b7f2a4c8b99f592b9dd002a3f
Passo a passo
Etapa 1 — Acessar Configurações de caixa
- Acesse Configurações no Cloud Chat

- Vá em Caixa de Entrada → Adicionar Caixa de Entrada


- Selecione o canal E-mail — em seguida escolha o provedor (Google, Microsoft ou Outros provedores)

Caminho A — Google (Gmail / Workspace)
Use quando a caixa for Gmail ou Google Workspace — integração via OAuth (Sign in with Google).
O aplicativo de conexão nativa com o Gmail está em fase beta aguardando aprovação do Google, mas está funcional.
1. Selecione Google como provedor
Após selecionar E-mail, clique em Google.

2. Faça o login Google
- Insira o endereço de e-mail que deseja conectar

-
Clique em Sign in with Google e siga o login Google
-
Selecione a conta e aceite as permissões solicitadas

3. Adicione os agentes
Selecione os agentes que terão acesso à caixa.

Pronto! A caixa Gmail está integrada ao Cloud Chat.
Limitações de sincronização (Google):
-
Apenas mensagens da Caixa de Entrada são sincronizadas para o Cloud Chat
-
Mensagens em outras pastas ou em spam não são sincronizadas automaticamente
Para mover mensagens de spam automaticamente, crie uma regra no Gmail: https://www.loom.com/share/4dde1712265c411c841c37d7a1e264df
Caminho B — Microsoft (Outlook / 365)
Use quando a caixa for Outlook.com ou Microsoft 365 — integração via OAuth (Sign in with Microsoft).
1. Habilite POP/IMAP no Outlook
- Acesse Settings → Mail → Forwarding and IMAP em outlook.live.com

.png)
.png)
- No bloco POP and IMAP, ative Let devices and apps use IMAP
.png)
- Clique em Save
2. Confirme que o e-mail é o principal
-
Acesse Minha Conta Microsoft → Suas Informações → Editar Informações da Conta
-
Verifique que o e-mail a conectar é a conta principal
Se o e-mail não for o principal, marque-o como tal clicando em Tornar o principal. Caixas secundárias não conseguem conectar.

3. Faça o login Microsoft no Cloud Chat
Após selecionar E-mail e escolher Microsoft:
-
Informe o endereço de e-mail
-
Clique em Sign in with Microsoft — você será redirecionado ao login Microsoft
Se você tem outras contas Microsoft na mesma máquina, uma delas pode vir preenchida automaticamente. Faça logout da conta Microsoft anterior antes ou — recomendado — faça a configuração em aba anônima.

4. Adicione os agentes
Após o redirecionamento de volta ao Cloud Chat, selecione os agentes que terão acesso e clique em Adicionar agentes.

Pronto! Sua caixa Outlook/Microsoft 365 está integrada ao Cloud Chat.
Caminho C — Outros provedores via IMAP/SMTP
Use quando a caixa for de qualquer outro provedor (Zimbra, Yahoo, provedor próprio etc.) — configuração manual via IMAP/SMTP.
1. Ative IMAP no provedor
-
Acesse as configurações do seu e-mail
-
Ative o encaminhamento IMAP
-
Copie as informações de conexão (endereço, porta)
2. Nomeie a caixa no Cloud Chat
Após selecionar E-mail e escolher Outros provedores:


- Nomeie a caixa e insira o e-mail

- Clique em Criar canal de e-mail

3. Adicione agentes
Selecione os agentes que vão atuar na caixa e clique em Adicionar agentes.

4. Configure o IMAP
- Clique em Mais configurações

- Vá em Configuração e ative o IMAP

- Insira endereço, porta, login e senha
Se o provedor tem autenticação de dois fatores, use a senha de app gerada — não a senha pessoal.
Endereço e porta padrão (exemplos):
| Provedor | Endereço IMAP | Porta |
|---|---|---|
imap.gmail.com |
993 |

- Clique em Atualizar as configurações de IMAP

5. Configure o SMTP
- Ative o SMTP

- Insira endereço, porta, login e senha (autenticação de dois fatores: use a senha de app)
Endereço e porta padrão (exemplos):
| Provedor | Endereço SMTP | Porta |
|---|---|---|
smtp.gmail.com |
587 |

- No campo Domínio, insira o mesmo do endereço do SMTP

Para a maioria dos casos, mantenha as opções de criptografia, SSL e autenticação no padrão (STARTTLS, none, login).
- Clique em Atualizar a configuração de SMTP

Pronto! Sua caixa de e-mail está conectada ao Cloud Chat.
Reconectar em caso de erro
Vale para caixas Google e Microsoft (caminhos A e B). Em caso de erro, a caixa de entrada exibe um alerta em vermelho.

Para reconectar:
-
Acesse Configurações → Caixas de Entrada → Configurações
-
Na faixa vermelha, clique em Clique aqui para reconectar
-
Faça o login Google ou Microsoft novamente conforme o caminho original

Não é necessário excluir a caixa para reconectar.
Observações
-
Para enviar disparo proativo via e-mail: Como enviar mensagens proativas unitárias no Cloud Chat
-
Para habilitar continuidade de conversa entre canais (chat → e-mail): Como habilitar continuidade de conversas por e-mail
-
Erro 550 5.7.515 em Google Workspace: Como corrigir o erro 550 5.7.515 — Autenticação de e-mail via Google Workspace