Qual è il mio piano?

Disponibile con tutti i piani SuiteDisponibile con tutti i piani Support

Nota: Gli URL e le destinazioni con brand diventeranno obsoleti il 13 dicembre 2024. Per maggiori informazioni, leggi l’annuncio.

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.

L'articolo include i seguenti argomenti:
  • Creazione di un nuovo webhook in base alla destinazione
  • Configurazione di un trigger per l’invio delle notifiche webhook
  • Disattivazione della destinazione e dei trigger associati

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:
  1. Crea un nuovo webhook in base alla destinazione.
  2. Configura un trigger per inviare la notifica webhook.
  3. 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

  1. In una finestra del browser, apri la destinazione URL.
    1. Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Destinazioni > Destinazioni.
    2. Trova la destinazione da convertire in webhook e fai clic su Modifica.
  2. 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.
  3. Fai clic su Crea webhook.
  4. Seleziona Trigger o automazione come metodo di connessione e fai clic su Avanti.
  5. Mappa i valori della destinazione ai campi del webhook. Per istruzioni dettagliate sulla mappatura, consulta:
    • Basecamp
    • Campfire
    • Get Satisfaction
    • Jira
    • URL
  6. 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.

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
  1. Nel Centro amministrativo, fai clic su Oggetti e regole nella barra laterale, quindi seleziona Regole aziendali > Trigger.
  2. 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.

  3. In Azioni, fai clic su Aggiungi azione e seleziona Notifica per > Webhook attivo.
  4. Seleziona nel menu a discesa il webhook che hai creato per sostituire la destinazione.
  5. 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.
  6. Fai clic su Salva.
  7. 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.

Powered by Zendesk