Le integrazioni Conversations aiutano le aziende a unificare i messaggi provenienti da ogni canale, chatbot o app di terzi in un’unica conversazione e a creare esperienze interattive ovunque.
- Un webhook.
- (Facoltativo) Un set di chiavi API per interagire con l’API pubblica in un ambito di integrazione. Per informazioni sulla creazione delle chiavi API, consulta Uso di chiavi API per le conversazioni.
Nota: Le integrazioni di Conversations erano precedentemente note come webhook nel dashboard di Sunshine Conversations.
Puoi creare integrazioni conversazioni nella 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 > Conversazioni. Si apre la pagina Integrazioni conversazioni. Tutte le conversazioni create in precedenza appaiono 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 webhook.
- Abbonamenti 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. Vengono usati dagli sviluppatori per aggiungere un altro livello di autenticazione e non sono necessari.
- 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 l’account Zendesk.
- L’ ID chiave , se usato insieme alla chiave segreta, corrisponde alle 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 > 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 ogni ID e chiave segreta per salvarla negli appunti, quindi fai clic su Avanti. Si torna alla finestra API, dove la nuova chiave appare 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 > Conversazioni.
- Fai clic sulla scheda Chiave API.
- Posiziona il puntatore del mouse sul tasto da eliminare, quindi fai clic sul menu delle opzioni () e quindi 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 > 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 è possibile visualizzare gli ID dell’app, dell’integrazione e del 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 l’eliminazione guidata. Puoi annullare la procedura guidata in qualsiasi momento.
Altri metodi di integrazione
Questi metodi sono disponibili solo agli utenti con una licenza Sunshine Conversations separata, non la licenza fornita con Zendesk Suite Professional o superiore.
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 di 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.