Pular para o conteúdo principal
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.
Encaminhar e-mails para o AirysChat requer um armazenamento em nuvem configurado

​
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.

​
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.