Como usar o Zapier com o VSL Max

Os dois sentidos

No cartão Zapier, em Configurações › Integrações, há duas abas:

• Enviar eventos: o VSL Max avisa o seu Zap quando acontece uma venda, um reembolso, um vídeo fica pronto e outros eventos. Serve para alimentar planilha, CRM, Slack e o que mais o Zapier alcança.
• Receber vendas: um checkout que não está na nossa lista de plataformas manda a venda para o VSL Max por um Zap, e a venda entra atribuída ao vídeo.

Enviar eventos para o Zapier

1. No Zapier, crie um Zap com o gatilho Webhooks by Zapier, opção Catch Hook. O Zapier gera uma URL.
2. No VSL Max, abra o cartão Zapier, aba Enviar eventos, e cole a URL em URL do Catch Hook. Só são aceitas URLs que começam com https://hooks.zapier.com/hooks/catch/.
3. Dê um nome (opcional) e escolha os eventos. Sem escolha, ficam os quatro de venda: venda aprovada, reembolso, chargeback e venda cancelada.
4. Clique em Conectar Zap.
5. Use Testar para mandar um evento de teste agora. No Zapier, ele aparece como amostra para você mapear os campos nos próximos passos do Zap.

Ao conectar, o VSL Max mostra um segredo de assinatura uma única vez. No Zapier ele é opcional; use se o seu Zap passar o evento adiante para um servidor que confira a assinatura. Os eventos, o formato do corpo e a assinatura são os mesmos do webhook genérico: veja Webhook genérico.

Eventos disponíveis: venda aprovada, reembolso, chargeback, venda cancelada, vídeo pronto, saldo de plays baixo e conta suspensa. Você pode ter até 5 Zaps conectados.

Receber vendas pelo Zapier

Use quando o seu checkout não está na lista de plataformas de Conversões. Também funciona com Make e n8n.

1. Em Conversões, crie uma conversão com a plataforma Zapier (ou Make, ou n8n). A aba Receber vendas tem um atalho para isso.
2. Informe os domínios do seu checkout (de 1 a 10). É por eles que o player sabe quais links da página levam ao checkout e recebem a chave de rastreio.
3. Copie a URL da conversão, que aparece depois de salvar.
4. No Zap, use o gatilho do seu checkout (venda aprovada, por exemplo) e a ação Webhooks by Zapier, POST, com a URL da conversão.
5. Mapeie os campos da tabela abaixo. A chave vem do parâmetro de rastreio que o seu checkout devolve na venda.
6. Vincule a conversão ao vídeo, na tela do vídeo. Veja Conversão vinculada.

O corpo aceito é compatível com o do VTurb: quem migra só troca a URL no Zap.

Campos aceitos na venda

• Chave (conversion_key ou key): necessária para atribuir a venda ao vídeo. Sem ela, a venda entra sem atribuição.
• Valor: obrigatório. Em centavos, como inteiro, em order_amount_cents ou amount_cents. Em decimal, com ponto ou vírgula, em amount ou value.
• Moeda (currency): três letras. Se não vier, vale BRL.
• Status (status, category ou event): approved, paid, sale ou purchase viram venda aprovada; também são aceitos refunded, chargeback e canceled. Se não vier, a venda é aprovada.
• ID do pedido (order_id, transaction_id, sale_id ou id): mapeie sempre. Sem ele, duas vendas com o mesmo valor e a mesma data podem ser contadas como uma só.
• Data (order_created_at, occurred_at ou created_at): ISO 8601 ou epoch. Se não vier, vale o momento do recebimento.

Nome do produto e IP do comprador são aceitos e descartados: o VSL Max não guarda dado pessoal do comprador.

Se algo não chegar

• Evento não chega no Zap: abra os detalhes do Zap na lista e veja Últimas entregas. Cada entrega mostra o status HTTP e quantas tentativas houve.
• Venda chega sem vídeo: quase sempre falta a chave. Confira se o domínio do checkout está cadastrado na conversão e se o Zap está mandando o campo da chave. Veja Parâmetro de rastreio.