In precedenza, le destinazioni venivano usate per trasmettere informazioni ad applicazioni e servizi esterni basati sul cloud al fine di notificare loro le modifiche in Zendesk. Questo articolo descrive come convertire in webhook la maggior parte delle destinazioni esistenti.
Questo articolo include i seguenti argomenti:
Informazioni sulla conversione delle destinazioni in webhook
Quando si convertono le destinazioni in webhook, l’ordine in cui eseguire le azioni è importante per la continuità del processo. Consigliamo la procedura seguente:
- Crea un nuovo webhook in base alla destinazione.
- Configura un trigger per inviare la notifica webhook.
- Verifica che il nuovo webhook e il nuovo trigger funzionino come previsto, quindi disattiva la destinazione e gli eventuali trigger associati.
Conversione di obiettivi Clickatell, Pivotal, Twilio, X Corp e Yammer
Non esiste un modo diretto per mappare le configurazioni delle destinazioni Clickatell, Pivotal, Twilio, X Corp (in precedenza Twitter) e Yammer ai webhook. Ti consigliamo di valutare le app di Zendesk Marketplace in grado di soddisfare le tue esigenze.
Crea un nuovo webhook in base alla tua destinazione
Per convertire le destinazioni in webhook ti consigliamo di aprire i dettagli della destinazione in una finestra e il webhook in un'altra.
Per creare un webhook basato su una destinazione URL
- In una finestra del browser, apri la destinazione URL.
-
Nel Centro amministrativo , fai clic su
App e integrazioni nella barra laterale, quindi seleziona Destinazioni> Traguardi .
- Trova la destinazione da convertire in webhook e fai clic su Modifica.
-
Nel Centro amministrativo , fai clic su
- In una finestra separata del browser, apri la pagina Webhook.
-
Nel Centro amministrativo , fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook> Webhook .
-
Nel Centro amministrativo , fai clic su
- Fai clic su Crea webhook.
- Seleziona Trigger o automazione come metodo di connessione e fai clic su Avanti.
- Mappa i valori della destinazione ai campi del webhook. Per istruzioni dettagliate sulla mappatura, consulta:
- Fai clic su Crea webhook.
Mappatura delle configurazioni delle destinazioni Basecamp ai webhook
Mappa i valori delle destinazioni Basecamp ai campi del webhook come segue:
- Titolo : il nome del webhook.
- URL : l’URL dell’endpoint del webhook.
- Per l’autenticazione del webhook, scegli uno dei metodi seguenti:
- Nome utente e Password: imposta l’Autenticazione del webhook su Autenticazione base e inserisci il nome utente e la password di Basecamp. Non è possibile copiare e incollare la password.
- Token API: imposta l’Autenticazione del webhook su Chiave API e inserisci il token API della destinazione Campfire.
- ID progetto: aggiungi /projects/[ID] alla fine dell’URL dell’endpoint del webhook. Esempio: https://corp.basecamphq.com /projects/2612430 .
-
Risorse : aggiungi alla fine dell’URL dell’endpoint del webhook, dopo l’ID del progetto, quanto segue.
-
Messaggio: aggiungi alla fine /posts/[ID]/comments. Esempio:
https://corp.basecamphq.com/projects/2612430/posts/25611692/comments - Impegni: aggiungi alla fine /todo_lists/[ID]. Esempio: https://corp.basecamphq.com/projects/2612430 /todo_lists/25611692 .
-
Messaggio: aggiungi alla fine /posts/[ID]/comments. Esempio:
Mappatura delle configurazioni delle destinazioni Campfire ai webhook
Mappa i valori delle destinazioni Campfire ai campi del webhook come segue:
- Titolo : il nome del webhook.
- Sottodominio: l’URL dell’endpoint del webhook.
- Token API : imposta l’Autenticazione del webhook su Chiave API e inserisci il token API della destinazione Campfire.
- Stanza: aggiungi questa informazione alla fine dell’URL dell’endpoint del webhook.
- SSL : questa opzione non si applica quando si crea un webhook.
- Conserva formato: questa opzione non si applica quando si crea un webhook.
Mappatura delle configurazioni delle destinazioni Get Satisfaction ai webhook
Mappa i valori delle destinazioni Get Satisfaction ai campi del webhook come segue:
- Titolo : il nome del webhook.
-
Nome azienda: incorpora nell’URL dell’endpoint del webhook. Ad esempio:
https://getsatisfaction.com/yourcompany/ - Indirizzo email e Password: imposta l’Autenticazione del webhook su Autenticazione base e inserisci il nome utente e la password di Get Satisfaction. Non è possibile copiare e incollare la password.
Mappatura delle configurazioni delle destinazioni Jira ai webhook
Zendesk consiglia vivamente di usare l’app Jira in Zendesk Marketplace per sostituire le destinazioni Jira. Tuttavia, se scegli di non usare l'app Jira, puoi mappare i valori delle destinazioni Jira ai campi webhook come segue:
- Titolo : il nome del webhook.
- URL : l’URL dell’endpoint del webhook.
- Nome utente e Password: imposta l’Autenticazione del webhook su Autenticazione base e inserisci il nome utente e la password di Jira. Non è possibile copiare e incollare la password.
Mappatura delle configurazioni delle destinazioni URL ai webhook
Mappa i valori delle destinazioni URL ai campi del webhook come segue:
- Titolo : il nome del webhook.
- URL : l’URL dell’endpoint del webhook.
- Metodo: il Metodo richiesta del webhook.
- Nome attributo: non è obbligatorio durante la creazione del webhook, ma verrà usato durante la configurazione delle azioni trigger.
- Autenticazione base: imposta l’Autenticazione del webhook su Autenticazione base e inserisci il nome utente e la password della destinazione URL. Non è possibile copiare e incollare la password.
- Nel webhook devi anche impostare il Formato richiesta su Modulo codificato.
Configurazione di un trigger per l’invio delle notifiche webhook
Dovresti aver già configurato un trigger per inviare notifiche in base alla destinazione. Puoi modificare questo trigger o clonarlo oppure puoi crearne uno nuovo.
Per modificare un trigger esistente per inviare la notifica webhook
-
Nel Centro amministrativo , fai clic su
Oggetti e regole nella barra laterale, quindi seleziona Regole aziendali> Trigger .
-
Modifica o clona un trigger esistente.
Prendi nota del valore del Messaggio dell’azione Notifica per > Destinazione. Lo riutilizzerai con la nuova azione basata su webhook.
- In Azioni, fai clic su Aggiungi azione e seleziona Notifica per > Webhook attivo.
- Seleziona nel menu a discesa il webhook che hai creato per sostituire la destinazione.
-
Configura il webhook per l’invio delle informazioni desiderate.
Ad esempio, per sostituire una destinazione URL, in Parametri URL, procedi come segue:
- Imposta la chiave sul Nome attributo della destinazione URL.
- Imposta il valore sul Messaggio dell’azione Notifica per > Destinazione.
- Fai clic su Salva.
- Torna al webhook e provane il funzionamento.
Disattivazione della destinazione e dei trigger associati
Dopo aver creato il webhook e aggiornato il trigger associato, prova scrupolosamente il webhook attivando le condizioni di trigger appropriate. Poiché il trigger è configurato con due azioni Notifica per, una per la destinazione e l’altra per il webhook, dovresti ricevere un messaggio due volte nell’applicazione o nel sistema esterno.
Una volta verificato il corretto funzionamento del webhook e del trigger, modifica il trigger per rimuovere l’azione Notifica per > Destinazione e poi disattiva o elimina la destinazione.
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.