Caixa de teste: homologar a integração sem enviar e-mail de verdade

3 min de leitura68
Copiar para a I.A.:

A Caixa de teste é onde chega o e-mail disparado com uma chave de homologação. A chamada é aceita por inteiro — remetente, anexos, lista de bloqueio, tudo conferido como em produção —, mas nada é entregue a ninguém e nada consome cota. É o lugar para o time que integra a loja virtual da Casa Moura Cafés testar o pedido-confirmado quantas vezes quiser sem um único cliente receber um pedido falso.

A aba fica em Configurações › Caixa de teste e é do Dono, como as chaves e os webhooks. Se ela não aparece para você, fale com o suporte.

Como as mensagens chegam aqui

Em Configurações › Integrações, crie uma chave com Chave de homologação marcada e use-a no ambiente de testes do sistema. Todo envio feito com ela aparece aqui em vez de sair. A chave de produção continua mandando de verdade — por isso a marca fica na chave, e não num detalhe da chamada: o ambiente de testes que só tem a chave de homologação não consegue enviar de verdade nem por engano.

Lembre que a chave de homologação não acessa contatos: ela só envia e lê campos e listas.

Conferir uma mensagem

A lista mostra Destinatário, Situação, Engajamento (aberturas e cliques simulados) e Recebida em. Clique numa linha para abrir a Mensagem de teste:

  • De, Para e Responder a — confira se o remetente é Renata da Casa Moura <contato@casamoura.com.br> e não o endereço de testes de alguém;
  • Anexos — nome, tipo e tamanho de cada arquivo, para conferir se chegou inteiro;
  • Prévia — o e-mail como o destinatário veria, com as variáveis do modelo já trocadas.

Simular um desfecho

Em Simular desfecho, cada botão faz "acontecer" na mensagem o que aconteceria em produção: Entregue, Aberto, Clicado, Devolvido, Marcado como spam, Descadastrado e os demais eventos que um webhook pode assinar. O evento é gravado e o webhook é entregue de verdade, no endereço que você cadastrou, igual à produção. É assim que se testa o receptor sem esperar uma devolução real acontecer com um cliente.

Três cuidados:

  • O evento simulado chega também ao webhook de produção, marcado como teste. O seu receptor de produção precisa ignorá-lo — senão uma devolução simulada descadastra um cliente de verdade no seu sistema.
  • Simular não bloqueia o endereço. Em produção, descadastro, devolução permanente e reclamação de spam bloqueariam o destinatário; aqui, não. Dá para testar a mesma devolução quantas vezes precisar.
  • Endereço que já estava bloqueado não tem desfecho a simular. Em produção a mensagem nunca sairia, e a tela avisa isso no lugar dos botões.

Por quanto tempo as mensagens ficam

As mensagens de teste são apagadas depois de um prazo de guarda. Abrir uma que já passou do prazo mostra Esta mensagem expirou. A caixa é ferramenta de trabalho, não arquivo: o que precisar guardar, guarde do seu lado.

Para onde ir depois

  • Chaves de API — criar a chave de homologação.
  • Webhooks — cadastrar o endereço que vai receber os eventos simulados e ver as entregas no histórico.

Resumindo: use uma chave de homologação no ambiente de testes, confira remetente, anexos e prévia de cada mensagem na Caixa de teste, simule os desfechos para ver o webhook chegar e trate os eventos marcados como teste no seu receptor de produção.

Este artigo foi útil?