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

# Encaminhando E-mails para o AirysChat

> Guia para configurar o encaminhamento de e-mails para o AirysChat

Este guia explica como configurar o encaminhamento de e-mail para o AirysChat quando você prefere não configurar o IMAP. O encaminhamento permite que seu provedor de e-mail envie mensagens de entrada diretamente para o AirysChat, que então as processa como conversas recebidas em sua caixa de entrada.

<Note>
  Encaminhar e-mails para o AirysChat requer um [armazenamento em nuvem configurado](/self-hosted/deployment/storage/supported-providers)
</Note>

## Quando Usar o Encaminhamento

O encaminhamento é uma boa opção se:

* Você não quer usar IMAP ou seu provedor não permite acesso IMAP.
* Você quer uma maneira simples, baseada em push, de entregar e-mails de entrada para o AirysChat.
* Seu provedor suporta regras de roteamento ou encaminhamento (Gmail, Google Workspace, Outlook, Fastmail, Zoho, servidores personalizados, etc.).
* Você já usa SMTP para e-mails de saída e precisa apenas de uma configuração leve de entrada.

## Como o Encaminhamento Funciona no AirysChat

A cada caixa de entrada de e-mail no AirysChat é atribuído um endereço de ingresso — um endereço de e-mail exclusivo gerado pelo sistema. Quando seu provedor encaminha um e-mail para esse endereço, o AirysChat o recebe. Nota: Para instalações usando um provedor de ingresso (SES, SendGrid, Mailgun, etc.), você deve configurar um registro MX apontando para o provedor de ingresso para que o e-mail de entrada seja aceito e roteado corretamente.

1. O provedor de ingresso recebe o e-mail e o encaminha para a URL configurada do AirysChat.
2. O AirysChat analisa o conteúdo, anexos, cabeçalhos e referências de thread.
3. Cria ou atualiza a conversa na caixa de entrada apropriada.
4. Lida com as threads de mensagens corretamente através de `Message-ID`, `References` e `In-Reply-To`.

O e-mail de saída continua a usar seu provedor SMTP configurado.

## Requisitos

Para usar o encaminhamento com sucesso, certifique-se de que:

* **O ingresso de e-mail esteja ativado na sua instalação do AirysChat.** Algumas configurações auto-hospedadas desativam o ingresso por padrão por segurança.
* **Sua instalação suporta processamento de entrada** através do pipeline configurado de mailer/ingresso.
* **A regra de encaminhamento está configurada para encaminhar *todos* os e-mails relevantes**, incluindo respostas.
* **SPF, DKIM e DMARC** estão configurados corretamente em seu domínio para uma boa capacidade de entrega.

Se o ingresso estiver desativado, o AirysChat exibirá um aviso na interface do usuário. Seu administrador deve ativá-lo antes que o encaminhamento funcione.

O domínio receptor deve ser configurado na variável de ambiente `MAILER_INBOUND_EMAIL_DOMAIN`.

```
MAILER_INBOUND_EMAIL_DOMAIN=
```

## Encontrando o Endereço de Encaminhamento

No AirysChat:

1. Vá para as configurações da sua caixa de entrada.
2. Selecione as configurações do seu canal de e-mail -> Configuração
3. Copie o **endereço de e-mail de ingresso do AirysChat** fornecido.

Este endereço é único por caixa de entrada.

## Configurando o Encaminhamento no seu Provedor de E-mail

A configuração varia um pouco entre os provedores, mas os passos geralmente são:

1. Abra as configurações de encaminhamento ou roteamento do seu provedor de e-mail.
2. Adicione o e-mail de ingresso do AirysChat como um destino de encaminhamento.
3. Verifique o endereço se o provedor exigir confirmação.
4. Defina uma regra para encaminhar todos os e-mails recebidos (ou apenas as mensagens relevantes) para o endereço de ingresso.
5. Salve a configuração.

## Configurando o Provedor de Ingresso

Para instalações do AirysChat, é necessário um provedor de ingresso dedicado (Amazon SES, SendGrid, Mailgun, etc.). O provedor atua como o primeiro receptor do e-mail do seu domínio e, em seguida, o encaminha para a URL de ingresso do AirysChat.

Veja mais detalhes [aqui](./ingress-providers).

## Comportamento de E-mail de Saída

O encaminhamento afeta **apenas as mensagens de entrada**.
As mensagens de saída ainda serão enviadas usando:

* O provedor SMTP que você configurou para a caixa de entrada (recomendado), ou
* O provedor SMTP padrão configurado na instalação do AirysChat.

## Solução de Problemas

Problemas comuns:

### 1. Encaminhamento Não Habilitado no AirysChat

Se você vir: *“Support for forwarding emails is not configured. Contact your administrator.”* (O suporte para encaminhamento de e-mails não está configurado. Entre em contato com seu administrador.)
Sua instalação do AirysChat deve habilitar o ingresso de e-mail. A configuração `MAILER_INBOUND_EMAIL_DOMAIN` está ausente.

### 2. E-mails Não Aparecendo na Caixa de Entrada

Verifique:

* A regra de encaminhamento está habilitada e ativa.
* O provedor não está suprimindo ou classificando mensagens encaminhadas.
* Não há problemas de quarentena/rejeição de DMARC.
* O endereço de ingresso está correto.

### 3. Problemas de Threading

O AirysChat depende de cabeçalhos de mensagem para encadeamento. Certifique-se de que seu provedor encaminha os cabeçalhos intactos.