Central de ajuda · Ligar vendas
Como ligar a Shopify à Vozea
Cada pedido pago na Shopify vira um pedido de depoimento na Vozea. A ligação é um webhook criado no admin da sua loja; a chave que assina os webhooks da loja vai colada na Vozea.
Leva uns 5 minutos · conferido na documentação oficial em 17/9/2026
O que você precisa
- Sua conta na Vozea, em Coletar › Vendas.
- Acesso ao admin da sua loja Shopify (permissão para mexer em Configurações).
- Duas abas abertas lado a lado: a Vozea e o admin da Shopify.
Passo a passo
Na Vozea, crie a conexão
Em Coletar › Vendas, clique em Ligar no cartão da Shopify. Deixe o Segredo em branco (a chave só aparece na Shopify depois que existe um webhook) e clique em Criar conexão. No cartão da conexão, clique em Copiar para copiar a URL do webhook.
Na Shopify, crie o webhook
No admin da Shopify, vá em Configurações › Notificações e clique em Webhooks. Clique em ⊕ Criar webhook. No menu Evento, escolha Pagamento de pedido. Em Formato, escolha JSON. No campo URL, cole a URL copiada da Vozea. Em Versão da API do webhook, deixe a versão sugerida (a mais recente estável). Clique em Salvar.
Atenção: O evento não pode ser trocado depois de criado. Se errar, exclua o webhook (… › Excluir) e crie de novo. Só Pagamento de pedido basta — Criação de pedido não é necessário.
Copie a chave de assinatura
Ainda em Configurações › Notificações › Webhooks, depois de salvar, aparece no fim da lista a frase "Todos os seus webhooks serão assinados com …" seguida de uma chave. Copie essa chave.
Atenção: A chave só é mostrada quando a loja tem pelo menos um webhook — por isso ela entra depois do passo 2.
Cole a chave na Vozea
No cartão da conexão Shopify, clique em Gerenciar, cole a chave no campo Segredo e salve. A partir daqui a Vozea aceita as chamadas da loja.
Como testar
- Na Shopify, na linha do webhook, clique em … › Enviar teste.
- Na Vozea, em Coletar › Vendas › Últimas vendas, a chamada aparece em segundos. O teste da Shopify usa um pedido de exemplo — se virar um pedido agendado, pare-o em Coletar › Na fila.
- Faça a chave chegar à Vozea antes de testar: se a URL responder erro repetidas vezes, a Shopify exclui o webhook sozinha (e avisa o titular da loja por e-mail).
Depois de ligar
- 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.
- A Vozea usa o primeiro item do pedido como "o que comprou" no pedido de depoimento.
Problemas comuns
- O webhook sumiu do admin da Shopify
- A Shopify exclui um webhook cuja URL responde erro repetidas vezes. Quase sempre é a chave errada ou vazia na Vozea (a Vozea responde 401). Cole a chave certa em Gerenciar e crie o webhook de novo.
- "Assinatura não confere" em Últimas vendas
- O token colado na Vozea não é o mesmo da plataforma. Confira em Gerenciar, cole de novo sem espaços e salve. A plataforma reenvia a chamada sozinha (ou use o botão de teste dela).
- "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.
- "Evento ignorado"
- A plataforma mandou um evento que não é compra aprovada nem cancelamento (boleto gerado, pix gerado, carrinho abandonado…). É normal: só a compra aprovada vira pedido.
- "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.
- O pedido foi criado mas não apareceu
- A Vozea só entra com pedido pago (evento Pagamento de pedido). Boleto e Pix aparecem quando o pagamento é confirmado.
Fontes
Os nomes de menus, botões e campos deste manual foram conferidos em:
Ficou com dúvida? Escreva para contato@vozea.io.