I webhook vengono creati e gestiti nel Centro amministrativo Zendesk dalla pagina Webhook.
Devi essere un amministratore o un agente con un ruolo personalizzato con l’autorizzazione a gestire i webhook.
Modifica e gestione dei webhook
Nella maggior parte dei casi, gli amministratori possono modificare, clonare, disattivare ed eliminare webhook. Tuttavia, i webhook creati in base ai requisiti dell’app possono essere modificati ma non clonati o eliminati. I webhook creati in base ai requisiti delle app possono essere aggiornati dallo sviluppatore dell’app e ignorare le modifiche apportate dagli amministratori dell’account. Dopo aver creato un webhook, non puoi cambiarne il metodo di connessione.
Per modificare un webhook
- Nel Centro amministrativo, fai clic su
App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook. - Trova il webhook nell’elenco, fai clic sull’icona del menu delle opzioni (
) nella riga del webhook, quindi fai clic su Modifica. - Modifica il webhook in base alle esigenze.
Tutti i campi possono essere modificati. Tuttavia, quando si usa l’autenticazione, la chiave, il tokeno la password non possono essere visualizzati dopo la creazione o l’aggiornamento del webhook. Per rimuovere un’intestazione personalizzata, fai clic sull’icona di eliminazione (
). - (Facoltativo) Prova le modifiche apportate al webhook.
- Fai clic su Salva.
Per clonare un webhook
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook.
- Trova il webhook nell’elenco, fai clic sull’icona del menu delle opzioni () nella riga del webhook, quindi fai clic su Clona.
- Modifica il nome del webhook e modifica il webhook in base alle esigenze.
- Fai clic su Aggiorna.
Per disattivare un webhook
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook.
- Trova il webhook nell’elenco, fai clic sull’icona del menu delle opzioni () nella riga del webhook, quindi fai clic su Disattiva.
- Nella finestra di dialogo di conferma, fai clic su Disattiva.
Per eliminare un webhook
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook.
- Trova il webhook nell’elenco, fai clic sull’icona del menu delle opzioni () nella riga del webhook, quindi fai clic su Elimina.
- Fai clic su Elimina.
Visualizzazione delle attività di un webhook
Ogni webhook ha un registro delle attività. Oltre a un record dettagliato delle chiamate, puoi anche vedere il numero di richieste negli ultimi sette giorni.
Una chiamata webhook viene ripetuta automaticamente fino a tre volte se l’endpoint restituisce determinati codici di risposta HTTP. Per ulteriori informazioni ed esempi di scenari di tentativi, consulta Logica dei tentativi di webhook nella documentazione per sviluppatori.
Zendesk si impegna al massimo per fornire azioni ai webhook una sola volta. Tuttavia, non possiamo garantirlo. È possibile che un webhook venga richiamato più volte dalla stessa azione oppure, in determinate circostanze, come l’attivazione dell’interruttore del webhook , le azioni potrebbero non essere consegnate affatto. Per rilevare le chiamate duplicate, puoi usare le firme webhook. Se ciò è problematico per il tuo workflow, assicurati che le azioni risultanti dai webhook siano idempotenti.
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook.
- Trova il webhook nell’elenco, fai clic sull’icona del menu delle opzioni () nella riga del webhook, quindi fai clic su Visualizza dettagli.
- Fai clic sulla scheda Attività.
- Fai clic su Filtra per filtrare il registro attività in base alla data di inizio, all’ora di inizio, alla data di fine, all’ora di fine o allo stato, quindi fai clic su Applica filtri.
Debug di un webhook
Se un webhook non funziona correttamente, le chiamate non riuscite saranno visibili nel registro delle attività del webhook. Puoi filtrare il registro attività in base allo stato Non riuscito o a un tipo specifico di errore. Nella scheda Attività, puoi anche fare clic su un ID chiamata per visualizzare la richiesta e la risposta per una chiamata specifica del webhook.
Nella maggior parte dei casi, la risposta proviene dal servizio di terzi che riceve la richiesta del webhook, non da Zendesk stesso. In genere, è necessario collaborare con questo servizio per correggere gli errori.
Puoi usare il codice numerico nello stato della risposta per diagnosticare i problemi. Questi codici di stato delle risposte sono standard nelle richieste HTTP. Per un elenco dei codici di stato delle risposte HTTP standard e del relativo significato, consulta Codici di stato delle risposte HTTP nei documenti web MDN.
Le richieste webhook hanno un timeout di 10 secondi. A "Non riuscito: Lo stato della risposta 504 Timeout gateway" indica che un servizio non ha risposto alla richiesta di un webhook entro questo periodo di timeout. Il periodo di timeout non è regolabile.
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.