
# E-mail (Beta)

Transforme sua caixa de entrada de e-mail em um canal respondido por IA. Conecte a caixa de correio que você já usa para suporte — Gmail, Outlook/Microsoft 365 ou qualquer caixa de correio IMAP personalizada — e um Agente de IA lerá os novos e-mails e responderá automaticamente, diretamente do seu próprio endereço. Prefere não configurar nada? Você também pode obter um endereço pronto para uso.


> **Beta.** O canal de E-mail agora está disponível para todos, mas ainda é novo — espere algumas imperfeições ocasionais enquanto o refinamos. Se algo não funcionar como descrito, informe o suporte.

---

## O que é o canal de E-mail?

O canal de E-mail monitora uma caixa de entrada em busca de novas mensagens. Quando alguém lhe envia um e-mail, a mensagem aparece em **Chats** como qualquer outra conversa, e seu Agente de IA responde por e-mail automaticamente. As respostas são agrupadas sob o e-mail original, para que a troca de mensagens permaneça em um tópico organizado para o seu cliente.

Existem **duas maneiras** de conectar:

1. **Conecte sua própria caixa de correio (recomendado).** Use o endereço para o qual seus clientes já escrevem — `support@yourcompany.com`, seu Gmail, seu Outlook. As respostas virão do seu endereço real.
2. **Use um endereço gerenciado.** Obtenha um endereço instantâneo em nosso domínio de e-mail gerenciado — mostrado durante a configuração — sem nenhuma configuração da sua parte.

---

## Conectando E-mail

1. Na barra lateral esquerda, clique em **Settings** (Configurações) próximo à parte inferior.
2. Na barra lateral de Settings, em **Channels** (Canais), clique em **Channels**.
3. Encontre o cartão **Email** e clique em **Connect** (Conectar).
4. Na tela **Connect Email** (Conectar e-mail), escolha como deseja se conectar: **Gmail**, **Outlook**, **Custom IMAP/SMTP** ou **Use a managed address** (Usar um endereço gerenciado).


### Opção A: Gmail ou Outlook

> **Não existe um botão "Entrar com Google" ou "Entrar com Microsoft".** O Gmail e o Outlook são conectados com uma **senha de aplicativo**, não com uma janela de login do provedor. Selecionar **Gmail** ou **Outlook** simplesmente preenche as configurações do servidor para você.

O **Gmail** conecta-se com uma **senha de app** do Google. Escolha **Gmail** e o formulário de credenciais será aberto com as configurações do servidor Gmail já preenchidas — você só precisa inserir seu endereço e a senha de app:

1. Na sua Conta do Google, ative a **Verificação em duas etapas** (em **Segurança**), caso ainda não tenha feito isso.
2. Ainda em **Segurança**, abra **Senhas de app** e crie uma (qualquer nome serve).
3. Cole a senha de 16 caracteres no campo **Senha** — não a sua senha normal do Gmail.

Certifique-se também de que o **IMAP esteja ativado** nas configurações do seu Gmail. Isso funciona tanto para endereços pessoais do Gmail quanto para o Google Workspace, e você pode revogar a senha de app a qualquer momento na sua Conta do Google sem afetar sua senha real.

> **Por que uma senha de app?** O Google não permite mais que aplicativos de e-mail façam login com sua senha normal. Uma senha de app é o método que o Google oferece em substituição: uma senha de uso único gerada apenas para esta conexão, mais segura que a sua senha real e que pode ser revogada individualmente.

O **Outlook** funciona da mesma maneira por enquanto: escolha **Outlook** e use uma senha de app no formulário que for aberto (crie uma nas configurações de segurança da sua Conta Microsoft). Muitas contas corporativas (Microsoft 365) bloqueiam senhas de app — se o formulário for rejeitado, peça ao seu administrador de TI para ativar o IMAP/SMTP para sua conta.

### Opção B: IMAP/SMTP Personalizado (qualquer provedor)

Escolha **IMAP/SMTP Personalizado** e insira:

1. **Endereço de e-mail** — a caixa de correio que você deseja conectar (por exemplo, `support@yourcompany.com`).
2. **Senha** — a senha da sua caixa de correio ou uma **senha de aplicativo**, caso seu provedor exija uma.
3. **Nome do remetente** (opcional) — o nome "De" que os clientes veem nas respostas.
4. **Nome de usuário** (opcional) — apenas se for diferente do seu endereço de e-mail.


A maioria dos provedores conhecidos preenche as configurações do servidor para você. Para qualquer outra situação, abra **Avançado (configurações do servidor)** e insira o host/porta **IMAP** (geralmente 993) e o host/porta **SMTP**. Para a porta SMTP, use **587**. As páginas de ajuda do seu provedor de e-mail listam os nomes dos hosts.

> **Se o seu provedor solicitar o uso da porta SMTP 465, use a 587.** São duas maneiras de fazer a mesma coisa, e a 587 é a que funciona com a plataforma. Rackspace, Gmail, Yahoo, Fastmail e a maioria dos outros suportam a 587. O IMAP permanece na 993.

