Como ligar o n8n à Vozea

Qualquer checkout que o n8n conheça vira pedido de depoimento: no fluxo, depois da venda, um nó HTTP Request manda os dados do cliente para a URL da Vozea.

Leva uns 10 minutos · conferido na documentação oficial em 17/9/2026

O que você precisa

• Sua conta na Vozea, em Coletar › Vendas.
• Um fluxo no n8n que já dispara quando a venda acontece (o nó da sua plataforma, ou um nó Webhook que ela chama).
• O JSON de exemplo abaixo, para mapear os campos.

Passo a passo

1. 1

   Na Vozea, crie a conexão

   Em Coletar › Vendas, clique em Ligar em Outro checkout. O Segredo é opcional. Clique em Criar conexão e, no cartão, em Copiar para copiar a URL do webhook.

2. 2

   No n8n, adicione o nó HTTP Request

   No seu fluxo, depois do nó que representa a venda aprovada, adicione o nó HTTP Request.

3. 3

   Preencha o nó

   Method: POST. URL: a URL copiada da Vozea. Ligue Send Body; em Body Content Type escolha JSON; em Specify Body escolha Using JSON e cole o JSON mapeando os campos da venda (ou Using Fields Below e adicione os pares nome/valor com Add Parameter). Se você preencheu um Segredo na Vozea, ligue Send Headers e adicione X-Vozea-Secret com o valor do segredo.

   Atenção: No JSON, mande nome, email, telefone, produto, valor, data e id (o id do pedido, para a Vozea não agendar duas vezes). Em português ou em inglês; cliente e produto podem vir aninhados (customer, product). Exemplo:

Exemplo do JSON que a Vozea entende

{
  "nome": "Maria Souza",
  "email": "maria@exemplo.com",
  "telefone": "11999990000",
  "produto": "Curso de bolos",
  "valor": 149.9,
  "data": "2026-09-15",
  "id": "pedido-123"
}

Como testar

1. Execute o nó (Execute step) com uma venda de teste vinda do nó anterior.
2. Na Vozea, em Coletar › Vendas › Últimas vendas, a chamada aparece em segundos com o resultado. Se o nome ou o contato vierem vazios, ajuste o mapeamento.

Depois de ligar

• Se a sua ferramenta souber do reembolso, chargeback ou cancelamento, uma ação HTTP DELETE em https://vozea.io/api/v1/requests/{id} (cabeçalho Authorization: Bearer com uma chave de Configurações › API, e o id devolvido quando o pedido foi criado) cancela o pedido pendente — assim ninguém que devolveu recebe pedido de depoimento. Se o evento vier duas vezes, chamar de novo é seguro — devolve 200. A receita completa está no manual Meu sistema.
• Cada venda aparece em Coletar › Vendas › Últimas vendas em segundos, com o que a Vozea fez com ela: pedido agendado (e para quando), já estava na fila, evento ignorado, produto fora do filtro, venda desfeita.
• O pedido de depoimento sai 7 dias depois da compra (você muda em Gerenciar: outro prazo, ou o fim da garantia na Hotmart). Quem responde não recebe mais nada; quem não responde recebe até dois lembretes.
• Reembolso, chargeback e assinatura cancelada param o pedido pendente sozinhos — desde que esses eventos estejam marcados no webhook.
• Por e-mail o pedido sai sozinho a partir do plano Essencial. Por WhatsApp a Vozea monta a mensagem e o pedido entra na lista do dia em Coletar, para você mandar com um toque.
• Sem segredo, a própria URL é a proteção (ela é longa e só existe na sua conta). Se você preencher um Segredo na Vozea, mande-o no cabeçalho X-Vozea-Secret em toda chamada.

Problemas comuns

"Sem nome ou contato no JSON"

A chamada chegou sem nome, ou sem e-mail e telefone. Confira o mapeamento: nome (ou name), email, telefone (ou phone). Sem um contato utilizável, a Vozea não tem para quem pedir.

"Assinatura não confere"

Você preencheu um Segredo na Vozea e a chamada veio sem o cabeçalho X-Vozea-Secret (ou com outro valor). Mande o cabeçalho, ou apague o Segredo em Gerenciar.

"Só e-mail — sai sozinho no Essencial"

A venda veio só com e-mail e a conta está no Grátis: o pedido por e-mail automático é do plano Essencial. Vendas com telefone entram na lista do dia para você mandar pelo WhatsApp.

"Já estava na fila"

A mesma venda chegou duas vezes, ou o mesmo cliente comprou o mesmo produto enquanto o pedido anterior ainda estava aberto. A Vozea não pede duas vezes.

{
  "id": "evt_5f9k2m4x9p7q",
  "type": "testimonial.received",
  "version": 1,
  "created_at": "2026-09-16T18:00:00.000Z",
  "company": {
    "id": "c_a1b2c3d4e5",
    "name": "Átria",
    "slug": "atria",
    "country": "BR",
    "language": "pt-BR"
  },
  "testimonial": {
    "id": "t_8k2m4x9p7q",
    "author": {
      "name": "Maria Souza",
      "meta": "cliente desde 2024",
      "photo_url": null
    },
    "text": "Atendimento excelente, resolveram tudo no mesmo dia.",
    "rating": 5,
    "kind": "text",
    "status": "approved",
    "origin": {
      "kind": "collected",
      "platform": null
    },
    "channel": "vozea",
    "tags": [
      "loja"
    ],
    "captured": {
      "url": null,
      "title": null,
      "at": null
    },
    "authored_at": null,
    "created_at": "2026-09-16T18:00:00.000Z",
    "approved_at": "2026-09-16T18:00:05.000Z",
    "urls": {
      "app": "https://vozea.io/app/tratar?q=t_8k2m4x9p7q",
      "public_page": "https://vozea.io/atria",
      "source": null
    }
  }
}

Fontes

Os nomes de menus, botões e campos deste manual foram conferidos em:

• n8n Docs — HTTP Request node

Ficou com dúvida? Escreva para contato@vozea.io.