Webhook¶
I webhook sono un modo per integrare Zammad con altri servizi web o applicazioni, consentendo loro di iscriversi agli aggiornamenti in tempo reale sui ticket invece di dover interrogare il server Zammad ogni n minuti. Puoi trovare la configurazione dei webhook nelle impostazioni di Zammad sotto Gestisci > Webhook.
Suggerimento
I webhook potrebbero non arrivare immediatamente. Vengono inviati con la stessa priorità e ordine dei trigger email. Se l’invio del webhook fallisce (ad esempio, perché il server ricevente è mal configurato), Zammad tenterà fino a quattro volte.
I webhook devono essere attivati da job Trigger o Scheduler.
Come Funzionano i Webhook¶
Sotto il cofano, Zammad invia una richiesta a un URL di terze parti («endpoint API») che specifichi nella configurazione del webhook. Il server dell’applicazione dietro questo URL/endpoint deve essere configurato per ricevere messaggi da Zammad e gestire il payload fornito di conseguenza.
I webhook possono essere creati sia da zero che da modelli predefiniti. Quando creati da zero, i payload dei webhook regolari contengono per impostazione predefinita i seguenti dati JSON su ticket nuovi/aggiornati:
Attributi/metadati del ticket
Articolo/i associato/i
Utenti associati (ad es. mittenti articoli, proprietari, ecc.)
Ruoli utente associati
Organizzazioni utente associate (se applicabile)
Gruppi associati
D’altra parte, i webhook predefiniti sono progettati per funzionare con servizi specifici, contenendo payload speciali che questi servizi comprendono. In entrambi i casi, tuttavia, è possibile personalizzare ulteriormente il payload del webhook in base alle proprie esigenze.