Enviar
Modo de teste
Cinco apelidos de destinatário que forçam um desfecho específico. Funcionam sem domínio verificado e não gastam a sua reputação de envio.
O problema que isso resolve
Para testar o seu tratamento de devolução, o caminho óbvio é mandar um e-mail para um endereço que não existe. Isso funciona uma vez e cobra caro: devolução de verdade conta contra a sua reputação no provedor, e é exatamente o número que você não quer sujar aprendendo a usar a ferramenta.
Os apelidos abaixo produzem o desfecho sem esse custo. A tradução acontece dentro da API, antes de a mensagem chegar ao provedor.
Os apelidos
Todos usam o domínio teste.jetsend.com.br. Ele não precisa existir no DNS e nenhuma mensagem sai para ele.
| Destinatário | Desfecho | O que você exercita |
|---|---|---|
entregue@teste.jetsend.com.br | Entrega normal | O caminho feliz, o evento de entrega e o webhook |
devolvido@teste.jetsend.com.br | Devolução permanente | Seu tratamento de endereço inválido |
reclamado@teste.jetsend.com.br | Marcado como spam | A baixa imediata da pessoa da sua lista |
suprimido@teste.jetsend.com.br | Já está na lista de supressão | O envio recusado antes de sair |
ausente@teste.jetsend.com.br | Resposta automática de ausência | Seu tratamento de resposta que não é humana |
Exemplo
curl -X POST https://api.jetsend.com.br/v1/messages \ -H "Authorization: Bearer $JETSEND_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "no-reply@suaempresa.com.br", "to": "devolvido@teste.jetsend.com.br", "subject": "Testando devolução", "html": "<p>Este envio vai devolver de propósito.</p>" }'A mensagem entra no seu log de envios como qualquer outra, com o id, o assunto e a linha do tempo de eventos. A diferença é só o desfecho, que é escolhido por você em vez de sorteado pela realidade.
Etiquetando o teste
O + é ignorado na hora de decidir o desfecho, então dá para marcar de qual teste veio cada envio sem mudar o resultado:
"to": "devolvido+pedido-42@teste.jetsend.com.br"Continua sendo uma devolução, e a etiqueta chega ao log para você separar as suas rodadas.
Dois limites que não são acidente
Ou todos os destinatários são de teste, ou nenhum. Um envio com to de teste e um bcc para um endereço real é recusado. Sem essa regra, o modo de teste viraria um jeito de driblar a exigência de domínio verificado e mandar e-mail para quem você quisesse.
O domínio é exato. Só teste.jetsend.com.br traduz. Subdomínio parecido ou domínio que termina igual não conta, pelo mesmo motivo.
Quando usar chave sm_test_
Os apelidos funcionam com qualquer chave. A chave sm_test_ é uma escolha separada, e serve para você não confundir ambiente: ver Autenticação.