Creazione di un flusso di dialogo specifico per l'integrazione

Creare una singola finestra di dialogo ottimizzata per utilizzare le migliori funzioni offerte da ogni canale o interfaccia client in cui viene distribuita.

È possibile personalizzare la conversazione nei seguenti modi:

• Per aggiungere un intero ramo del dialogo che viene elaborato solo da uno specifico tipo di integrazione, aggiungi la variabile di contesto del tipo di integrazione appropriata, come ad esempio $integrations.chat, nel campo Se l'assistente riconosce del nodo root del dialogo.

• Per aggiungere un singolo nodo di dialogo che viene elaborato solo da uno specifico tipo di integrazione, aggiungi la variabile di contesto del tipo di integrazione appropriata, come ad esempio $integrations.zendesk, al campo Se l'assistente riconosce del nodo child del dialogo.

• Per aggiungere risposte leggermente diverse per un singolo nodo di dialogo in base al tipo di integrazione, completa la seguente procedura:

  • Dalla vista di modifica del nodo, fare clic su Personalizza e impostare l'opzione Risposte condizionate multiple su Attivo. Fai clic su Apply.

  • Nella sezione di risposta del nodo di dialogo, aggiungi la condizione appropriata e la risposta corrispondente per ogni tipo di risposta personalizzata.

    I seguenti esempi mostrano come specificare un collegamento ipertestuale nel formato migliore per l'integrazione in cui viene visualizzata la risposta di testo. Per l'integrazione Web chat, che supporta la formattazione Markdown, è possibile includere un'etichetta di link nel testo della risposta per rendere la risposta più bella. Per l'integrazione SMS con Twilio, puoi saltare la formattazione che ha senso in una pagina web e aggiungere l'URL dritto.

    Risposte condizionate personalizzate

    Tipo di integrazione	Condizione	Risposta di testo di esempio
    SMS con Twilio	$integrations.text_messaging	For more information, go to https://www.ibm.com.
    Conversazione Web	$integrations.chat	For more information, go to [the ibm.com site](https://www.ibm.com).
    Risposta per mostrare se non sono soddisfatte altre condizioni.	true	For more information, go to ibm.com.

I tipi di risposta rich spesso si comportano in modo diverso quando vengono visualizzati in diverse integrazioni integrate o nell'anteprima dell'assistente.

Se devi fornire risposte personalizzate per canali diversi e non hai bisogno di modificare il tuo flusso di dialogo in base a quale integrazione è in uso, puoi anche utilizzare l'array channels per indirizzare le tue risposte a integrazioni specifiche.

Chat web: accesso ai dati sensibili

Se abiliti la sicurezza per la chat web, puoi configurare l'implementazione della tua chat web per inviare dati crittografati al dialogo. I dati del payload inviati dalla chat web vengono archiviati in una variabile di contesto privata denominata context.integrations.chat.private.user_payload. Nessuna variabile privata viene inviata dal dialogo alle integrazioni. Per ulteriori informazioni su come passare i dati, consulta Codifica dei dati sensibili nella chat web.

Per accedere ai dati del payload, puoi fare riferimento all'oggetto context.integrations.chat.private.user_payload dalla condizione del nodo di dialogo.

Devi conoscere la struttura dell'oggetto JSON inviato nel payload.

Ad esempio, se hai passato il valore "mvp:true" nel payload JSON, puoi aggiungere un flusso di dialogo che verifica questo valore per definire una risposta che sia destinata solo ai clienti VIP. Aggiungi un nodo di dialogo con una condizione simile alla seguente:

Chat Web: accesso alle informazioni del browser Web

Quando si utilizza l'integrazione della chat web, le informazioni sul browser web che il cliente sta utilizzando per accedere alla chat web vengono raccolte e memorizzate automaticamente. Le informazioni vengono memorizzate nell'oggetto context.integrations.chat.browser_info.

È possibile progettare la propria finestra di dialogo per sfruttare i dettagli relativi al browser Web in uso. Le seguenti proprietà vengono prese dall'oggetto window che rappresenta la finestra in cui è in esecuzione la chat Web:

• browser_name: il nome del browser, ad esempio chrome, edge o firefox.
• browser_version: la versione del browser, ad esempio 80.0.0.
• browser_OS: il sistema operativo del computer del cliente, ad esempio Mac OS.
• language: il codice locale predefinito del browser, ad esempio en-US.
• page_url: URL completo della pagina Web in cui è integrata la chat Web. Ad esempio, https://www.example.com/products
• screen_resolution: specifica l'altezza e la larghezza della finestra del browser in cui viene visualizzata la pagina web. Ad esempio, width: 1440, height: 900
• user_agent: contenuto dall'intestazione della richiesta User - Agent. Ad esempio, Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:80.0) Gecko/20100101 Firefox/80.0
• client_ip_address: indirizzo IP del computer del cliente. Ad esempio, 183.49.92.42

Chat web: riutilizzo del JWT per l'autenticazione webhook

Puoi utilizzare lo stesso JWT (JSON Web Token) utilizzato per proteggere la tua chat web per autenticare le chiamate webhook. Se specifichi un token nella proprietà identityToken quando aggiungi la chat web alla tua pagina web, il token viene archiviato in una variabile privata denominata context.integrations.chat.private.jwt. Per ulteriori informazioni sul passaggio di un JWT, consultare Abilitazione della sicurezza della chat web.

1. Nella finestra di dialogo, aprire Webhook.

2. Fare clic su Aggiungi intestazione.

3. In Nome intestazione, immettere qualsiasi nome, ad esempio JWT.

4. Nel campo Header value, aggiungi $integrations.chat.private.jwt.