Antes de conectar uma caixa de entrada: checklist de e-mail recebido para aplicações autoalojadas

Comece por definir a finalidade da caixa de entrada

«Ligar o e-mail» pode significar criar uma conversa de suporte a partir de uma mensagem recebida, associar correspondência a um registo de cliente ou permitir que a equipa responda a partir da aplicação. Defina o fluxo de trabalho pretendido antes de escolher uma caixa de correio ou alterar as respetivas definições.

Trate a receção ou importação de mensagens e o envio de e-mail como requisitos distintos a verificar na documentação da aplicação. Identifique também que mensagens pretende incluir, que ação a aplicação deve executar e quem precisa de aceder aos registos resultantes.

• Que processo empresarial deve a aplicação apoiar?
• Que mensagens devem ser incluídas e que regra documentada determina essa seleção?
• A equipa precisa de responder a partir da aplicação? Confirme se essa capacidade está documentada.

Confirme o método de entrega documentado

Consulte a documentação da aplicação exata e da respetiva implementação autoalojada antes de escolher um método. Confirme os métodos descritos, os pré-requisitos e onde a configuração deve ser aplicada.

Como exemplo específico, o [guia de receção de e-mails do Chatwoot para instalações autoalojadas](https://developers.chatwoot.com/self-hosted/configuration/features/email-channel/ingress-providers) descreve a escolha e configuração de um fornecedor de receção de e-mails, a definição das variáveis de ambiente necessárias e a utilização de fornecedores como Mailgun ou SendGrid. Este exemplo não determina o que outras aplicações suportam nem como devem ser configuradas.

SMTP é o protocolo que os servidores de e-mail utilizam para comunicar entre si e transferir mensagens. Essa descrição geral não explica como uma aplicação específica consulta ou importa mensagens de uma caixa de entrada. Verifique separadamente a configuração documentada de e-mail recebido da aplicação.

• A documentação aplica-se à sua aplicação e implementação autoalojada?
• Que método, serviços externos e valores de configuração são especificados?
• Se a documentação não esclarecer o seu caso, consulte o responsável pela manutenção da aplicação.

Saiba o que implica o acesso e o tratamento das mensagens

Antes de conceder acesso, confirme com o responsável pela manutenção da aplicação e com o fornecedor da caixa de correio que conta, método de autenticação e permissões são necessários para a integração documentada. Não presuma um método de início de sessão nem um âmbito de permissões específico.

Verifique o que a documentação diz sobre o tratamento do corpo da mensagem, dos dados do remetente e do destinatário, dos cabeçalhos, dos anexos e de outros metadados. Se não encontrar essa informação, registe-a como uma questão em aberto, em vez de deduzir o comportamento pelo facto de uma mensagem aparecer na aplicação.

• Que conta e permissões exige a integração documentada?
• Que conteúdo da mensagem e anexos são tratados, e onde está esse comportamento documentado?
• Quem está autorizado a aceder aos registos resultantes?

Planeie a responsabilidade, as falhas e a recuperação

Confirme como a equipa pode investigar problemas na integração e que opções estão realmente documentadas, como registos, alertas ou uma vista de estado. Pergunte também ao responsável pela manutenção o que se sabe sobre mensagens duplicadas, atrasadas ou não processadas e que passos de recuperação estão descritos.

Defina quem investigará os problemas e como a responsabilidade e o acesso serão transferidos ou revistos quando necessário. Registe as instruções disponíveis num local acessível aos administradores autorizados, sem incluir palavras-passe, tokens ou outros segredos.

• Quem é responsável pela operação e quem é o contacto de substituição?
• Onde pode um administrador investigar uma falha, se essa opção estiver documentada?
• Que passos de recuperação estão descritos e como será transferida a responsabilidade?

Faça um teste controlado e registe a decisão

Antes de ligar uma caixa de entrada de produção, pergunte ao responsável pela manutenção se existe uma configuração de teste e siga as instruções documentadas. Use mensagens adequadas para verificar o comportamento relevante sem expor dados empresariais desnecessários.

Confirme se aparece a ação ou o registo pretendido e se o tratamento observado corresponde ao que a documentação descreve. Se o resultado diferir do esperado ou deixar uma questão importante por responder, suspenda a utilização em produção e consulte o responsável pela manutenção ou o fornecedor da caixa de correio.

Registe o método utilizado, as respostas recebidas, as questões por resolver, os responsáveis e os passos de recuperação, sem guardar segredos.

• Que configuração de teste controlado recomenda a documentação, se alguma?
• O resultado esperado aparece e o tratamento observado corresponde ao que está documentado?
• Que questões continuam por resolver antes da utilização em produção?