Webhooks

O que são webhooks

Webhooks são notificações automáticas via HTTP que a Converte envia para uma URL sua sempre que um evento acontece na sua conta — como um pagamento aprovado ou um reembolso.

Para que servem

Use webhooks para conectar a Converte a qualquer sistema que aceite requisições HTTP:

• Sistemas próprios ou personalizados
• Zapier
• Make (Integromat)
• n8n
• Qualquer outra ferramenta de automação

Como configurar

1. No menu lateral, acesse Integrações
2. Vá até a seção Webhooks
3. Clique para adicionar novo webhook
4. Insira a URL de destino
   • Deve ser uma URL HTTPS válida (ex: https://meusite.com/webhook)
5. Selecione os eventos que deseja receber:
   • order.paid — quando um pagamento é aprovado
   • order.failed — quando um pagamento falha
   • order.refunded — quando um pedido é reembolsado
   • order.chargeback — quando um chargeback é recebido
6. Opcionalmente, filtre por produto para receber webhooks apenas de produtos específicos
7. Clique em Salvar e ative o webhook

Testando

Após configurar, use o botão Testar para enviar um payload de teste para sua URL. Isso permite verificar se sua URL está recebendo e processando os dados corretamente antes de receber eventos reais.

Monitoramento e retentativas

• Se um webhook falhar (sua URL não retornar status 2xx), o sistema reenvia automaticamente a cada 5 minutos.
• Webhooks com falha aparecem na lista com detalhes do erro e número de tentativas.
• Você pode visualizar o histórico de entregas para diagnosticar problemas.

Gerenciamento

• Desativar: pause temporariamente um webhook sem excluí-lo. Eventos não serão enviados enquanto estiver desativado.
• Excluir: remova permanentemente um webhook que você não precisa mais.