Infoprodutos
Como integrar a Kiwify ao GoHighLevel
O GoHighLevel não tem integração nativa com a Kiwify, mas o webhook da Kiwify resolve: cada venda, reembolso ou carrinho abandonado vira um envio para um workflow com gatilho Inbound Webhook. O detalhe que mais pega é que o carrinho abandonado chega num formato diferente das compras e precisa de um workflow próprio.
- Evento na Kiwify
- Webhook (Apps → Webhooks)
- Inbound Webhook no workflow
- Contato com tag no CRM
- Sequência de follow-up
Onde funciona dentro do GoHighLevel
- Workflows com o gatilho Inbound Webhook (premium)
- Criação ou atualização de contato pelo e-mail ou telefone do comprador
- Tags por produto e por evento (compra, reembolso, chargeback, abandono)
- Lembrete de pagamento a partir de boleto ou Pix gerado
- Eventos de assinatura: cancelada, atrasada e renovada
O que você precisa antes de começar
- Conta de produtor na Kiwify com acesso ao menu Apps
- Premium Triggers & Actions habilitado na agência do GoHighLevel
- Acesso de administrador à subconta que vai receber os compradores
- Um token longo e aleatório para o webhook, guardado em local seguro
Passo a passo
Crie o workflow com o gatilho Inbound Webhook
No GoHighLevel, crie um workflow com o gatilho Inbound Webhook e copie a URL exclusiva gerada. Faça um workflow para os eventos de compra e outro, separado, para carrinho abandonado.
O carrinho abandonado da Kiwify chega com outra estrutura de dados e sem o campo de tipo de evento que as compras trazem. No mesmo gatilho, o mapeamento de um dos dois quebra.
Cadastre o webhook na Kiwify
No painel da Kiwify, abra Apps, clique em Webhooks e depois em Criar Webhook. No painel lateral, escolha o produto, os eventos e cole a URL do GoHighLevel. Salve em Criar.
Preencha o token. Sem ele, a assinatura que a Kiwify acrescenta à URL é calculada com chave vazia e não prova nada.
Escolha os eventos
Os gatilhos disponíveis são boleto gerado, Pix gerado, carrinho abandonado, compra recusada, compra aprovada, compra reembolsada, chargeback e os três de assinatura (cancelada, atrasada e renovada).
Teste e salve a amostra no GoHighLevel
Na Kiwify, use Testar Webhook. No workflow, clique em Test Trigger, selecione a requisição recebida e salve como dado de amostra para liberar os campos no mapeamento.
O teste da Kiwify usa dados fictícios. Na tela Ver logs da Kiwify dá para conferir exatamente o que foi enviado e a resposta do GoHighLevel.
Mapeie o contato e separe por evento
Na ação Create/Update Contact, mapeie nome, e-mail e telefone do comprador. Em seguida, use uma condição (If/Else) sobre o campo webhook_event_type — order_approved, order_refunded, chargeback — para aplicar a tag e seguir para a sequência certa.
O nome do gatilho escolhido na Kiwify não é o valor que chega no envio: quem marca compra_aprovada recebe order_approved. Monte as condições com o valor do envio.
Limitações que valem saber antes
- Não há integração nativa: tudo passa pelo Inbound Webhook, que é gatilho premium. Cada subconta tem 100 execuções premium gratuitas, vitalícias (não renovam por mês); depois delas, a HighLevel cobra US$ 0,01 por execução, ou o excedente com desconto nos planos Workflow Pro.
- A Kiwify assina cada envio com HMAC-SHA1 do corpo, mas a documentação do Inbound Webhook não prevê validação de assinatura. Para validar, é preciso um intermediário como o n8n; sem ele, trate a URL do gatilho como segredo.
- O mesmo evento pode chegar mais de uma vez: a Kiwify reenvia automaticamente quando não recebe resposta 2xx em até 40 segundos. Sem deduplicação, um comprador pode receber a mesma mensagem duas vezes.
- A Kiwify não tem ambiente sandbox. O teste do painel envia dados fictícios; dados reais só aparecem com uma venda real.
- Em assinaturas, reembolso e chargeback geram dois envios — o da compra e o subscription_canceled — se os dois gatilhos estiverem ativos.
Perguntas frequentes
- O GoHighLevel tem integração nativa com a Kiwify?
- Não. A conexão é feita pelo webhook da Kiwify apontando para um workflow com gatilho Inbound Webhook. O n8n ou o Zapier podem entrar no meio quando é preciso validar a assinatura ou transformar os dados antes.
- Por que o carrinho abandonado não aparece no mesmo workflow das compras?
- Porque o envio de carrinho abandonado tem outro formato: traz os dados do carrinho com status próprio e não inclui o tipo de evento nem o status do pedido. Use um gatilho separado para ele.
- Dá para mandar lembrete para quem gerou Pix ou boleto e não pagou?
- Sim. Ative os gatilhos de Pix gerado e boleto gerado, aplique uma tag no contato e, no workflow, aguarde um prazo antes de lembrar. Quando a compra aprovada chegar, remova a tag para encerrar o lembrete.
- Como reenviar um evento que falhou?
- No webhook, abra os três pontos e entre em Ver logs. Dali dá para ver a requisição e a resposta de cada envio e reenviar os que falharam.
Onde isto foi verificado
- Kiwify — Entendendo o funcionamento do webhook Caminho Apps → Webhooks → Criar Webhook, Testar Webhook e Ver logs com reenvio manual
- Kiwify API — Receber e validar webhooks Assinatura HMAC-SHA1 na URL, limite de 40 segundos, reenvio automático e duplicidade, valores de webhook_event_type, formato distinto do carrinho abandonado, ausência de sandbox e envios duplos em assinaturas
- Kiwify API — Criar webhook Lista completa dos gatilhos disponíveis
- HighLevel — How to Enable and Rebill Premium Features for Workflows 100 execuções premium gratuitas e vitalícias por subconta; US$ 0,01 por execução depois delas; franquia e excedente com desconto nos planos Workflow Pro.
- HighLevel — How to use the Inbound Webhook Workflow Premium Trigger Inbound Webhook como gatilho premium, execuções gratuitas iniciais com cobrança depois delas, amostra de dados e exigência de e-mail ou telefone no Create/Update Contact
Quer isso configurado sem tentativa e erro?
A Galaxy IT implanta o GoHighLevel em português, com as integrações que a sua operação usa de verdade — incluindo as que dependem de ajuste fora da plataforma.
