Data Hub: webhook e destinazioni push

Il Data Hub chiude l'ultimo miglio del flusso: dopo aver raccolto e normalizzato i dati da più sorgenti, ServiceBoard può rimandarli fuori — verso il gestionale del cliente o verso altri sistemi. Lo trovi in Impostazioni → Data Hub (solo amministratori). Ci sono due modi, pensati per esigenze diverse.

Due modi: notifica (pull) vs push

• Webhook — ti avviso, poi vieni a prendere i dati tu. Quando un sync finisce, ServiceBoard chiama il tuo URL con un evento firmato (sync.completed). Nel messaggio viaggiano solo i conteggi, mai i dati dei ticket. Il tuo sistema, ricevuto l'avviso, legge il delta dall'API pubblica in sola lettura con il suo token. È leggero e sicuro: il dato lo prendi tu, quando vuoi.
• Destinazione (push) — prendo io il dato, lo mappo e te lo spingo. ServiceBoard invia i ticket già mappati sui campi del tuo gestionale (rinomina campi + traduzione dei valori, es. stato "Chiuso" → codice "7"). L'invio è delta (solo ciò che è cambiato dall'ultimo push), firmato/autenticato e con chiave di idempotenza per record.

Webhook — come si fa

1. Apri Impostazioni → Data Hub.
2. Nella card Webhook, incolla l'URL del tuo endpoint e premi Aggiungi.
3. Copia subito il secret mostrato una sola volta: ti serve per verificare la firma (HMAC-SHA256).
4. Il tuo sistema, alla ricezione, legge il delta dall'endpoint di pull (lo trovi copiabile nella stessa card) usando un Token API che crei in Account → Token API.
5. Usa Test per inviare un payload di prova firmato e verificare che arrivi.

Destinazione (push) — come si fa

1. Nella card Destinazioni Data Hub, premi Aggiungi destinazione.
2. Dai un nome, l'URL (HTTPS) del gestionale e il tipo di autenticazione (nessuna, Bearer token, header custom). Il segreto è cifrato e non viene più mostrato.
3. Compila la mappatura: per ogni campo scegli il campo canonico (ID ticket, Titolo, Stato…) e il campo di destinazione (es. u_stato). Dove serve aggiungi una value map (es. Aperto=2, Chiuso=7). Se parti da zero, il bottone "Esempio ServiceNow" ti dà una traccia modificabile.
4. Salva. La destinazione riceve i ticket cambiati a ogni sync, oppure premi "Invia ora" per spingerli subito.

Sicurezza e governance

Escono solo dati già filtrati per il tuo tenant e per lo scope; mai costi o margini. Le destinazioni sono HTTPS-only, con protezione anti-SSRF ri-validata a ogni invio, segreti cifrati a riposo e ogni invio è auditato. Nei webhook non viaggiano dati di dettaglio: solo conteggi + un pull autenticato (lo scope vive nel token). È il modo pulito per alimentare il gestionale del cliente senza dargli accesso diretto al tuo database.

Vedi anche