E-mail transacional: o que é e como implementar via API

Confirmação de pedido, redefinição de senha, recibo de pagamento: são e-mails que o cliente espera receber na hora, não numa janela de disparo em massa. Esse é o e-mail transacional — e ele precisa de uma infraestrutura diferente da campanha de marketing. Este guia explica a diferença, mostra exemplos e como disparar via API.

O que é e-mail transacional

E-mail transacional é a mensagem individual disparada por um evento do seu sistema — um pedido criado, uma senha redefinida, um pagamento confirmado — para um único destinatário, no momento em que o evento acontece. Ele não depende de uma lista nem de um agendamento: o gatilho é a ação do próprio usuário.

E-mail transacional x e-mail em massa

Exemplos de e-mail transacional

• Confirmação de pedido ou de assinatura.
• Redefinição de senha e alertas de segurança de conta.
• Recibo ou comprovante de pagamento.
• Lembrete de fatura vencendo, quando enviado a um único cliente (na régua de cobrança, ver o guia de cobrança automática).
• Confirmação de agendamento.
• Aviso de que uma exportação de dados (DSAR) ficou pronta para download.

Como funciona o envio via API

No three-pulse, um e-mail transacional é um único chamado a POST /api/v1/messages:send — uma "campanha de um": mesmo pipeline de entrega da campanha em massa, sem precisar montar audiência nem agendar nada. A chamada leva um name (identifica o envio na lista de campanhas), o template_id, o to_email do destinatário e um objeto attributes com as variáveis do evento (nome, número do pedido, valor), que substituem os placeholders do template no momento do envio.

Diferente da campanha em massa, o envio transacional entra numa fila dedicada e prioritária, separada da fila de disparo em lote — assim, uma campanha de milhões de contatos disparada por outro cliente não atrasa a confirmação de pedido de ninguém.

Quanto custa enviar e-mail transacional

O envio transacional consome o mesmo saldo de créditos pré-pagos da campanha em massa, ao mesmo preço por canal — não existe tarifa separada por usar a API em vez da interface de campanhas.

Recargas a partir de 1.000 créditos (R$ 49,90), sem preço por usuário e sem validade de crédito.

Boas práticas de entrega para e-mail transacional

• Dispare no momento do evento, não em lote horas depois — o valor do e-mail transacional é a proximidade com a ação do usuário.
• Use o campo message_type para rotular o tipo de mensagem (ex.: "pedido-confirmado", "senha-redefinida") e identificar cada fluxo nos relatórios.
• Teste o template com dados reais de attributes antes de ligar o gatilho em produção — um placeholder sem valor chega em branco para o cliente.
• Trate falhas permanentes (endereço inválido) no seu sistema: não insista em reenviar para o mesmo endereço com erro definitivo.

Base legal do e-mail transacional e LGPD

E-mail transacional normalmente se apoia em execução de contrato ou cumprimento de obrigação legal, não em consentimento de marketing — são bases legais diferentes das campanhas promocionais (veja o guia de LGPD em marketing multicanal para o comparativo completo). Isso não dispensa boas práticas: identifique claramente o remetente e mantenha a lista de contatos transacionais separada da lista de marketing. Consulte seu jurídico para o enquadramento do seu caso.

Como implementar em 5 passos

1. Crie um template com as variáveis do evento (nome, número do pedido, valor, link).
2. Gere uma chave de API do workspace.
3. No seu backend, chame POST /api/v1/messages:send no momento do evento, com name, template_id, to_email e attributes preenchidos com os dados reais.
4. Rotule o disparo com message_type para separar os fluxos nos relatórios.
5. Consulte GET /api/v1/campaigns/{id} com o ID retornado: a resposta traz counts com o total por status (queued, sent, delivered, failed, suppressed, skipped) — para um envio único, o status aparece com contagem 1.

Perguntas frequentes