Your AI Connector Docs

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 e Moving from Campaigns to Broadcasts & Agents.

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 e Acesso à API.

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.