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.
Informazioni sulla conversione delle destinazioni in webhook
- 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 valutare le app di Zendesk Marketplace in grado di soddisfare le tue esigenze.
Creazione di un nuovo webhook in base alla 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 > Destinazioni.
- Trova la destinazione da convertire in webhook e fai clic su Modifica.
- In una finestra del browser separata, apri la pagina Webhook.
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Azioni e webhook > Webhook.
- 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
- 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
- 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
- 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
- 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
- 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.
- 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 di 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.
Dopo aver confermato 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.