Modelos de e-mail transaccional com variáveis: escrever uma vez, preencher com os dados de cada cliente

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

VEJA TAMBÉM

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

E-mails de recuperação de senha, encomenda e factura: o que deve dizer uma boa mensagem, com exemplos

Anexar facturas e bilhetes a um e-mail transaccional: base64, limite de tamanho e ficheiros recusados

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

Fazer um e-mail em HTML que se vê bem em todo o lado: largura, imagens e modo escuro

Enviar e-mails transaccionais em lote: um pedido, muitas mensagens e o resultado de cada uma

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

Categorias

Categorias