A maioria dos remetentes de e-mail transacional só renderiza HTML simples. POST /api/v1/send no modo modelo, em vez disso, renderiza um dos seus próprios projetos do estúdio, com o motor de fallback completo e os blocos interativos incluídos. Um recibo ou confirmação disparado pelo seu backend pode trazer um bloco Avaliação ou um upsell de Produto exatamente como um envio de marketing traria.
Um recibo é um dos e-mails com a maior taxa de abertura que uma empresa envia — e quase sempre o mais simples, porque geralmente é gerado pela biblioteca transacional mais fácil de conectar, não por algo com um sistema de design anexado.
Desenhe uma vez, dispare do seu backend
Construa o recibo ou confirmação como um projeto comum do estúdio, com os blocos que fizerem sentido — uma Avaliação para CSAT pós-compra, um upsell de Produto de item relacionado. Seu backend então chama a Send API no modo modelo com o ID do projeto e um objeto mergeData no lugar dos valores dinâmicos daquele pedido específico.
Marque como transacional, corretamente
Definir type como "transactional" ignora a supressão por cancelamento de inscrição — um recibo ainda precisa chegar a alguém que cancelou a inscrição de marketing — mas nunca ignora a supressão por bounce, já que um endereço genuinamente inválido não deveria continuar recebendo envios independentemente do tipo de e-mail.
É autenticado como qualquer integração de API
Uma chave de API nomeada por proprietário, autenticada por Bearer, é criada e revogada na seção Desenvolvedores do painel. Um cabeçalho Idempotency-Key evita que uma requisição repetida envie o recibo duas vezes.
O que não é transportado
O modo formato livre (sem projectId, só html/text bruto) pula o pipeline de renderização por completo — sem tags de personalização, sem motor de fallback, enviado exatamente como fornecido. É a escolha certa para algo como um código OTP avulso; o modo modelo é o que vale a pena usar assim que o próprio e-mail se beneficia de um bloco interativo.
Começando
Construa o modelo transacional como um projeto do estúdio com os blocos interativos que você quiser, crie uma chave de API em Desenvolvedores, e chame POST /api/v1/send no modo modelo com o seu mergeData e type: "transactional".