🔗 Guia do Usuário: Webhooks

Nossa plataforma permite que você configure webhooks para receber atualizações automáticas sobre eventos importantes relacionados aos seus pedidos e incidentes.

📌 O que são webhooks?

Por exemplo, quando o status de um pedido ou incidente muda, a Dropea pode enviar automaticamente essa informação para o seu sistema para que você possa reagir imediatamente.

🔑 Configuração inicial

Para começar a usar webhooks, siga estes passos:

1. Faça login em Minha Conta → Token de Acesso .
2. Crie uma chave de API com permissões sobre seus pedidos e incidentes.
3. Configure dois endpoints ou URLs públicos:
   • 📦 Um para receber atualizações sobre o status do pedido.
   • 🛠️ Mais um para receber atualizações sobre o status do incidente.

✅ Segurança: Assinaturas HMAC

Para validar a autenticidade dos eventos recebidos, cada webhook pode incluir uma assinatura digital no cabeçalho.

Isso permite verificar se a solicitação realmente vem do Dropea e não foi alterada.

🛍️ Atualização do status do pedido

Quando o status de um pedido é atualizado, a Dropea envia uma notificação para o webhook configurado com a estrutura de eventos.

❌ Exemplo 1: alteração do pedido de confirmado para cancelado

 {"topic":"order:status_update","order_id":265494,"prev_status":"confirmed","new_status":"cancelled","updated_at":"2025-05-29 14:14:58"}

✅ Exemplo 2: alteração do pedido de pendente para confirmado

 {"topic":"order:status_update","order_id":265494,"prev_status":"pending","new_status":"confirmed","updated_at":"2025-05-29 14:14:58"}

🔁 Exemplo 3: o pedido muda de erro para pendente

 {"topic": "order:status_update",
 "order_id":265496,"prev_status":"error","new_status":"pending","updated_at":"2025-05-29 14:38:05"}

🛠️ Atualização sobre o incidente

Quando o status de um incidente é atualizado, o Dropea envia uma notificação para o webhook configurado para incidentes.

📌 Exemplo 1: O incidente passa de pendente para resolvido pelo cliente

 {
 "topic": "incidence:status_update",
 "incidence_id": 189044,
 "prev_status": "pending",
 "new_status": "client_managed",
 "updated_at": "2025-02-13 14:23:56"
 }

🔄 Exemplo 2: O incidente passa de "resolvido pelo cliente" para "solução enviada".

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "client_managed",
 "new_status": "solution_send",
 "updated_at": "2025-05-29 16:10:45"
 }

✅ Exemplo 3: Alterações no incidente, de solução enviada para resolvido

 {
 "topic": "incidence:status_update",
 "incidence_id": 265494,
 "prev_status": "solution_send",
 "new_status": "resolved",
 "updated_at": "2025-05-29 17:42:30"
 }

📋 Detalhes por campo