Clique em **Conectar caixa de correio**. Testamos tanto o recebimento (IMAP) quanto o envio (SMTP) antes de salvar — se algo estiver errado, você receberá uma mensagem clara imediatamente.

### Opção C: Usar um Endereço Gerenciado

Sem caixa de entrada para conectar — escolha um endereço em nosso domínio de e-mail e pronto.

1. Na tela de conexão, escolha a opção de endereço gerenciado.
2. Digite o **endereço da caixa de entrada** que você deseja (a parte antes do `@`). Use de 3 a 30 letras, números, pontos, sublinhados ou hifens — por exemplo, `support`, `hello` ou `yourbrand`.
3. Opcionalmente, defina um **Nome do remetente**.
4. Clique em **Conectar**.
5. Copie o endereço completo que aparece — o nome escolhido por você no domínio de e-mail gerenciado mostrado no formulário.
6. Compartilhe esse endereço com seus leads.


---

## Adicionando uma assinatura (Opcional)

Você pode adicionar uma assinatura que será incluída ao final de **todos** os e-mails enviados por esta caixa de entrada — tanto as respostas da IA quanto as que você mesmo digita nos Chats.

1. Vá para **Configurações → Canais → Canais** e clique em **Gerenciar** no cartão de **E-mail** (se você acabou de conectar, já estará nesta tela).
2. Digite sua assinatura em **Assinatura (opcional)** — por exemplo, seu nome, cargo e empresa.
3. Clique em **Salvar assinatura**.


Algumas coisas que vale a pena saber:

- **É opcional.** Deixe a caixa vazia e os e-mails serão enviados exatamente como antes. Para remover uma assinatura posteriormente, limpe a caixa e salve novamente.
- **É adicionada quando o e-mail é enviado**, portanto, você não a verá repetida em cada mensagem na conversa do Chat — e seu Agente de IA não a lerá como parte da conversa.
- **Fica bem no final**, após a mensagem e após qualquer link que o bot compartilhe.
- **Apenas texto simples**, com até 2000 caracteres. As quebras de linha são mantidas exatamente como você as digita.
- **É por caixa de entrada.** Se você conectar mais de uma caixa de correio, cada uma terá sua própria assinatura.

---

## Configurando um Agente de IA para E-mail

1. Na barra lateral esquerda, em **AI STUDIO**, clique em **AI Agents**.
2. Crie um novo Agente ou abra um existente.
3. Atribua o Agente ao E-mail como um **Ponto de Entrada** — é isso que encaminha novas conversas por e-mail para ele.
4. Novas pessoas que enviarem e-mail para sua caixa de entrada são encaminhadas para as conversas desse Agente, ou para o seu fluxo de entrada padrão, caso um esteja definido — veja [AI Agents](../ai-agents/ai-agents.md) e [Moving from Campaigns to Broadcasts & Agents](../moving-from-campaigns.md).

### Teste o Bot

1. De qualquer outra conta de e-mail, envie uma mensagem para sua caixa de correio conectada.
2. Abra o aplicativo e vá para **Chats** — o e-mail aparecerá como uma nova conversa.
3. Se a IA estiver habilitada no Agente correto, você a verá **responder por e-mail automaticamente**, na mesma thread.


---

## Qual é a velocidade das respostas?

E-mail não é um serviço de mensagens instantâneas e não mantemos uma conexão ativa constante com sua caixa de entrada. Em vez disso, **verificamos se há novas mensagens a cada poucos minutos**. Portanto, uma resposta geralmente é enviada dentro de um ou dois minutos após a chegada de um e-mail — algo normal para e-mail e que seus clientes não notarão.

---

## Custo

O e-mail é um canal **gratuito** — sem cobrança por mensagem e sem taxa mensal de conexão. O uso normal de créditos de IA para gerar respostas ainda se aplica, exatamente como em qualquer outro canal.

---

## Mensagens de mídia

O bot lê o **texto** dos e-mails recebidos. Anexos (imagens, PDFs, etc.) não são baixados para a conversa nesta versão. As respostas enviadas são em **texto simples** (um link é incluído se o bot precisar compartilhar um arquivo). E-mails apenas em HTML ou apenas com anexos, sem texto legível, são ignorados.

---

## Status da conexão e desconexão

O status da sua conexão de E-mail é exibido no cartão de **E-mail**:

| Status | Significado |
|---|---|
| **Conectado** | Ativo — recebendo e enviando e-mail |
| **Erro** | Não foi possível acessar a caixa de correio na última verificação — geralmente devido a uma senha de aplicativo alterada ou revogada. Reconecte com novas credenciais |
| **Não conectado** | Nenhuma caixa de correio conectada |

Se sua caixa de correio parar de funcionar, geralmente significa que sua senha ou senha de aplicativo foi alterada ou o acesso foi revogado — basta reconectar com novas credenciais.

