🔗 Guida per l'utente: Webhook

La nostra piattaforma consente di configurare i webhook per ricevere aggiornamenti automatici su eventi chiave relativi ai vostri ordini e incidenti.

📌 Cosa sono i webhook?

Ad esempio, quando lo stato di un ordine o di un incidente cambia, Dropea può inviare automaticamente tali informazioni al tuo sistema, consentendoti di reagire immediatamente.

🔑 Configurazione iniziale

Per iniziare a utilizzare i webhook, segui questi passaggi:

1. Accedi al mio account → Token di accesso .
2. Crea una chiave API con le autorizzazioni relative ai tuoi ordini e incidenti.
3. Configura due endpoint o URL pubblici:
   • 📦 Per ricevere aggiornamenti sullo stato dell'ordine.
   • 🛠️ Un altro utente che riceverà aggiornamenti sullo stato dell'incidente.

✅ Sicurezza: firme HMAC

Per convalidare l'autenticità degli eventi ricevuti, ogni webhook può includere una firma digitale nell'intestazione.

Questo permette di verificare che la richiesta provenga effettivamente da Dropea e non sia stata alterata.

🛍️ Aggiornamento sullo stato dell'ordine

Quando lo stato di un ordine viene aggiornato, Dropea invia una notifica al webhook configurato con la struttura degli eventi.

❌ Esempio 1: l'ordine passa da confermato ad annullato

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

✅ Esempio 2: l'ordine passa da in sospeso a confermato

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

🔁 Esempio 3: l'ordine passa da errore a in sospeso

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

🛠️ Aggiornamento sull'incidente

Quando lo stato di un incidente viene aggiornato, Dropea invia una notifica al webhook configurato per gli incidenti.

📌 Esempio 1: L'incidente passa dallo stato "in sospeso" a "gestito dal cliente".

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

🔄 Esempio 2: L'incidente passa da gestito dal cliente a soluzione inviata

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

✅ Esempio 3: Modifiche all'incidente dalla soluzione inviata a risolto

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

📋 Dettagli per campo