Enviar e personalizar e-mails transacionais

Cada chamada à API transacional inclui o HTML completo do e-mail diretamente no corpo do pedido. Isto dá-lhe controlo total sobre o conteúdo e estrutura de cada mensagem que a sua aplicação envia.

Como funciona

Passa o HTML (e opcionalmente texto simples) diretamente no corpo do pedido da API. A sua aplicação constrói o conteúdo do e-mail dinamicamente e inclui-o em cada pedido.

Personalização

A personalização permite-lhe inserir valores dinâmicos no e-mail — o nome próprio do destinatário, um número de encomenda, um nome de produto, um preço. Define marcadores no HTML e passa os valores correspondentes na chamada à API.

A sintaxe exata dos marcadores e os parâmetros da API para passar valores de variáveis estão documentados na documentação da API de E-mail do Flexmail em email-api.flexmail.eu/documentation, nas secções de Personalização.

Variáveis de personalização comuns

As variáveis típicas usadas em e-mails transacionais incluem:

• Nome do destinatário (nome próprio, nome completo)
• Número de encomenda ou referência
• Nomes de produtos e quantidades
• Preços e totais
• Datas e prazos
• Ligações de confirmação ou redefinição
• URLs ou códigos específicos da conta

Testar a personalização

Antes de entrar em produção, teste o e-mail com valores de variáveis realistas para garantir que todos os marcadores são resolvidos corretamente. A documentação da API inclui orientação sobre o envio de mensagens de teste com valores de variáveis personalizados.

Verifique em particular que:

• Todos os marcadores são substituídos — nenhuma sintaxe de variável em bruto aparece no e-mail entregue.
• Os valores de substituição são apresentados corretamente quando uma variável opcional não é passada.
• As ligações resolvem para os URLs corretos após a substituição de variáveis.

Importante

Se uma variável obrigatória estiver em falta na chamada à API e nenhuma substituição for definida, o marcador pode aparecer literalmente no e-mail entregue. Teste sempre com o mesmo conjunto de variáveis que a aplicação enviará em produção.

Próximos passos

• Consulte "Começar com a API transacional" para configuração da conta e primeiro envio.
• Reveja a secção Modelos na documentação da API em email-api.flexmail.eu/documentation para a referência completa de parâmetros.
• Consulte "Webhooks transacionais" para rastrear a entrega e o envolvimento dos envios baseados em modelos.