> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# E-mail

> Conecte a caixa de correio do Gmail ou do Microsoft 365 da sua equipe para que os e-mails dos seus clientes cheguem à sua Caixa de entrada, seu agente de IA os responda e as respostas saiam dessa mesma caixa.

O canal de **E-mail** conecta uma caixa de correio compartilhada da sua empresa (por exemplo `vendas@suaempresa.com` ou `suporte@suaempresa.com`) à Ciarem. Você a conecta entrando na caixa de correio com o Google ou a Microsoft, do mesmo jeito que conecta uma agenda. Os e-mails que seus clientes enviam para essa caixa chegam à mesma [Caixa de entrada](https://help.ciarem.ai/pt/using-ciarem/inbox.md) que o WhatsApp, o Instagram e o Messenger. Seu agente de IA os lê e os responde como qualquer outro chat, e cada resposta sai dessa caixa de correio, na mesma conversa de e-mail.

O e-mail é para **conversas individuais** com seus clientes: respostas e um e-mail novo para um contato. As campanhas de e-mail em massa chegam em breve.

## Antes de começar

* A caixa de correio precisa estar no **Google Workspace (Gmail)** ou no **Microsoft 365 (Outlook)**. Outros provedores de e-mail não podem ser conectados.
* Conecte uma **caixa de correio compartilhada da empresa** para a qual seus clientes escrevem, como `vendas@` ou `suporte@`, e não a caixa pessoal de alguém da equipe. Cada pessoa da equipe pode registrar os e-mails da própria caixa de e-mail com contatos em [Minha caixa de e-mail](https://help.ciarem.ai/pt/using-ciarem/my-mailbox.md).
* Somente **administradores** podem conectar uma caixa de correio.
* Seu plano precisa incluir o e-mail. Se não incluir, a janela de conexão diz "O e-mail não está incluído no seu plano."
* Você precisa conseguir entrar na caixa de correio ou, no Microsoft 365, em uma conta que consiga abri-la.

## Conecte uma caixa de correio

**1. Abra a página de E-mail**

Na barra lateral, vá até **Canais**, depois **E-mail**, e clique em **Conectar uma caixa de correio** (ou em **Adicionar caixa de correio** se você já tiver uma).

**2. Escolha onde está a caixa de correio**

Escolha **Google** (Gmail ou Google Workspace) ou **Microsoft** (Outlook ou Microsoft 365).

**3. Informe o nome do remetente e, se precisar, o endereço**

Digite o **Nome do remetente** que seus clientes verão nas suas respostas (por exemplo, "Suporte da Sua Empresa").

Se o endereço para o qual seus clientes escrevem não for a conta com a qual você entra, ative a chave e digite o **Endereço da caixa de correio**. Deixe a chave desativada para conectar a conta com a qual você vai entrar. A chave diz:

* **Usar um alias ou um Grupo do Google** para o Google. Um alias precisa ser da conta com a qual você entra e estar verificado no Gmail, em **Configurações**, **Contas**, **Enviar e-mail como**. O endereço de um Grupo do Google não consegue entrar, então funciona por meio de um membro: entre como um membro que recebe os e-mails do grupo e tem o endereço do grupo em **Enviar e-mail como**. A Ciarem só guarda os e-mails enviados para esse endereço; o restante do e-mail da conta não é salvo.
* **Usar uma caixa compartilhada** para a Microsoft. Precisa ser uma caixa de correio compartilhada que a conta com a qual você entra consegue abrir.

Um endereço que sua organização já conectou é recusado ali mesmo, antes da entrada: "Esta caixa de correio já está conectada." **Voltar** retorna ao primeiro passo.

**4. Entre e aprove o acesso**

Clique em **Continuar com o Google** ou **Continuar com a Microsoft**, entre e aprove o acesso que a Ciarem pede. Quando a janela fecha, a caixa de correio aparece na página de E-mail. Entrar com o Google ainda não está disponível (a opção diz "Continuar com Google ainda não está disponível"); por enquanto, conecte uma caixa de correio do Microsoft 365 ou Outlook.

### Que acesso a Ciarem pede

* **Ler seus e-mails**, para que os e-mails novos da caixa de entrada cheguem à Ciarem e para que as respostas que sua equipe envia pelo Gmail ou pelo Outlook também apareçam na Ciarem.
* **Enviar e-mails**, para que a IA e sua equipe possam responder pela caixa de correio.
* Seu **endereço de e-mail**, para saber qual caixa de correio você conectou.

A Ciarem só lê a caixa de entrada e os enviados da caixa de correio, e só envia pela caixa de correio que você conectou.

### Se o Google mostrar uma tela de aviso

Enquanto o Google ainda analisa a Ciarem, ele pode mostrar uma tela de "O Google não verificou este app" ou bloquear a entrada. O administrador do Google Workspace da sua empresa pode marcar a Ciarem como confiável no Google Admin Console (**Segurança**, **Acesso e controle de dados**, **Controles de API**, **Gerenciar o acesso de apps de terceiros**) para que sua equipe consiga entrar. Se mesmo assim não conseguir conectar, escreva para [support@ciarem.ai](mailto:support@ciarem.ai).

## Gerencie suas caixas de correio

Em **Canais**, depois **E-mail**, a tabela **Caixas de correio conectadas** mostra cada caixa de correio, o status dela (**Conectada** ou **Sincronização falhando**) e quando foi conectada.

* Clique em uma caixa de correio para abrir a página dela. Ali você muda o **Nome do remetente** e a **Assinatura** e clica em **Salvar alterações**, e pode **Desconectar** a caixa de correio.
* O menu ⋯ da linha tem **Configurações** e **Desconectar**.

A página de E-mail também tem um cartão **Modelos** (**Ver modelos**) e um cartão **Campanhas** (**Ver campanhas**). Veja [Campanhas de e-mail](https://help.ciarem.ai/pt/channels/email-campaigns.md).

## O que sua equipe vê na Caixa de entrada

Cada cliente tem uma conversa, e cada e-mail vira uma mensagem nela, marcada com o canal de e-mail:

* Os e-mails novos aparecem segundos depois de chegar à caixa de correio.
* O **assunto** aparece acima do texto da mensagem.
* Os **anexos** que o cliente enviou aparecem abaixo da mensagem como arquivos que você pode abrir; imagens e vídeos aparecem na própria mensagem.
* Um e-mail que o cliente escreveu com **formatação** (negrito, links, listas, imagens dentro do texto) aparece assim na conversa. Quando é uma resposta, as mensagens anteriores citadas abaixo ficam recolhidas: clique no botão **…** abaixo do texto para lê-las.
* Na lista de conversas, um e-mail mostra o início do seu texto.

O [app móvel](https://help.ciarem.ai/pt/mobile/inbox-on-mobile.md) também mostra os e-mails com a formatação e as citações recolhidas, a linha Cc abaixo do assunto e anexos que abrem ao tocar neles. Uma resposta pelo app também pode levar vários arquivos, mas não notas de voz.

Na página de E-mail, cada caixa de correio conectada mostra quando foi sincronizada pela última vez. Se a última sincronização falhou, o status dela é **Sincronização falhando**; abra a caixa de correio para ver o erro.

## Como funcionam as respostas

* Seu agente de IA responde os e-mails do mesmo jeito que responde os chats, com as mesmas [regras de transferência](https://help.ciarem.ai/pt/ai-agent/human-handoff-and-escalation.md). Alguém da equipe pode assumir e responder pela Caixa de entrada a qualquer momento.
* Cada resposta enviada pela Ciarem sai **da caixa de correio conectada**, com o seu nome de remetente, na **mesma conversa de e-mail** da mensagem do cliente. Ela fica salva na pasta de **Enviados** da caixa de correio, então a conversa lá fica completa.
* Uma resposta mantém todos que o cliente tinha na conversa: as pessoas em **Cc** no último e-mail dele também recebem a resposta, e a Caixa de entrada as mostra abaixo do assunto.
* Se uma resposta falhar, você pode tentar de novo pela Caixa de entrada.
* As conversas por e-mail **não recebem acompanhamentos automáticos**: os [acompanhamentos](https://help.ciarem.ai/pt/ai-agent/follow-ups.md) de um agente só são enviados nos outros canais.
* Uma resposta pela Caixa de entrada pode levar **arquivos**: clique no botão de anexar e escolha um ou vários (você pode adicionar mais na janela que se abre); eles saem no mesmo e-mail que o seu texto, até 17 MB no total a partir de uma caixa do Gmail ou Google Workspace e 2 MB a partir de uma caixa da Microsoft. Os arquivos enviados aparecem abaixo da mensagem.
* Use o botão de formatação para escrever em **negrito**, *itálico* e ~~tachado~~; o cliente vê essa formatação no e-mail. As respostas da IA também podem usar negrito, itálico e tachado.

Você pode adicionar uma **Assinatura** a uma caixa de correio na página dela (veja [Gerencie suas caixas de correio](#gerencie-suas-caixas-de-correio)); ela é adicionada ao final de cada resposta enviada por essa caixa.

### Responder pelo Gmail ou pelo Outlook

Sua equipe pode continuar respondendo pelo Gmail ou pelo Outlook. A Ciarem lê a pasta de **Enviados** da própria caixa de correio conectada: uma resposta salva ali aparece na conversa da Ciarem como uma resposta da equipe, e a conversa passa para uma pessoa, então a IA para de respondê-la. Um e-mail que sua equipe inicia pela caixa de correio aparece na Ciarem só quando responde a uma conversa que a Ciarem já tem ou vai para alguém que já é um contato; o e-mail para qualquer outra pessoa a partir da caixa de correio é deixado em paz, então fornecedores e colegas nunca viram contatos.

Uma resposta que não fica salva nessa pasta de Enviados nunca chega à Ciarem, e a IA continua respondendo:

* **Alias do Google:** envie a resposta **como o alias**, escolhendo-o no campo **De** do Gmail. Uma resposta enviada pelo endereço próprio da conta é ignorada.
* **Caixa de correio compartilhada do Microsoft 365:** por padrão o Outlook salva a resposta enviada como a caixa compartilhada nos Itens enviados **de quem envia**, não nos da caixa compartilhada. Peça ao administrador do Microsoft 365 que ative a cópia de itens enviados na caixa compartilhada: no centro de administração do Microsoft 365, em **Equipes e grupos**, **Caixas de correio compartilhadas**, abra a caixa e, em **Itens enviados**, ative **Copiar itens enviados como esta caixa de correio** e **Copiar itens enviados em nome desta caixa de correio** (no PowerShell do Exchange, `MessageCopyForSentAsEnabled` e `MessageCopyForSendOnBehalfEnabled`).

## Escreva um e-mail novo para um contato

Você pode começar uma conversa de e-mail nova com um contato pela página dele, sem esperar que ele escreva primeiro.

**1. Abra o contato**

Vá em **Contatos** e abra o contato. Ele precisa ter um e-mail no perfil.

**2. Escolha Novo e-mail**

Clique no menu **⋯** ao lado do nome do contato e escolha **Novo e-mail**. A opção aparece quando o contato tem e-mail e seu espaço de trabalho tem uma caixa de correio conectada. Os agentes só a veem nos contatos dos quais são responsáveis.

**3. Escreva o e-mail**

Se você conectou mais de uma caixa de correio, escolha de qual enviar em **De**. Escreva o **Assunto** e a **Mensagem**, e anexe arquivos se precisar. Os arquivos têm o mesmo limite das respostas. A mensagem tem uma barra de formatação: títulos, negrito, itálico, sublinhado, listas, links, botões e divisores. **Dados** insere um dado, como o nome do contato (`{{contact.first_name|cliente}}`; o texto depois de `|` é usado quando o contato não tem esse dado), o nome da empresa dele (com o complemento [Empresas](https://help.ciarem.ai/pt/using-ciarem/companies.md) ativo) ou o seu próprio nome, que é preenchido quando o e-mail é enviado. Os administradores em um plano com campanhas de e-mail também podem adicionar imagens e usar **Começar com um modelo**, que preenche o assunto e a mensagem com um modelo de e-mail (**Canais**, **E-mail**, **Modelos**); você pode editar os dois antes de enviar. O e-mail sai como uma carta normal da sua caixa de correio, sem o rodapé nem o link de cancelamento de inscrição que uma campanha leva.

**4. Envie**

Clique em **Enviar e-mail**. O e-mail sai da caixa de correio como uma conversa nova com o seu assunto, e a Ciarem abre a conversa na Caixa de entrada. A conversa fica atribuída a você, e quando o contato responder, a resposta chega na mesma conversa.

Se o contato já tiver uma conversa de e-mail aberta nessa caixa de correio, o e-mail novo entra nela em vez de abrir outra.

## Quando a Ciarem perde o acesso à caixa de correio

Se a senha da caixa de correio mudar, alguém remover o acesso da Ciarem ou seu administrador bloquear o app, a Ciarem não consegue mais ler nem enviar pela caixa de correio. A caixa de correio então deixa de aparecer na tabela **Caixas de correio conectadas** da página de E-mail, e seus administradores recebem um e-mail avisando. Os e-mails novos param de chegar à Caixa de entrada, e as respostas enviadas pela Ciarem falham com o erro "Esta caixa de correio não está mais conectada".

Para resolver, vá até a página de E-mail, clique em **Adicionar caixa de correio** e entre de novo na mesma caixa. Suas conversas anteriores continuam na Caixa de entrada.

## Ainda não disponível

* Enviar **mensagens de voz** pela Caixa de entrada no e-mail.
* **Reações** e **respostas com citação** nos e-mails.
* **Marcar e-mails como lidos** na sua caixa de correio: os e-mails que a Ciarem recebe continuam não lidos no Gmail ou no Outlook.
* **Importar e-mails antigos** recebidos antes de conectar a caixa de correio.
* Caixas de correio de provedores que não sejam Google e Microsoft.

Para enviar um mesmo e-mail para muitos contatos, veja [Campanhas de e-mail](https://help.ciarem.ai/pt/channels/email-campaigns.md).

## Solução de problemas

> [accordion] O endereço que digitei é recusado
>
> A conta com a qual você entrou não pode usar esse endereço:
>
> * **Google:** o endereço precisa ser um alias da conta com a qual você entrou, verificado no Gmail em **Configurações**, **Contas**, **Enviar e-mail como**. Adicione-o lá e conecte de novo.
> * **Microsoft 365:** a conta com a qual você entrou precisa conseguir abrir essa caixa de correio compartilhada. Peça acesso ao administrador do Microsoft 365 da sua empresa e conecte de novo.

> [accordion] Outra organização já conectou esta caixa de correio
>
> Uma caixa de correio só pode ser conectada a uma organização da Ciarem. Se ela for sua, escreva para [support@ciarem.ai](mailto:support@ciarem.ai).

> [accordion] Pede para entrar de novo e aprovar o acesso
>
> A Ciarem não recebeu um acesso duradouro à caixa de correio, ou algumas permissões não foram aprovadas. Clique de novo em **Continuar com o Google** ou **Continuar com a Microsoft** e permita tudo na tela de consentimento.

> [accordion] A Microsoft diz que preciso da aprovação de um administrador
>
> Algumas organizações do Microsoft 365 só permitem que um administrador aprove apps novos. Peça ao administrador do Microsoft 365 da sua empresa para aprovar a Ciarem e conecte de novo.

> [accordion] Nenhum e-mail chega à Caixa de entrada
>
> Confira se a caixa de correio ainda aparece na página de E-mail: se ela sumiu, a Ciarem perdeu o acesso, então clique em **Adicionar caixa de correio** e conecte de novo. Se você conectou um alias do Google, só chegam os e-mails enviados para esse alias. Depois envie um e-mail de teste para o endereço a partir de outra conta e espere um minuto.

> [accordion] Respondi pelo Outlook ou pelo Gmail, mas a IA continuou respondendo
>
> Sua resposta não chegou à pasta de **Enviados** da caixa de correio conectada, então a Ciarem não a viu. Com um **alias do Google**, envie a resposta como o alias (escolha-o no campo **De** do Gmail), não pelo endereço próprio da conta. Com uma **caixa de correio compartilhada do Microsoft 365**, peça ao administrador do Microsoft 365 que ative **Copiar itens enviados como esta caixa de correio** e **Copiar itens enviados em nome desta caixa de correio** na caixa compartilhada. Enquanto isso, assuma a conversa pela Caixa de entrada da Ciarem. Veja [Responder pelo Gmail ou pelo Outlook](#responder-pelo-gmail-ou-pelo-outlook).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.