Webhook na Cakto é uma forma de fazer a Cakto “conversar” automaticamente com outros aplicativos sempre que algo acontece — como uma venda aprovada, um boleto gerado ou um reembolso processado. Funciona enviando um pacote de informações no formato JSON para um endereço (URL) que você configura, em menos de 1 segundo após o evento. É utilizado principalmente para conectar a Cakto com ferramentas como n8n, Make, Zapier, Google Sheets e plataformas de membros — mesmo sem integração nativa entre elas.
Pense no webhook como um “aviso automático”. Quando um evento acontece na Cakto — por exemplo, uma compra aprovada — ela envia imediatamente uma notificação para outro sistema da sua escolha, com todas as informações daquela venda.
Isso permite, por exemplo:
Adicionar uma nova linha automaticamente no Google Sheets a cada venda aprovada.
Matricular um aluno em uma plataforma de membros assim que o pagamento for confirmado.
Registrar dados de compra no seu CRM sem nenhuma ação manual.
A Cakto envia essas notificações no formato JSON — um padrão amplamente utilizado para troca de informações entre sistemas, compatível com praticamente qualquer ferramenta de automação do mercado.
💡 Vale lembrar que webhooks são uma funcionalidade um pouco mais avançada. Recomendamos utilizá-los se você já tem experiência com integrações — ou se contar com o apoio de alguém técnico para a configuração inicial.
No menu lateral da Cakto, acesse Integrações e clique na sub-aba Webhooks. Conforme a release note oficial do Squad de Plataforma da Cakto (março/2026), essa área foi completamente reformulada — e agora funciona como um painel de monitoramento completo, não apenas uma tela de configuração.
Clique em “Criar Novo Webhook”.
Preencha o Nome — use algo que identifique facilmente o que esse webhook faz (ex: “Planilha de Vendas” ou “Matrícula Automática”).
Insira a URL de destino — é o endereço do sistema que vai receber as informações. Essa URL é gerada pela ferramenta que você quer integrar, como n8n ou Make.
Selecione os Produtos que vão acionar esse webhook.
Escolha os Eventos — os momentos em que o aviso será disparado. Você pode selecionar mais de um evento para a mesma URL. Veja a lista completa na seção abaixo.
Defina uma Chave Secreta — uma senha que garante que só a Cakto consegue enviar avisos para essa URL, protegendo sua integração de acessos não autorizados.
Clique em Salvar.
Exemplo prático: Quer que cada venda aprovada gere uma linha nova no Google Sheets? Configure um webhook com o evento purchase_approved e a URL gerada pelo n8n. A partir daí, cada aprovação registra os dados automaticamente na planilha em menos de 2 segundos — sem você precisar fazer nada.
A prática recomendada é sempre testar o webhook antes de apontá-lo para seu sistema real. Para isso, use o Request Bin — uma ferramenta gratuita em pipedream.com/requestbin que gera uma URL temporária para capturar e exibir exatamente o que a Cakto está enviando.
Na lista de webhooks, clique nos três pontinhos ao lado do webhook criado.
Selecione “Enviar evento de teste”.
Escolha o tipo de evento e confirme — a Cakto vai disparar um aviso de teste para a URL configurada.
Verifique no Request Bin se as informações chegaram corretamente.
Conforme a documentação oficial da Cakto, estes são todos os eventos disponíveis:
Evento | O que dispara |
purchase_approved | Compra aprovada (pagamento único ou recorrente) |
purchase_refused | Tentativa de pagamento recusada |
pix_gerado | QR Code Pix criado, aguardando pagamento |
boleto_gerado | Boleto emitido, aguardando pagamento |
picpay_gerado | Cobrança PicPay criada, aguardando pagamento |
refund | Pedido reembolsado |
chargeback | Disputa de pagamento iniciada pelo cliente |
subscription_canceled | Assinatura recorrente cancelada |
subscription_renewed | Assinatura recorrente renovada com sucesso |
checkout_abandonment | Cliente preencheu dados mas não finalizou a compra |
Para consultar os payloads completos de cada evento, acesse a documentação oficial de webhooks da Cakto.
Conforme a release note oficial de março de 2026, o Dashboard de Webhooks foi a principal novidade da atualização — transformando o que antes era só uma configuração técnica em um painel de controle completo com 4 indicadores em tempo real:
Enviados: Total de avisos disparados pela Cakto nas últimas 24 horas.
Entregues: Avisos que chegaram com sucesso ao sistema de destino.
Retrying: Avisos que falharam na primeira tentativa e estão sendo reenviados automaticamente pela Cakto.
Falharam: Avisos que não conseguiram ser entregues após todas as tentativas — e precisam de reenvio manual.
Clique em “Ver Logs” para acessar o histórico completo de qualquer webhook. Cada registro mostra 3 informações essenciais: o que a Cakto enviou, o código de resposta do sistema de destino (200 = sucesso, 500 = erro no servidor de destino, 404 = URL não encontrada) e o detalhe exato do erro, quando houver.
Você também verá a métrica de latência — o tempo que o sistema de destino levou para responder ao aviso da Cakto. Se esse tempo estiver acima de 5 segundos, pode indicar que o servidor que recebe o webhook está sobrecarregado.
Se um aviso foi para o card “Falharam”, você não precisa acionar o suporte. Basta abrir o detalhe do log e clicar em “Reenviar Este Webhook” — o aviso é disparado novamente na hora, independentemente de quando a falha aconteceu.
P: O que significa o status “Pausado” em um webhook? R: Significa que o envio para aquela URL foi interrompido manualmente. Enquanto estiver pausado, nenhum aviso é disparado. Para reativar, acesse as configurações do webhook e altere o status.
P: A Cakto tenta reenviar automaticamente quando um webhook falha? R: Sim. Os avisos com falha entram automaticamente no card “Retrying” e a Cakto tenta reenviá-los com intervalos progressivos. Se todas as tentativas falharem, o evento vai para “Falharam” — e o reenvio deve ser feito manualmente com um clique no botão “Reenviar Este Webhook”.
P: Posso usar a mesma URL para receber diferentes tipos de eventos? R: Sim. Na criação ou edição do webhook, você pode selecionar vários eventos ao mesmo tempo — como purchase_approved e checkout_abandonment — e todos serão enviados para a mesma URL de destino.
P: Como encontro o registro de uma venda específica que não foi recebida? R: Acesse “Atividades Recentes” e use o botão Filtros. É possível buscar pelo ID do pedido ou pelo tipo de evento. Ao abrir o detalhe, você vê exatamente o que a Cakto enviou e qual foi a resposta do sistema de destino.
P: O que é a latência mostrada no dashboard? R: É o tempo que o sistema de destino levou para responder ao aviso da Cakto. Latência acima de 5 segundos pode indicar que o servidor que recebe o webhook está sobrecarregado ou processando as informações lentamente.
Termo | O que significa |
Webhook | Aviso automático enviado pela Cakto para outro sistema quando algo acontece |
JSON | Formato padrão usado para empacotar e enviar as informações da venda |
URL de destino | Endereço do sistema que vai receber os avisos da Cakto |
Evento | O momento que dispara o aviso — o “gatilho” da integração |
Chave Secreta | Senha que protege sua integração, garantindo que só a Cakto pode enviar avisos para aquela URL |
Latência | Tempo que o sistema de destino levou para confirmar que recebeu o aviso |
1. Usar uma URL de destino incorreta ou inativa
Problema: O webhook dispara mas o aviso nunca chega — fica preso em “Falharam”. Por que acontece: A URL foi digitada errada, o sistema de destino estava fora do ar, ou a ferramenta de automação não estava ativa no momento do disparo. Solução: Sempre teste com o Request Bin antes de usar em produção. Confirme que a Cakto consegue se comunicar com a URL configurada antes de apontar para o sistema real.
2. Escolher o evento errado
Problema: A integração não dispara no momento esperado. Por que acontece: Confusão entre os tipos de evento — por exemplo, usar pix_gerado quando o correto seria purchase_approved. O Pix gerado significa que o QR Code foi criado, mas o pagamento ainda não foi confirmado. Solução: Se você quer agir só após a confirmação do pagamento, o evento certo é sempre purchase_approved. Consulte a tabela de eventos acima para escolher o gatilho correto para cada situação.
3. Ignorar o card “Retrying” e só olhar “Falharam”
Problema: Integrações ficam com problemas por horas sem que ninguém perceba. Por que acontece: A maioria dos usuários só nota que algo está errado quando a integração para completamente de funcionar. Solução: Monitore o card “Retrying” regularmente. Avisos presos em reenvio automático por mais de 3 tentativas consecutivas são sinal de problema no sistema de destino — vale investigar antes de virar uma falha definitiva.
Webhooks na Cakto são a forma mais eficiente de conectar a plataforma com outros sistemas de forma automática, enviando informações no formato JSON em menos de 1 segundo após cada evento. Conforme a release note oficial do Squad de Plataforma de março de 2026, o novo Dashboard de Webhooks transformou o que era uma configuração técnica em um painel de controle completo — com monitoramento em tempo real, histórico detalhado de erros e reenvio manual com 1 clique, sem precisar acionar o suporte. Para começar, acesse Integrações > Webhooks no menu lateral da Cakto e configure sua primeira integração.
