Como funcionam os Webhooks?
Como funcionam os Webhooks na Cakto: Guia Completo
O que são webhooks e para que servem?
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.
Como criar um webhook na Cakto: passo a passo
Acessando a área de Webhooks
No menu lateral da Cakto, acesse Integrações e clique na sub-aba Webhooks. Conforme a release note oficial (maio/2026), essa área foi completamente reformulada — e agora funciona como um painel de monitoramento completo, não apenas uma tela de configuração.
Criando sua primeira integraçã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.
Como testar seu webhook antes de usar de verdade
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.
Quais eventos posso usar nos webhooks da Cakto?
Conforme a documentação oficial da Cakto, estes são todos os eventos disponíveis para configurar em um webhook:
Evento | O que dispara | Exemplo de uso |
|---|---|---|
| Compra aprovada (único ou recorrente) | Matricular aluno, enviar acesso ao produto |
| Tentativa de pagamento recusada | Notificar o cliente para tentar outro método |
| QR Code Pix criado, aguardando pagamento | Enviar o Pix por WhatsApp ou e-mail |
| Boleto emitido, aguardando pagamento | Enviar boleto por e-mail automaticamente |
| Cobrança PicPay criada, aguardando pagamento | Notificar o cliente sobre a cobrança gerada |
| Pedido reembolsado | Revogar acesso ao produto automaticamente |
| Disputa de pagamento iniciada pelo cliente | Alertar o time de suporte para agir |
| Assinatura recorrente cancelada | Remover acesso à área de membros |
| Assinatura recorrente renovada com sucesso | Renovar acesso e registrar na planilha |
| Cliente preencheu dados mas não finalizou a compra | Recuperar carrinho abandonado via e-mail ou WhatsApp |
Para consultar os payloads completos de cada evento, acesse a documentação oficial de webhooks da Cakto.
Monitorando suas integrações com o Dashboard de Webhooks
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.
Visualizando o histórico e identificando erros
Clique em "Ver Logs" para acessar o histórico completo de qualquer webhook. Cada registro mostra 3 informações essenciais para diagnosticar problemas: 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.
Reenviando um webhook com falha
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.
Perguntas frequentes sobre webhooks na Cakto
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 aí 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 — incluindo o código e o detalhe do erro.
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.
Glossário: termos que você vai encontrar nos webhooks
Termo | O que significa | Exemplo prático |
|---|---|---|
Webhook | Aviso automático enviado pela Cakto para outro sistema quando algo acontece | Venda aprovada → aluno matriculado automaticamente |
JSON | Formato padrão usado para empacotar e enviar as informações da venda | Dados como nome, valor, produto e data do comprador |
URL de destino | Endereço do sistema que vai receber os avisos da Cakto | Link gerado pelo n8n, Make ou sua ferramenta de automação |
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 | Definida no momento de criar o webhook |
Latência | Tempo que o sistema de destino levou para confirmar que recebeu o aviso | Acima de 5 segundos indica servidor receptor sobrecarregado |
Erros comuns ao usar webhooks na Cakto e como evitá-los
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 — quando já passou dos "Falharam".
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.
Conclusão
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 de maio 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.
Actualizado em: 08/05/2026