Gli agenti AI di Zendesk sono chatbot basati AI che interagiscono con i clienti sui canali di messaggistica, email (inclusi API e moduli web) e voce (EAP). Possono conversare con i clienti ed eseguire azioni nei sistemi autorizzati in modo autonomo, automatizzando e risolvendo i problemi in modo che gli agenti umani possano concentrarsi su lavori più complessi.

Qual è il mio piano?
Tutte le suite Team, Growth, Professional, Enterprise o Enterprise Plus
Support Team, Professional o Enterprise

Questa funzione è disponibile solo per i client Enterprise. Per abilitarlo, contatta il tuo CSM.

Real_time_webhook_example.png

Questo articolo fornisce una spiegazione di:

  • Eventi che attivano avvisi in tempo reale
  • Configurazione webhook

Eventi che attivano avvisi in tempo reale

Con il webhook di avviso in tempo reale, puoi ricevere notifiche in tempo reale quando vengono attivati eventi di tuo interesse. Questi eventi possono verificarsi ovunque nel nostro sistema, ma al momento sono limitati ai cinque elencati di seguito: 

  1. Escalation non riuscita
  2. Azione non riuscita
  3. È stato inviato un messaggio di errore tecnico generico nella chat
  4. Integrazione backend personalizzata non riuscita: in questo caso, l’integrazione backend esatta è specificata indata oggetto.
  5. Test: un evento di test può essere attivato dallo spazio di lavoro agenti AI in modo che gli sviluppatori possano testare e implementare l’uso del webhook senza dover attendere uno dei trigger.

Non appena uno degli eventi viene attivato, inviamo una richiesta con il parametro seguente all’URL del webhook:

Nome Tipo Descrizione
botName stringa Assegna un nome agenti AI che ha attivato l’evento
evento stringa I cinque diversi tipi di eventi
ConversationId stringa ID conversazione univoco
platformConversationId stringa ID conversazione specifico della piattaforma
dati oggetto Metadati, usati principalmente dall’evento di integrazione backend

Per l’ evento di integrazione backend personalizzato , arricchiremo l’oggetto dati con il parametro seguente:

Nome Tipo Descrizione
botId stringa Una combinazione di numeri e lettere di 24 cifre univoca per ciascun agenti AI. Ulteriori informazioni .
ConversationId stringa ID conversazione univoco
conversazioneLink stringa Link alla conversazione specificata nei registri delle conversazioni
httpStato numero Tipo di stato dell’errore
endpointUrl stringa L’URL scelto come target dall’integrazione backend

Configurazione webhook

È possibile accedere alla configurazione del webhook nelle impostazioni agenti AI> Generale> Webhook . È visibile solo ai clienti aziendali.

Per configurarlo, segui le istruzioni seguenti:

  1. Nello spazio di lavoro Agenti AI , vai a Impostazioni agenti AI> Generale> Webhook
  2. Copia e incolla l’URL del webhook dallo strumento dati nel campo definito. Tieni presente che sono consentiti solo URL https .
  3. Fai clic su Mostra token e usa il token di autenticazione per recuperare correttamente i messaggi di avviso nello strumento dati.
  4. Fai clic su Usa webhook per monitorare le prestazioni agenti AI per attivare la funzionalità.
  5. Salva le impostazioni aggiornate agenti AI . Il pulsante Webhook di prova dovrebbe essere abilitato ora.
  6. Fai clic su Prova webhook per inviare un evento di prova all’URL specificato come URL webhook . L’ultimo passaggio è facoltativo ma consigliato. 

 

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.

Powered by Zendesk