--- title: "Como funcionam os Webhooks na Cakto: Guia Completo" description: "Webhook na Cakto" url: https://ajuda.cakto.com.br/pt-br/articles/1-como-funcionam-os-webhooks-na-cakto-guia-completo collection: "Integrações" updated: 2026-11-08 language: pt-br --- # Como funcionam os Webhooks na Cakto: Guia Completo Webhook na Cakto ## Como funcionam os Webhooks na Cakto: Guia Completo **Webhook na Cakto** é uma forma de fazer a Cakto “conversar” automaticamente com outros aplicativos sempre que algo acontece — como uma venda aprovada, um Pix 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. * * * ## 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. > 💡 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. * * * ## 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 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. ### Criando sua primeira integração 1. Clique em **“Criar Novo Webhook”**. 2. Preencha o **Nome** — use algo que identifique facilmente o que esse webhook faz (ex: “Planilha de Vendas” ou “Matrícula Automática”). 3. 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. 4. Selecione os **Produtos** que vão acionar esse webhook. 5. 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. 6. 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. 7. Clique em **Salvar**. ![](https://staticfiles.gleap.io/gattachments/M4DH5xysEG7se3bnBqvDlWU4t4zuY5y0oURytYWKKSgUZEhtL8ZLnOjGVP0hNI9OEyAOU3ySCSX.png) **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](https://pipedream.com/requestbin) que gera uma URL temporária para capturar e exibir exatamente o que a Cakto está enviando. 1. Na lista de webhooks, clique nos **três pontinhos** ao lado do webhook criado. 2. Selecione **“Enviar evento de teste”**. 3. Escolha o tipo de evento e confirme — a Cakto vai disparar um aviso de teste para a URL configurada. 4. Verifique no Request Bin se as informações chegaram corretamente. ![](https://staticfiles.gleap.io/gattachments/LxLopnz3nipEg7ij9CG1A0c1m9d4zRKZjfExCkeflXJHfv19E6yvmk6UWzKDFIuXws0AVox39Pi.png) * * * ## Quais eventos posso usar nos webhooks da Cakto? 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 (o boleto não está disponível para novas vendas no momento)

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](https://docs.cakto.com.br/conceitos/webhooks). * * * ## 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. - **Em processamento:** Avisos sendo enviados ou aguardando uma nova tentativa automática. A Cakto só tenta de novo sozinha quando o sistema de destino não responde (fora do ar ou demora acima de 8 segundos). - **Falharam:** Avisos que o sistema de destino recusou (resposta com código fora de 2xx, como 404 ou 500) ou que não foram entregues nem depois das tentativas automáticas. Precisam de reenvio manual. ![](https://staticfiles.gleap.io/gattachments/N1WEXLnJyyOQw5fmfFuTl5fHdNLg28pp8v3VFQR4Wt3NTEdByWsuxdIWPiT1SJUENRQpN0OscSO.png) ### 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: 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. ![](https://staticfiles.gleap.io/gattachments/0C69kdZ3IMo4I2CJauJraOgpGT1s5QRjKpENzbACMSf16yvlynLWWOvVA2MHdT2c4MzddAHAlYM.png) ### 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. ![](https://staticfiles.gleap.io/gattachments/JXtilfAnIqcQ3iU5RqpC0iq3UBlfuGmjzyOXfbiXKAoMw287uyP3W3MkB1Ly7n35MDbVtLEeSSD.png) * * * ## 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: Depende da falha. Se o seu sistema não responder (fora do ar ou demora acima de 8 segundos), a Cakto tenta de novo até 5 vezes, com intervalos de 5 s, 1 min, 2 min 30 s, 6 min e 30 min. Se o seu sistema responder com erro (qualquer código fora de 2xx, como 404 ou 500), a entrega fica registrada em “Falharam” e **não** é reenviada sozinha: abra o log e clique em “Reenviar Este Webhook”. Por isso, responda 2xx assim que receber o aviso e processe depois. **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. * * * ## Glossário: termos que você vai encontrar nos webhooks

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

* * * ## 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 “Em processamento” 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 “Em processamento” 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 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.