Como criar e gerenciar um Webhook

O que já pode ser configurado no painel

A Kynura permite cadastrar endpoints por organização, escolher eventos, ativar ou pausar conexões, excluir endpoints e consultar entregas recentes registradas. O endpoint deve usar HTTPS.

Como criar

1. 1Abra Integrações → Webhooks.
2. 2Clique em Criar webhook.
3. 3Informe um nome interno para identificar a conexão.
4. 4Cole a URL HTTPS fornecida pelo sistema externo.
5. 5Marque somente os eventos que a automação realmente precisa.
6. 6Crie o webhook e confirme o estado do endpoint.

Eventos disponíveis

• product.created — produto criado.
• product.updated — produto atualizado.
• buyer.created — comprador criado.
• order.created — pedido criado.
• payment.approved — pagamento aprovado.
• payment.failed — pagamento não aprovado.
• order.refunded — reembolso.
• chargeback.opened — abertura de chargeback.
• access.granted — acesso liberado.
• access.revoked — acesso revogado.

O que significa “ativo” hoje

Ativo significa que o endpoint está cadastrado e participa da estrutura de eventos da Kynura. O envio externo assinado depende do dispatcher server-side e das credenciais de assinatura estarem configurados no ambiente. Portanto, cadastro ativo não deve ser confundido com homologação completa da integração externa.

Segurança e assinatura

• Nunca informe senhas ou chaves privadas dentro da URL.
• A Kynura reserva o segredo de assinatura para uso server-side; ele não deve ficar exposto no navegador.
• A assinatura HMAC e o dispatcher externo dependem das credenciais server-side previstas.
• Pause ou exclua endpoints que não são mais utilizados.

Antes de usar em produção

1. 1Confirme que o serviço externo recebeu um evento de teste controlado.
2. 2Valide que o mesmo evento não gera ações duplicadas.
3. 3Confira respostas HTTP e falhas registradas.
4. 4Homologue retries, assinatura e tratamento de indisponibilidade antes de depender da automação.