Como ligar o Zapier à Vozea

Qualquer checkout que o Zapier conheça vira pedido de depoimento: no Zap, depois da venda, uma ação Webhooks by Zapier 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 Zap que já dispara quando a venda acontece (o app da sua plataforma como gatilho).
• Plano do Zapier com Webhooks by Zapier (Professional, Team ou Enterprise — não existe no plano gratuito).
• 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 Zapier, adicione a ação

   No editor do Zap, clique no + para adicionar uma ação. Procure e escolha Webhooks by Zapier. No menu Event, escolha POST.

3. 3

   Preencha a ação

   URL: a URL copiada da Vozea. Payload Type: JSON. Em Data, adicione um item por campo — nome, email, telefone, produto, valor, data, id — e mapeie cada um com o campo correspondente do gatilho. Se você preencheu um Segredo na Vozea, em Headers adicione X-Vozea-Secret com o valor do segredo.

   Atenção: Deixe Data preenchido: se ficar vazio, o Zapier manda todos os campos do passo anterior, e a Vozea pode não achar nome e contato.

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. Clique em Test step na ação.
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 em Data.

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:

• Zapier — Send webhooks in Zaps

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