Com corpo: você manda subject, from e html ou text.
Com template: você manda templateId e as variables. O assunto e o remetente vêm do
template.
Misturar as duas é recusado — mandar templateId junto de subject é ambíguo, e adivinhar qual
vence produziria uma mensagem que ninguém pediu.
Os campos aparecem como opcionais no esquema da referência porque a exigência é entre eles,
não de cada um. subject e from são obrigatórios quando não há template.
Cada destinatário conta
Uma chamada para três pessoas consome três da sua cota. to, cc e bcc somam, no máximo 50
por mensagem.
Mande text junto do html. Mensagem só em HTML pontua pior em filtro, e há quem leia em
cliente que não renderiza HTML. É a diferença mais barata que existe entre caixa de entrada e
spam.
Marketing é outra classe
type: 'MARKETING' sai por um pool de IPs separado do transacional. A separação existe para que
uma campanha ruim não derrube a entrega da redefinição de senha de ninguém — as duas reputações
são medidas em separado justamente porque uma não pode contaminar a outra.
Marketing exige um destinatário por mensagem: o link de descadastro é cabeçalho da mensagem,
então uma cópia para cinquenta levaria o mesmo link e quarenta e nove botões descadastrariam um
estranho.
O que a resposta significa
A resposta volta antes de a mensagem sair — ela entra na fila. Para saber se chegou, use
webhooks ou consulte a mensagem depois: ela traz a linha do tempo dos eventos de
entrega.