A resposta curta: um modelo guarda o assunto e o texto (em HTML, em texto ou nos dois) com variáveis como {{nome}}. No envio, o seu sistema só indica o template_id e os valores em variables. Muda a redacção no modelo e o código fica igual.
Criar um modelo
| 1 |
Na página E-mail transaccional do My MozOut, abra Modelos e crie um, ou use POST /v1/email/templates.
|
|
| 2 |
Dê-lhe um nome até 100 caracteres, que não se repita na conta, como «Factura disponível».
|
|
| 3 |
Escreva o assunto e o conteúdo, com as variáveis entre chavetas duplas: Factura {{numero}} disponível.
|
|
| 4 |
Guarde. A página mostra o número do modelo na API: é esse o template_id. A resposta da API traz também a lista das variáveis que encontrou.
|
|
Enviar com o modelo
curl https://api.mozout.com/v1/email/messages \
-H "Authorization: Bearer sandbox_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: fatura-2026-214" \
-d '{"from": "A Sua Empresa <facturas@yourcompany.com>",
"to": ["ana@example.com"],
"template_id": 12,
"variables": {"nome": "Ana", "numero": "FT 2026/214",
"valor": "1.250,00", "data": "30/11/2026"}}'
O assunto, o html e o text que não enviar vêm do modelo. Se enviar algum deles, vale o que enviou nesse e-mail.
Cuidados com as variáveis
| Regra |
Porquê |
| No HTML, os valores entram escapados |
Um nome com < ou & aparece como texto e não estraga o e-mail nem abre portas a código estranho. |
| variables é um objecto de nome e valor |
Uma lista ou um texto solto dá erro de validação. |
| Use os mesmos nomes no modelo e no envio |
Uma variável sem valor fica por preencher. Confira com um envio em Sandbox. |
| Não ponha dados sensíveis no texto do modelo |
Uma senha ou um número de cartão completo nunca vão por e-mail. |
Mudar ou apagar
Com PATCH /v1/email/templates/{id} só mudam os campos que enviar, por exemplo só o assunto. DELETE /v1/email/templates/{id} apaga-o. Se a conta já tiver o máximo de modelos, apague um que não use antes de criar outro.
|
Um modelo por situação, e não um modelo para tudo: «Factura disponível», «Recuperar a senha», «Encomenda enviada». Ideias de texto para cada um em o que deve dizer uma boa mensagem.
|
|
Quer automatizar as suas facturas e confirmações com modelos? Veja a página da API.
Ver a página da API
|
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 |
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
