E-mails transacionais interativos pela Send API

Recibos e confirmações são os e-mails que os clientes mais abrem. Crie uma vez no estúdio, envie do seu backend pela Send API, e cada recibo pode perguntar como foi o pedido e oferecer o próximo produto.

Assunto

Your order receipt

Recibos e confirmações são os e-mails que os clientes mais abrem. Envie do seu backend pela Send API, com os mesmos blocos interativos das suas campanhas, e cada recibo pode perguntar como foi o pedido e oferecer o próximo produto.

Um recibo chega a quase todos os clientes logo depois da compra. Isso faz dele o melhor lugar para uma nota rápida, uma reposição ou um código para a próxima vez, desde que seja tão fácil de enviar quanto um recibo simples.

Crie uma vez, envie do seu backend

Monte o recibo como um e-mail normal no estúdio, com tags como {{order_number}} e os blocos que quiser:

  • Nota: "Como foi o seu pedido?" com estrelas ou rostos emoji. Com Fazer uma pergunta de acompanhamento quando a nota for no máximo, uma nota baixa abre uma pergunta curta sobre o que deu errado.
  • Produto: um item relacionado ou uma reposição, comprado no recibo com Comprar agora.
  • Cupom: um código para o próximo pedido, copiado com um toque.
  • Botão: status do pedido, nota fiscal ou suporte.

Depois seu backend chama POST /api/v1/send com o projectId do e-mail e um objeto mergeData com os valores daquele pedido, até 100 campos. Veja Modelo na referência da API.

Cada cliente pode dar nota, comprar e clicar no recibo, em qualquer app que use para lê-lo.

Vinculado aos seus contatos

Quando o cliente já é um dos seus contatos, o recibo fica vinculado a ele: passe um listId, ou deixe o MailInApp encontrar o endereço nas suas listas. A nota dele vai então para a atividade e a pontuação de engajamento dele, pode preencher um campo do contato e começar uma jornada, e um agendamento de reunião é feito com um clique. Veja a referência da API.

Feito para produção

  • type: "transactional", o padrão, alcança clientes que cancelaram a inscrição do marketing, porque eles ainda precisam do recibo. Endereços que retornaram são pulados. Veja Transacional vs. marketing.
  • Idempotency-Key: uma chamada repetida com a mesma chave devolve o primeiro resultado, então cada cliente recebe um recibo só. Veja Idempotência.
  • Limites: cada chave de API tem um limite por minuto, e seu plano inclui um número mensal de chamadas à Send API. As chamadas recentes ficam listadas na página Desenvolvedores.
  • Sem código: a ação Send Transactional Email do Zapier e o nó do n8n enviam do mesmo jeito.
  • Um código de uso único: envie html ou text no lugar de um projectId, e a mensagem sai exatamente como está.

O que volta para você

Notas, cliques e compras aparecem nos Insights do e-mail como em qualquer campanha, e seu webhook envia cada um para os seus sistemas assim que chega. Um alerta de nota baixa avisa quando um cliente dá uma nota ruim a um pedido, para alguém falar com ele no mesmo dia.

Primeiros passos

Monte o recibo no estúdio com uma Nota, crie uma chave de API em Desenvolvedores e chame POST /api/v1/send com seu projectId e mergeData. O início rápido mostra a primeira chamada.

Uma sequência típica de criação e envio

  1. 1

    Crie o recibo no estúdio

    Monte como um e-mail normal com uma Nota, um Produto ou um Cupom, e tags como {{order_number}}.

  2. 2

    Crie uma chave de API

    Crie uma chave de API com nome em Desenvolvedores. Cada chamada a envia como token Bearer.

  3. 3

    Chame a Send API

    Seu backend faz um POST para /api/v1/send com o projectId do e-mail e um objeto mergeData com os valores daquele pedido.

  4. 4

    Leia o que volta

    Notas, cliques e compras aparecem nos Insights do e-mail, e seu webhook envia cada um assim que chega.

Perguntas frequentes

Um e-mail enviado por API pode ter os mesmos blocos interativos de uma campanha?

Sim. O modo modelo gera o e-mail do estúdio que você indicar, com todos os blocos, exatamente como um envio pelo painel.

Como os dados do pedido entram no e-mail?

Pelo mergeData: um objeto simples de até 100 campos que preenche as tags {{field}} do e-mail naquela chamada. Passe também um listId e, se o cliente já for um contato, o e-mail fica vinculado a ele, então a nota dele vai para a atividade dele.

Qual a diferença entre transacional e marketing?

O campo type escolhe qual supressão é verificada. Transacional, o padrão, alcança clientes que cancelaram a inscrição do marketing, porque eles ainda precisam do recibo. Marketing se comporta como uma campanha. Os dois pulam endereços que retornaram.

Quais limites a Send API tem?

Cada chave de API tem um limite por minuto, seu plano inclui um número mensal de chamadas à Send API (500 no Free) e cada envio conta nos e-mails mensais do plano. Um cabeçalho Idempotency-Key faz uma chamada repetida devolver o primeiro resultado, então cada cliente recebe um recibo só.

Posso enviar meu próprio HTML pelo mesmo endpoint?

Sim. Envie html ou text no lugar de um projectId e a mensagem sai do jeito que está. Serve para um código de uso único; o modo modelo é o dos blocos interativos.

Construa isso no estúdio

Comece no plano gratuito — todos os blocos interativos e o motor de fallback completo estão incluídos em todos os planos.