Para desconectar: vá para **Configurações → Canais → Canais**, encontre o cartão de **E-mail** e clique em **Desconectar**. Pararemos de verificar a caixa de correio e excluiremos as credenciais armazenadas.

---

## Limitações

- **Respostas em texto.** A IA responde em texto simples; anexos são compartilhados como links em vez de uploads de arquivos.
- **Uma conversa por remetente.** Cada pessoa que lhe envia um e-mail torna-se um contato único, identificado pelo seu endereço de e-mail.
- **Um proprietário por caixa de correio.** Uma determinada caixa de correio só pode ser conectada a uma conta por vez.
- **E-mails automatizados são ignorados.** Avisos de devolução, respostas automáticas e e-mails de seus próprios endereços conectados são filtrados para evitar loops de resposta.
- **Lemos apenas novos e-mails.** Quando você se conecta pela primeira vez, seu histórico existente não é alterado — apenas os e-mails que chegam *após* a conexão são respondidos.
- **As respostas são enviadas a partir da caixa de correio que você conectou, não de um alias.** Se sua conta do Gmail tiver aliases de "Enviar e-mail como" configurados, eles não estarão disponíveis aqui: o endereço de remetente é sempre o endereço da própria caixa de correio conectada. Você pode alterar o **nome de exibição** mostrado ao lado dele, mas não o endereço. Para responder de um endereço diferente, conecte essa caixa de correio como seu próprio canal.
- **Sem e-mail de transcrição automática.** Não existe uma configuração que envie uma cópia de uma conversa para você ou para o contato quando um chat termina. Se você precisar de conversas fora do aplicativo, exporte-as ou obtenha-as através da API — veja [Exportando Seus Contatos](../get-started/exporting-contacts.md) e [Acesso à API](../integrations/api-access.md).

---

## Solução de problemas

### "Não foi possível conectar ao servidor IMAP/SMTP"

- Verifique novamente o **endereço de e-mail e a senha**. Se o seu provedor exigir uma **senha de aplicativo** (Gmail, Yahoo, iCloud e muitos outros), crie uma e cole-a em vez da sua senha normal.
- Certifique-se de que o **IMAP esteja ativado** nas configurações da sua caixa de correio (o Gmail e alguns provedores o deixam desativado por padrão).
- Para um provedor personalizado, verifique novamente o **host e a porta** em Avançado — o IMAP geralmente é 993 e, para SMTP, use **587** (se o seu provedor listar 465, use 587 em vez disso — é a que funciona aqui).

### O Outlook / Microsoft 365 não conecta com senha

Muitas contas do Microsoft 365 bloqueiam IMAP/SMTP baseado em senha. Não há uma opção "Entrar com Microsoft" aqui — o e-mail conecta-se apenas com uma senha de aplicativo — portanto, peça ao seu administrador de TI para permitir IMAP e SMTP para sua conta (e para permitir senhas de aplicativo), ou conecte uma caixa de correio diferente.

### "Esse endereço já está em uso" (endereço gerenciado)

Alguém (possivelmente você, em outra conexão) já usa esse endereço. Escolha um diferente — os endereços são únicos em toda a plataforma.

### O bot não está respondendo a um e-mail

- Confirme se o canal de E-mail está **habilitado em um Agente** (ou definido como seu fluxo de entrada padrão).
- Confirme se a IA está **ativa** para esse Agente.
- Lembre-se de que as respostas saem em um ciclo de verificação de **~2 minutos** — aguarde um minuto.
- Verifique se o remetente não é um endereço automatizado (avisos de devolução e respostas automáticas são filtrados propositalmente).

### "Não foi possível enviar sua mensagem. Tente novamente."

Digitar uma resposta por conta própria em **Chats** em uma conversa de e-mail costumava falhar com esta mensagem, não importava quantas vezes você tentasse novamente. Isso foi corrigido — abra a conversa e envie normalmente. Se você ainda vir a mensagem, verifique se sua caixa de correio não está exibindo um erro na página Canais.

### O cliente não recebeu a resposta

- Peça ao cliente para verificar sua **pasta de spam** e permitir o seu endereço.
- Se sua caixa de correio mostrar um erro na página Canais, reconecte-a — o envio pode ter parado porque as credenciais expiraram.

---

## Melhores práticas

- **Conecte a caixa de correio que os clientes já usam** para que as respostas venham de um endereço familiar e confiável.
- **Use uma senha de aplicativo** onde seu provedor oferecer uma — é mais seguro do que sua senha principal e fácil de revogar.
- **Defina um nome de Remetente** para que as respostas mostrem um nome "De" amigável.
- **Adicione uma assinatura** para que cada resposta termine com seu nome e empresa, da maneira que seus clientes esperam que um e-mail seja.
- **Ative o E-mail no Agente correto** para que as mensagens recebidas sejam respondidas com as instruções corretas.
