Testar o e-mail transaccional sem enviar: chaves Sandbox, modo de teste e devoluções simuladas

E-mail·· 7 visualizações· 3 min de leitura

A resposta curta: com uma chave que começa por sandbox_, nada se envia nem se cobra. O e-mail fica simulated, com eventos simulados, e as outras alterações (domínios, modelos, bloqueados) também só se simulam. Para ensaiar devoluções e queixas, envie para bounce@example.com ou complaint@example.com.

Sandbox e Produção

Chave sandbox_ Chave prod_
Endereço e operações Os mesmos Os mesmos
O e-mail É validado, mas não sai É enviado
Créditos Não são cobrados Um por destinatário
Estado simulated O estado real
Domínios, modelos, bloqueados Só se simulam: nada fica gravado Ficam gravados

Ensaiar o que corre mal

Envie para O que acontece
bounce@example.com Simula uma devolução: vê o evento bounced e o webhook email.bounced
complaint@example.com Simula uma queixa: vê o evento complained e o webhook email.complained

É a melhor maneira de confirmar que o seu sistema reage bem: marca o endereço como inválido, avisa o cliente, não tenta outra vez.

O modo de teste do Email Center

Há outro caso de simulação: enquanto o Email Center estiver em modo de teste, também as chaves prod_ simulam. Para saber, chame GET /v1/email/balance e veja o campo test_mode: true quer dizer que ainda nada sai a sério.

Uma lista para antes de ir a sério

1 Envio simples com text e com html: resposta 201 e estado simulated.
2 Com modelo: todas as variáveis preenchidas.
3 Com anexo: o PDF real que vai enviar, para ver se passa no tamanho.
4 Repetição com a mesma Idempotency-Key: o e-mail não se duplica.
5 Devolução e queixa com os dois endereços de ensaio, e o seu webhook a recebê-las.
6 Troque a chave por uma prod_. O endereço e as operações são os mesmos.
Em Sandbox o domínio não fica gravado. Antes do primeiro envio real, junte e verifique o domínio a sério, com a chave de Produção ou na página do Meu MozOut.
Use chaves diferentes no ambiente de testes e no servidor de produção. Assim, um teste esquecido nunca envia um e-mail a um cliente real.

Quer testar o envio de e-mails sem gastar créditos? Veja a página da API.

Ver a página da API

VEJA TAMBÉM

Começar no Email Center: activar, verificar o domínio e enviar o primeiro e-mail

Enviar um e-mail transaccional pela API: os campos do POST /v1/email/messages

Webhooks do Email Center: receber no seu sistema os eventos de entrega, devolução e queixa

Estados do e-mail transaccional: sent, delivered, bounced, complained e failed explicados

Erros da API do Email Center: email_account_required, all_recipients_suppressed e outros motivos

Uma chave de API ou um token ficou exposto: o que fazer, pela ordem certa

PRODUTO RECOMENDADO

E-mail profissional no seu domínio

Caixas com o nome da sua empresa, sem publicidade, com filtro de spam. desde 396,00 MT/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.