Le integrazioni Conversations aiutano le aziende a unificare i messaggi provenienti da ogni canale, chatbot o app di terzi in un’unica conversazione e creare esperienze interattive ovunque.
- Un webhook.
- (Facoltativo) Un set di chiavi API per interagire con l’API pubblica con un ambito di integrazione. Per informazioni sulla creazione delle chiavi API, consulta Uso delle chiavi API delle conversazioni.
Nota: Le integrazioni delle conversazioni erano precedentemente note come webhook nel dashboard Sunshine Conversations.
Puoi creare integrazioni di conversazioni tramite la pagina Integrazioni conversazioni nel Centro amministrativo.
Puoi anche creare l’integrazione usando curl o Postman.
Questo articolo include le sezioni seguenti:
Creazione e configurazione di conversazioni nel Centro amministrativo
Nella pagina Integrazioni conversazioni, puoi:
Creazione di una nuova integrazione di conversazione
-
Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni conversazioni. Si apre la pagina Integrazioni conversazioni. Tutte le conversazioni create in precedenza vengono visualizzate nell’elenco.
Se è la prima volta che crei un’integrazione nel Centro amministrativo, fai clic su Crea integrazione per visualizzare la pagina Integrazioni conversazioni.
- Fai clic su Crea integrazione. Si apre la pagina Crea integrazione.
- Inserisci un nome univoco per identificare l’integrazione.
- Nella sezione Webhook, inserisci le seguenti informazioni:
-
URL endpoint webhook: L’URL di destinazione. Quando si verifica un evento trigger, il webhook vede l’evento e invia i dati all’URL di destinazione. L’URL di destinazione usa il formato seguente:
https://www.yourdomain.com/path
. - Dati corpo webhook: Usa le caselle di spunta per indicare se includere lo schema utente e le informazioni su client e dispositivo nei dati del webhook.
- Abbonamenti ai webhook: Seleziona gli eventi per i quali vuoi ricevere le notifiche.
-
URL endpoint webhook: L’URL di destinazione. Quando si verifica un evento trigger, il webhook vede l’evento e invia i dati all’URL di destinazione. L’URL di destinazione usa il formato seguente:
- Fai clic su Salva. Si apre la finestra Copia segreto condiviso.
- (Facoltativo) Copia l’ID webhook e il segreto condiviso. Questi vengono usati dagli sviluppatori per aggiungere un altro livello di autenticazione e non sono obbligatori.
- Fai clic su Avanti. Si apre la pagina di configurazione dell’integrazione. Da qui puoi aggiungere una chiave API, se necessario.
Aggiunta di una chiave API
Nella scheda Chiave API puoi configurare l’autenticazione per l’integrazione. Una chiave API identifica e autentica un'applicazione o un utente ed è composta da tre parti:
- L’ ID app identifica il tuo account Zendesk.
- L’ ID chiave quando viene usato insieme alla chiave segreta sono le credenziali usate per autenticare i JWT e le chiamate API.
- La chiave segreta è la password di autenticazione.
Per creare e condividere una chiave API
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni conversazioni. Si apre la pagina Integrazioni conversazioni.
- Fai clic sulla scheda Chiave API.
- Fai clic su Crea chiave API. Se stai creando la tua prima chiave, questo pulsante appare nella parte inferiore della pagina; se hai già creato una chiave, questa apparirà nell’angolo in alto a destra.
- Inserisci un nome identificativo per la chiave nella finestra di dialogo Crea nuova chiave, quindi fai clic su Avanti.
- Nella finestra di dialogo Copia segreto condiviso, fai clic su Copia per ciascun ID e chiave segreta per salvarli negli appunti, quindi fai clic su Avanti. A questo punto sarai indirizzato alla finestra API, dove la nuova chiave viene visualizzata nell'elenco.
Se generi una nuova chiave, ma hai raggiunto il limite di 10 chiavi, viene visualizzata una notifica che ti chiede di eliminare le chiavi inutilizzate.
Per eliminare una chiave inutilizzata
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni conversazioni.
- Fai clic sulla scheda Chiave API.
- Posiziona il puntatore del mouse sul tasto che intendi eliminare, quindi fai clic sul menu delle opzioni () e seleziona Elimina.
Visualizzazione, modifica o eliminazione di un’integrazione
Per lavorare con un’integrazione esistente
- Nel Centro amministrativo, fai clic su App e integrazioni nella barra laterale, quindi seleziona Integrazioni > Integrazioni conversazioni. Si apre la pagina Integrazioni conversazioni.
- Posiziona il cursore del mouse sull’integrazione da aggiornare e fai clic sull’icona Opzioni (), quindi seleziona un’opzione:
- Visualizza dettagli: Visualizza la pagina dei dettagli dell’integrazione, in cui puoi visualizzare gli ID app, integrazione e webhook, oltre a informazioni sui segreti condivisi, i dettagli del webhook e le chiavi API.
- Modifica: Apre la pagina Crea integrazioni, in cui puoi aggiornare il nome dell’integrazione e i dettagli del webhook.
- Elimina: Avvia una procedura guidata di eliminazione. Puoi annullare e uscire dalla procedura guidata in qualsiasi momento.
Altri metodi di integrazione
Questi metodi sono disponibili solo per gli utenti con una licenza Sunshine Conversations separata, non la licenza fornita con Zendesk Suite Professional o versioni successive.
Per creare un’integrazione di conversazioni usando curl
- Crea un’integrazione usando l’API Crea integrazione e impostala
type
acustom
. - Fornisci i parametri necessari come specificato nell’API. La destinazione è l’URL del server e l’elenco dei trigger determina quali eventi ricevere.
Per creare un’integrazione conversazioni usando Postman
- Crea un’integrazione usando l’API Crea integrazione e impostala
type
acustom
. - Scarica e installa l’applicazione Postman .
- Scarica la raccolta Sunshine Conversations Postman e configura il tuo ambiente.
- In Postman, seleziona Smooch > Integrazioni > Crea integrazioni.
- Fornisci i parametri necessari come specificato dal tipo di integrazione.
Per ulteriori informazioni sulle API Sunshine Conversations, consulta Integrazioni.
Consulta anche le guide su come inviare e ricevere messaggi. Ti consigliamo di configurare i webhook usando le API REST.
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.