Webhooks
O plugin de Webhooks permite criar integrações para enviar automaticamente os eventos da Keoto para sistemas externos via requisições HTTP. É a forma mais flexível de integrar a Keoto com qualquer plataforma que aceite webhooks.
O que é
Um webhook é uma notificação automática enviada via HTTP (POST) para uma URL de sua escolha sempre que um evento ocorre na Keoto. Isso permite que sistemas externos — como CRMs, plataformas de automação, ERPs ou qualquer outro serviço — recebam dados de vendas em tempo real.
O que faz
Quando um evento é disparado (ex: venda aprovada, reembolso, etc.), a Keoto envia uma requisição HTTP para a URL configurada contendo todos os dados relevantes da transação:
- Dados do cliente (nome, email, telefone, documento)
- Dados do produto (nome, preço, descrição)
- Dados do pagamento (método, valor, status)
- Informações da assinatura (se aplicável)
- Parâmetros UTM e dados de marketing
Como configurar
1. Acesse o plugin de Webhooks
- No painel da Keoto, clique em Plugins no menu lateral
- Selecione Webhooks
- Clique em Criar nova integração
2. Preencha os dados da integração
| Campo | Descrição |
|---|---|
| Nome | Nome identificador da integração (ex: Meu CRM) |
| URL | URL do endpoint que receberá os eventos |
| Token | Token de autenticação (enviado no header da requisição) |
3. Selecione os eventos
Escolha quais eventos devem ser enviados para o webhook:
- Boleto gerado / Boleto expirado
- Pix gerado / Pix expirado
- NuPay gerado / NuPay expirado
- Carrinho abandonado
- Venda aprovada / Venda recusada / Venda reembolsada / Venda contestada
- Assinatura cancelada / Assinatura expirada / Assinatura renovada
4. Copie a URL do webhook (opcional)
Após salvar, o sistema gera uma URL de webhook que você pode usar para integrações reversas (receber dados de sistemas externos).
5. Teste a integração
Utilize o botão Testar para enviar um payload de teste para a URL configurada e verificar se tudo está funcionando corretamente.
Logs de envio
Todos os envios de webhook são registrados com detalhes de requisição e resposta. Para acessar os logs:
- Acesse o plugin de Webhooks
- Clique na integração desejada
- Visualize os logs de envio com status de sucesso ou falha
- Em caso de falha, é possível reenviar o webhook manualmente
Solução de problemas
”Webhook não está sendo recebido”
- Verifique se a URL está correta e acessível publicamente
- Confirme que o servidor de destino aceita requisições POST
- Verifique os logs de envio para detalhes do erro
”Dados incompletos no payload”
- Certifique-se de que os eventos corretos estão selecionados
- Verifique se o produto está vinculado à integração
Precisa de mais ajuda? Entre em contato com nosso suporte.