{"id":156,"date":"2020-11-06T15:17:55","date_gmt":"2020-11-06T15:17:55","guid":{"rendered":"https:\/\/docs.tellya.ai\/?post_type=ht_kb&#038;p=156"},"modified":"2022-12-20T16:48:13","modified_gmt":"2022-12-20T16:48:13","slug":"connettori","status":"publish","type":"ht_kb","link":"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/","title":{"rendered":"Connettori"},"content":{"rendered":"\n<p>I connettori sono i vari elementi che costituisco il flusso logico e di processo delle richieste degli utenti e vengono elencati nella colonna di destra della sezione Process Flows, raggruppati per tematica.<\/p>\n\n\n\n<p>Selezionando un connettore dalla lista viene visualizzata la relativa configurazione. Al salvataggio di tale configurazione, il connettore aggiunto all\u2019area di lavoro. Posizionando il mouse sul connettore appena inserito e selezionando le relative icone \u00e8 possibile:<\/p>\n\n\n\n<ul><li>Modificarne il comportamento variando i parametri di configurazione<\/li><li>Eliminare il connettore<\/li><li>Sposare il connettore in una posizione differente dell&#8217;area di lavoro (compatibilmente con le <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/relazioni-tra-connettori\/\" data-type=\"ht_kb\" data-id=\"1454\">relazioni che intercorrono tra di essi<\/a>).<\/li><\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Molti connettori possono sfruttare alcuni valori variabili estratti dalla sessione conversazionale, i quali permettono una configurazione pi\u00f9 flessibile dei connettori stessi. Per approfondire fare riferimento alla sezione <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" data-type=\"ht_kb\" data-id=\"58\">Variabili connettori<\/a>.<\/p>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/action-mapping.png\" class=\"connector-logo\"><h2 class=\"connector-title\">Action mapping<\/h2>\n\n\n\n<p>Il connettore Action mapping consente di gestire diverse tipologie di azioni direttamente con i connettori presenti in Tellya. Inserito il connettore all&#8217;interno della propria journey \u00e8 possibile creare nuove azioni e percorsi dedicati. Queste azioni quindi possono essere affiancati a diversi intenti o elementi in Dialogflow.<\/p>\n\n\n\n<p>La configurazione avviene in una pagina che va a sovrapporsi al Process flow, cos\u00ec da avere tutto lo spazio necessario per personalizzare il proprio percorso. Al suo interno \u00e8 possibile inserire un set ristretto di connettori specifici, configurabili in modale come per il Process flow.<\/p>\n\n\n\n<p>Per navigare tra le azioni della journey \u00e8 possibile selezionarne una dall&#8217;apposita select o cercarlo cliccando sulla voce &#8220;Search action&#8221;, verr\u00e0 fornita una lista aggiornata in base all&#8217;input dell&#8217;utente.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Questo connettore non \u00e8 disponibile per le journey di tipo dispatcher<\/p>\n\n\n\n<p>Per creare un&#8217;azione \u00e8 necessario specificare diversi dati in base al motore di NLU utilizzato:<\/p>\n\n\n\n<h3 id=\"dialogflow-es\"><strong>Dialogflow ES <\/strong><\/h3>\n\n\n\n<ol><li>Inserire il connettore all&#8217;interno del Process Flow<\/li><li>Cliccare sui &#8220;setting&#8221; del connettore, si aprir\u00e0 una nuova schermata da cui \u00e8 possibile, in alto a destra, cliccare sul bottone &#8220;+ New&#8221;.<\/li><li>Verr\u00e0 mostrata una modale nella quale \u00e8 possibile inserire il solo nome della action, esso deve essere uguale alla <em>action <\/em>preimpostata su Dialogflow ES nella sezione \u201cAction and parameters\u201d<\/li><\/ol>\n\n\n\n<p>Cliccare su &#8220;Save&#8221; per confermare la creazione, verr\u00e0 aperto un nuovo spazio di lavoro in cui cominciare la personalizzazione della azione.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"996\" height=\"320\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES.png\" alt=\"\" class=\"wp-image-983\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES.png 996w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES-300x96.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES-768x247.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES-50x16.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES-60x19.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ES-100x32.png 100w\" sizes=\"(max-width: 996px) 100vw, 996px\" \/><\/figure>\n\n\n\n<h3 id=\"dialogflow-cx\"><strong>Dialogflow CX<\/strong><\/h3>\n\n\n\n<p><strong>Fulfilment<\/strong><\/p>\n\n\n\n<ol><li>Inserire il connettore all&#8217;interno del Process Flow<\/li><li>Cliccare sui &#8220;setting&#8221; del connettore, si aprir\u00e0 una nuova schermata da cui \u00e8 possibile, in alto a destra, cliccare su pulsante &#8220;+ New&#8221;<\/li><li>Verr\u00e0 mostrata una modale nella quale \u00e8 possibile inserire il solo nome della action, esso deve essere uguale al <em>tag <\/em>preimpostato su Dialogflow nella sezione relativa ai Webhook.<\/li><\/ol>\n\n\n\n<p>Cliccare su &#8220;Save&#8221; per confermare la creazione, verr\u00e0 aperto un nuovo spazio di lavoro in cui cominciare la personalizzazione della azione.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"995\" height=\"317\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX.png\" alt=\"\" class=\"wp-image-981\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX.png 995w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX-300x96.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX-768x245.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX-50x16.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX-60x19.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-ful-CX-100x32.png 100w\" sizes=\"(max-width: 995px) 100vw, 995px\" \/><\/figure>\n\n\n\n<p><strong>No Fulfillment<\/strong><\/p>\n\n\n\n<ol><li>Inserire il connettore all&#8217;interno del Process Flow<\/li><li>Cliccare sui &#8220;setting&#8221; del connettore, si aprir\u00e0 una nuova schermata da cui \u00e8 possibile, in alto a destra, cliccare su bottone &#8220;+ New&#8221;.<\/li><li>Verr\u00e0 mostrata una modale nella quale \u00e8 possibile inserire:<\/li><\/ol>\n\n\n\n<ul><li>&#8220;Action name&#8221;: Nome associato alla nuova azione creata<\/li><li>&#8220;Mapping&#8221;: Tabella in cui sar\u00e0 possibile inserire il percorso dal quale l&#8217;azione sar\u00e0 attivata, quindi \u00e8 possibile selezionare 3 livelli di percorso:<ul><li>Flow: selezionare il flusso<\/li><li>Page: selezionare la pagina (l&#8217;elenco va in base al flusso selezionato)<\/li><li>(optional): selezionare la route \/ intento (l&#8217;elenco va in base al flusso selezionato)<\/li><\/ul><\/li><\/ul>\n\n\n\n<ul><li>&#8220;Priority&#8221;: Un percorso mappato pu\u00f2 essere collegato a diverse azioni, quindi \u00e8 necessario definire un ordine di esecuzione. Una volta cliccato sul campo di input sar\u00e0 possibile visualizzare un elenco popup che mostra tutte le azioni gi\u00e0 inserite per quel percorso con relativo valore di priorit\u00e0 affianco (PRI).<br>E\u2019 possibile inserire un numero di priorit\u00e0 uguale ad un\u2019altra azione gi\u00e0 esistente, in questo caso verranno svolte in ordine di inserimento con la stessa priorit\u00e0 rispetto ai livelli inferiori.<\/li><\/ul>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"185\" height=\"152\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/same-route.png\" alt=\"\" class=\"wp-image-984\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/same-route.png 185w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/same-route-50x41.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/same-route-60x49.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/same-route-100x82.png 100w\" sizes=\"(max-width: 185px) 100vw, 185px\" \/><\/figure><\/div>\n\n\n<p>Cliccare su &#8220;Save&#8221; per confermare la creazione, verr\u00e0 aperto un nuovo spazio di lavoro in cui cominciare la personalizzazione della azione.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"995\" height=\"521\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX.png\" alt=\"\" class=\"wp-image-982\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX.png 995w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX-300x157.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX-768x402.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX-50x26.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX-60x31.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/new-action-no-ful-CX-100x52.png 100w\" sizes=\"(max-width: 995px) 100vw, 995px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Non tutti i connettori presenti in catalogo possono essere utilizzati nel connettore Action mapping<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/03\/code-editor.png\" class=\"connector-logo\"><h2 class=\"connector-title\">Code Editor<\/h2>\n\n\n\n<p>Con questo connettore \u00e8 possibile inserire codice e collegarlo ad altri componenti per creare journey pi\u00f9 complesse, aggiungendo nuovi livelli di logica.<\/p>\n\n\n\n<p>Si possono scegliere due possibili linguaggi:<\/p>\n\n\n\n<ul><li>Javascript<\/li><li>Groovy<\/li><\/ul>\n\n\n\n<p>Per permettere all\u2019utente di scrivere codice all\u2019interno del componente in maniera agevolata \u00e8 integrato all\u2019interno della modale un code editor che offre syntax highlighting per entrambi i linguaggi aiutando l\u2019utente ad individuare possibili errori durante la scrittura.<\/p>\n\n\n\n<p>Per Javascript inoltre sono integrate le funzionalit\u00e0 di autocompletamento e analisi statica del codice mostrando warning ed errori all\u2019utente.<\/p>\n\n\n\n<p>L\u2019utente non pu\u00f2 effettuare operazioni da Amministratore, per questo utilizzando sia Groovy che Javascript esiste una \u201cblacklist\u201d che permette di evitare l\u2019utilizzo di alcune classi.<\/p>\n\n\n\n<p>E\u2019 possibile personalizzare la visualizzazione del codice in base alle proprie esigenze utilizzando due selettori:<\/p>\n\n\n\n<ul><li><strong>Font size<\/strong> : ci sono 3 grandezze selezionabili (12px, 16px, 20px)<\/li><li><strong>Tema <\/strong>: per migliorare l\u2019esperienza di scrittura sono selezionabili due differenti temi<ul><li>Dark<\/li><li>Light<\/li><\/ul><\/li><\/ul>\n\n\n\n<p>[INFO BOX] Le impostazioni selezionate saranno resettate al salvataggio \/ chiusura della modale laterale.&nbsp;<\/p>\n\n\n\n<p>All\u2019interno dell\u2019editor si avr\u00e0 a disposizione delle parole chiavi che permettono di interagire con il prodotto Tellya:<\/p>\n\n\n\n<ul><li><strong>cache <\/strong>:<strong> <\/strong>servizio che espone due metodi per salvare e leggere degli oggetti in cache<ul><li><em>cache.get(Key) <\/em>\u2192 Recupera l\u2019oggetto nella cache associato alla chiave &lt;key&gt;&nbsp;<\/li><li><em>cache.put(key,object)<\/em> \u2192 crea\/aggiorna il valore associato alla chiave &lt;key&gt; con il valore object<\/li><\/ul><\/li><\/ul>\n\n\n\n<ul><li><strong>nluResult<\/strong> : contiene la risposta alla interazione con il motore NLU in uso.<\/li><\/ul>\n\n\n\n<p>I valori che possono essere reperiti sono quelli presenti all\u2019interno della risposta JSON<\/p>\n\n\n\n<h3>Dialogflow ES<\/h3>\n\n\n\n<div class=\"table-responsive\">\n    <table class=\"table api-table\">\n        <thead>\n            <tr>\n                <th scope=\"col\">JSON representation<\/th>\n            <\/tr>\n        <\/thead>\n        <tbody>\n            <tr class=\"json-example\">\n                <td>\n                    <pre><code>{  \n    <span class=\"str\">\"idMessage\"<\/span>: <span class=\"str\">\"94eb8048-1a12-4dbb-b08a-af0c93ccc9f0\"<\/span>,\n    <span class=\"str\">\"lang\"<\/span>: <span class=\"str\">\"it\"<\/span>,\n    <span class=\"str\">\"id\"<\/span>: <span class=\"str\">\"2a73d178-d728-410f-91b2-6d5858cfb105-53cb9be6\"<\/span>,\n    <span class=\"str\">\"timestamp\"<\/span>: <span class=\"str\">\"2022-03-04T10:40:17Z\"<\/span>,\n    <span class=\"str\">\"sessionId\"<\/span>: <span class=\"str\">\"1646390416431693FC151982\"<\/span>,\n    <span class=\"str\">\"result\"<\/span>: {      \n        <span class=\"str\">\"resolvedQuery\"<\/span>: <span class=\"str\">\"Welcome\"<\/span>,\n        <span class=\"str\">\"action\"<\/span>: <span class=\"str\">\"exampleAction\"<\/span>,\n        <span class=\"str\">\"score\"<\/span>: <span class=\"num\">1<\/span>,\n        <span class=\"str\">\"parameters\"<\/span>: {\n            <span class=\"str\">\"exampleParameter\"<\/span>: <span class=\"str\">\"name\"<\/span>\n        },\n        <span class=\"str\">\"contexts\"<\/span>: [\n            {\n                <span class=\"str\">\"lifespan\"<\/span>: <span class=\"num\">0<\/span>,\n                <span class=\"str\">\"name\"<\/span>: <span class=\"str\">\"context-name-1\"<\/span>,\n                <span class=\"str\">\"parameters\"<\/span>: {\n                    <span class=\"str\">\"context-parameter-name-1\"<\/span>: <span class=\"str\">\"context-parameter-value-1\"<\/span>\n                }\n            }\n        ],\n        <span class=\"str\">\"metadata\"<\/span>: {\n            <span class=\"str\">\"isFallbackIntent\"<\/span>: <span class=\"str\">\"false\"<\/span>,\n            <span class=\"str\">\"intentId\"<\/span>: <span class=\"str\">\"projects\/example\/agent\/intents\/\na5ef0e37-ff1e-45c4-bbba-8a297c79a28b\"<\/span>,\n            <span class=\"str\">\"intentName\"<\/span>: <span class=\"str\">\"Default Welcome Intent\"<\/span>,\n            <span class=\"str\">\"flow\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"landedPage\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"transitionPage\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"transitionRoute\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"event\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"webhookTag\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"webhookUsed\"<\/span>: <span class=\"str\">\"false\"<\/span>,\n            <span class=\"str\">\"webhookForSlotFillingUsed\"<\/span>: <span class=\"str\">\"false\"<\/span>,\n            <span class=\"str\">\"allRequiredParamsPresent\"<\/span>: <span class=\"bool\">true<\/span>,\n            <span class=\"str\">\"endOfConversation\"<\/span>: <span class=\"bool\">false<\/span>\n        },\n        <span class=\"str\">\"fulfillment\"<\/span>: {\n            <span class=\"str\">\"audioOutput\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"messages\"<\/span>: [\n                {\n                    <span class=\"str\">\"speech\"<\/span>: <span class=\"str\">null<\/span>,\n                    <span class=\"str\">\"text\"<\/span>: <span class=\"str\">\"Ciao sono il tuo assistente!\"<\/span>, \n                    <span class=\"str\">\"platform\"<\/span>: <span class=\"str\">\"PLATFORM_UNSPECIFIED\"<\/span>,  \n                    <span class=\"str\">\"order\"<\/span>: <span class=\"num\">0<\/span>,  \n                    <span class=\"str\">\"iterable\"<\/span>: <span class=\"str\">null<\/span>,\n                    <span class=\"str\">\"payload\"<\/span>: <span class=\"str\">null<\/span>\n                }  \n            ] \n        }\n    }    \n}\n<\/code><\/pre>\n                <\/td>\n            <\/tr>\n        <\/tbody>\n    <\/table>\n<\/div>\n\n\n\n<h3>Dialogflow CX<\/h3>\n\n\n\n<div class=\"table-responsive\">\n    <table class=\"table api-table\">\n        <thead>\n            <tr>\n                <th scope=\"col\">JSON representation<\/th>\n            <\/tr>\n        <\/thead>\n        <tbody>\n            <tr class=\"json-example\">\n                <td>\n                    <pre><code>{  \n    <span class=\"str\">\"idMessage\"<\/span>: <span class=\"str\">\"94eb8048-1a12-4dbb-b08a-af0c93ccc9f0\"<\/span>,\n    <span class=\"str\">\"lang\"<\/span>: <span class=\"str\">\"it\"<\/span>,\n    <span class=\"str\">\"id\"<\/span>: <span class=\"str\">\"2a73d178-d728-410f-91b2-6d5858cfb105-53cb9be6\"<\/span>,\n    <span class=\"str\">\"timestamp\"<\/span>: <span class=\"str\">\"2022-03-04T10:40:17Z\"<\/span>,\n    <span class=\"str\">\"sessionId\"<\/span>: <span class=\"str\">\"1646390416431693FC151982\"<\/span>,\n    <span class=\"str\">\"result\"<\/span>: {      \n        <span class=\"str\">\"resolvedQuery\"<\/span>: <span class=\"str\">\"Welcome\"<\/span>,\n        <span class=\"str\">\"score\"<\/span>: <span class=\"num\">1<\/span>,\n        <span class=\"str\">\"parameters\"<\/span>: {\n            <span class=\"str\">\"exampleParameter\"<\/span>: <span class=\"str\">\"name\"<\/span>\n        },\n        <span class=\"str\">\"metadata\"<\/span>: {\n            <span class=\"str\">\"isFallbackIntent\"<\/span>: <span class=\"str\">\"false\"<\/span>,\n            <span class=\"str\">\"intentId\"<\/span>: <span class=\"str\">\"\"<\/span>,\n            <span class=\"str\">\"intentName\"<\/span>: <span class=\"str\">\"\"<\/span>,\n            <span class=\"str\">\"flow\"<\/span>: {\n                <span class=\"str\">\"dfId\"<\/span>: <span class=\"str\">\"00000000-0000-0000-0000-000000000000\"<\/span>,\n                <span class=\"str\">\"name\"<\/span>: <span class=\"str\">\"Default Start Flow\"<\/span>,\n            }\n            <span class=\"str\">\"landedPage\"<\/span>: {\n                <span class=\"str\">\"dfId\"<\/span>: <span class=\"str\">\"projects\/example\/locations\/europe-west1\/agents\n                    \/5b675207-1111-1111-1111-1746331e8d66\/flows\n                    \/00000000-0000-0000-0000-000000000000\/pages\/START_PAGE\"<\/span>,\n                <span class=\"str\">\"name\"<\/span>: <span class=\"str\">\"Start Page\"<\/span>,\n            },\n            <span class=\"str\">\"transitionPage\"<\/span>: [    \n                {\n                <span class=\"str\">\"dfId\"<\/span>: <span class=\"str\">\"START_PAGE\"<\/span>,\n                <span class=\"str\">\"name\"<\/span>: <span class=\"str\">\"Start Page\"<\/span>,\n                }\n            ],\n            <span class=\"str\">\"transitionRoute\"<\/span>: <span class=\"str\">[]<\/span>,\n            <span class=\"str\">\"event\"<\/span>: {\n                <span class=\"str\">\"dfId\"<\/span>: <span class=\"str\">\"11d706c6-6c47-43e0-846f-5a26fbbd2aaf\"<\/span>,\n                <span class=\"str\">\"name\"<\/span>: <span class=\"str\">\"Welcome\"<\/span>,\n            },\n            <span class=\"str\">\"webhookTag\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"webhookUsed\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"webhookForSlotFillingUsed\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"allRequiredParamsPresent\"<\/span>: <span class=\"str\">\"false\"<\/span>,\n            <span class=\"str\">\"endOfConversation\"<\/span>: <span class=\"bool\">false<\/span>\n        },\n        <span class=\"str\">\"fulfillment\"<\/span>: {\n            <span class=\"str\">\"audioOutput\"<\/span>: <span class=\"str\">null<\/span>,\n            <span class=\"str\">\"messages\"<\/span>: [\n                {\n                    <span class=\"str\">\"speech\"<\/span>: <span class=\"str\">null<\/span>,\n                    <span class=\"str\">\"text\"<\/span>: <span class=\"str\">\"Benvenuto, sono l'assistente virtuale\"<\/span>, \n                    <span class=\"str\">\"platform\"<\/span>: <span class=\"str\">\"PLATFORM_UNSPECIFIED\"<\/span>,  \n                    <span class=\"str\">\"order\"<\/span>: <span class=\"num\">0<\/span>,  \n                    <span class=\"str\">\"iterable\"<\/span>: <span class=\"str\">null<\/span>,\n                    <span class=\"str\">\"payload\"<\/span>: <span class=\"str\">null<\/span>\n                }\n            ]\n        }\n    }    \n}\n<\/code><\/pre>\n                <\/td>\n            <\/tr>\n        <\/tbody>\n    <\/table>\n<\/div>\n\n\n\n<p>Facendo un esempio dalle risposte sopra riportate, per recuperare la lista dei messaggi si inserisce nell\u2019editor&nbsp;<strong>nluResult.result.fulfillment.messages<\/strong><\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/dev.tellya.ai\/images\/design-connectors\/connector_DLP.png\" class=\"connector-logo\"><\/img><h2 class=\"connector-title\">Data Loss Prevention<\/h2>\n\n\n\n<p>Il connettore Data Loss Prevention sfrutta l\u2019omonimo servizio cloud di Google e consente di rilevare ed oscurare nella conversazione dati potenzialmente sensibili. Tipicamente viene utilizzato per nascondere dati potenzialmente delicati forniti dall\u2019utente prima di memorizzarli all\u2019interno di database o sistemi esterni.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Quando viene inserito nella journey nasconde i dati sensibili prima di essere salvati nel database. Di conseguenza saranno nascosti anche nella <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/analizzare-lo-storico-delle-conversazioni-history\/\" target=\"_blank\" rel=\"noreferrer noopener\">history conversazionale<\/a> e nel <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/attivita-di-training\/\" target=\"_blank\" rel=\"noreferrer noopener\">training<\/a>.<\/p>\n\n\n\n<p>La finestra di configurazione si articola in due step:<\/p>\n\n\n\n<ol><li><strong>General setting<\/strong>, per configurare i parametri di base del servizio, in particolare:<ul><li><strong>Fields to encrypt<\/strong>: campi all\u2019interno dei quali ricercare potenziali contenuti da oscurare. Sono messe a disposizione alcune <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" target=\"_blank\">variabili di sistema<\/a><\/li><li><strong>Minimum characters<\/strong>: numero minimo di caratteri dopo cui effettuare l\u2019eventuale oscuramento<\/li><li><strong>Masking character<\/strong>: carattere che verr\u00e0 utilizzato per sostituire il contenuto oscurato<\/li><li><strong>Characters to skip<\/strong>: eventuali caratteri da non oscurare<\/li><li><strong>Redact in Response<\/strong>: i campi selezionati verranno oscurati anche nella risposta restituita all\u2019utente<\/li><\/ul><\/li><li><strong>Google infoType<\/strong>: \u00e8 possibile selezionare quali tipologie di contenuti oscurare tra quelle che l\u2019API di Google \u00e8 in grado di riconoscere. Per ciascuna di esse \u00e8 presente una descrizione di accompagnamento<\/li><li><strong>Custom infoType<\/strong>: \u00e8 possibile definire delle espressioni regolari custom cos\u00ec da poter identificare ed oscurare dei dati differenti rispetto a quelli previsti da Google. Per ciascuno di essi \u00e8 possibile aggiungere una descrizione di accompagnamento oltre che la definizione del nome per identificarla<\/li><\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Le espressioni regolari definite non possono avere vincoli posizionali, ovvero non \u00e8 possibile specificare regole per identificare un pattern all\u2019inizio o alla fine della frase.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/data-processing.png\" class=\"connector-logo connector-smtp\"><\/img><h2 class=\"connector-title\">Data Processing<\/h2>\n\n\n\n<p>Il connettore Data Processing permette di effettuare alcune operazioni sui dati estratti dal motore di NLU durante la conversazione e salvati all\u2019interno di parametri e\/o contesti della sessione conversazionale.<\/p>\n\n\n\n<p>In particolare \u00e8 possibile eseguire due tipologie di manipolazioni:<\/p>\n\n\n\n<ul><li><strong>Remove spaces<\/strong>: permette di rimuove eventuali spazi presenti all\u2019interno del valore testuale che si intende manipolare.<\/li><li><strong>Replace letters\/words<\/strong>: permette di sostituire una o pi\u00f9 lettere o parole presenti all\u2019interno del valore che si intente manipolare con una nuova lettera o parola.<\/li><\/ul>\n\n\n\n<p>Dopo aver aggiunto il connettore Data Processing all\u2019area di lavoro \u00e8 necessario indicare il campo che si intende manipolare. \u00c8 possibile scegliere tra:<\/p>\n\n\n\n<ul><li><strong>Parameter<\/strong>: quando si vuole manipolare un valore contenuto all\u2019interno di un parametro, del quale \u00e8 necessario specificare il nome (\u201cParameter name\u201d).<\/li><li><strong>Parameter from context<\/strong>: quando si vuole manipolare un valore di un parametro salvato all\u2019interno di un contesto. In questo caso sar\u00e0 necessario specificare sia il nome del contesto (\u201cContext name\u201d), sia il nome del parametro (\u201cParameter name\u201d).<\/li><\/ul>\n\n\n\n<p>Successivamente \u00e8 possibile indicare la tipologia e l\u2019ordine delle manipolazione da eseguire sul campo specificato precedentemente. L\u2019aggiunta di una nuova manipolazione si effettua selezionando il pulsante \u201c+Add manipulation\u201d.<\/p>\n\n\n\n<p>Ogni volta che viene premuto il pulsante viene inserita una manipolazione di tipo \u201cRemove spaces\u201d (la quale non richiede ulteriori configurazioni): \u00e8 possibile modificarne il tipo tramite il men\u00f9 a tendina.<\/p>\n\n\n\n<p>Selezionado la manipolazione \u201cReplace letters\/words\u201d \u00e8 necessario indicare:<\/p>\n\n\n\n<ul><li>Letters\/words to replace: una o pi\u00f9 lettere o parole da sostiutire (separate da una virgola).<\/li><li>Replace with: la lettera o parola con cui sostituire i valori indicati nel campo precedente.<\/li><\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Attenzione: per utilizzare le monipolazioni effettuate dal connettore Data Processing all\u2019interno di una risposta di un intento \u00e8 che tale risposta venga definita all\u2019interno della piattaforma Tellya e non all\u2019interno del motore di NLU.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/data-trasfer.png\" class=\"connector-logo connector-smtp\"><\/img><h2 class=\"connector-title\">Data Transfer<\/h2>\n\n\n\n<p>Il connettore Data Transfer consente di utilizzare i dati recuperati da una sorgente esterna, ad esempio tramite una chiamata a servizio realizzata utilizzando il connettore REST HTTP, ed utilizzare tali valori all&#8217;interno della sessione conversazionale.<\/p>\n\n\n\n<p>All&#8217;interno della finestra di configurazione del connettore \u00e8 infatti possibile definire una o pi\u00f9 azioni che permettono di memorizzare all&#8217;interno della sessione conversazionale i valori restituiti dal connettore posizionato precedentemente rispetto al connettore Data Transfer.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Questo connettore non \u00e8 disponibile per le journey di tipo dispatcher<\/p>\n\n\n\n<p>Per ogni azione \u00e8 necessario specificare diversi dati in base al motore di NLU utilizzato:<\/p>\n\n\n\n<h3 id=\"dialogflow-es\">Dialogflow ES<\/h3>\n\n\n\n<ol><li>ll percorso del payload da cui estrarre il dato, utilizzando se necessario la \u201cdot notation\u201d per navigare all\u2019interno del payload JSON (es. <em>nome-connettore.0.percorso<\/em>).<ul><li>Dove consentito, \u00e8 possibile utilizzare la <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#configurazione-di-una-risposta-dynamic\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#configurazione-di-una-risposta-dynamic\">lettura dinamica di un payload<\/a>, selezionando l\u2019opzione <strong>&#8220;Set as dynamic<\/strong>&#8220;.<\/li><li>Se necessario \u00e8 possibile inserire anche valori di parametro, contraddistinti dall\u2019utilizzo di doppi apici (&#8221; &#8220;). Questa opzione \u00e8 utile soprattutto per l\u2019utilizzo di parametri di default.<\/li><\/ul><\/li><li>La &#8220;entit\u00e0 logico-conversazionale&#8221; in cui memorizzare il valore estratto dal percorso specificato precedentemente:<ul><li><strong>Save in Cache<\/strong>: memorizza il valore all\u2019interno della cache<\/li><li><strong>Save in Context<\/strong>: memorizza il valore all&#8217;interno di un parametro di contesto. Se il contesto non esiste viene creato, altrimenti il parametro viene aggiunto o sovrascritto all&#8217;interno del contesto<\/li><li><strong>Save in Session Entity<\/strong>: memorizza il valore all&#8217;interno di una entit\u00e0 di sessione, eventualmente creandola se non presente<\/li><li><strong>Save in Parameters<\/strong>: memorizza il valore come parametro estratto all&#8217;interno della sessione conversazionale<\/li><li><strong>Clear Session Entity<\/strong>: Permette di resettare l&#8217;entit\u00e0 di sessione selezionata<\/li><\/ul><\/li><li>Il nome da assegnare alla &#8220;entit\u00e0 logico-conversazionale&#8221; precedentemente scelta, a seconda dell&#8217;azione scelta:<ul><li>Nel caso di \u201cCache\u201d \u00e8 necessario specificare il nome del parametro da salvare in memoria cache<\/li><li>Nel caso di &#8220;Save in Context&#8221; \u00e8 necessario specificare il nome del contesto e del parametro all&#8217;interno del quale memorizzare il valore, rispettando il formato <em>$sys.{contextName.parameterName}<\/em><\/li><li>Nel caso di &#8220;Session Entity&#8221; e &#8220;Clear Session Entity&#8221; \u00e8 necessario specificare il nome dell\u2019entit\u00e0 di sessione da popolare, selezionandola nella select<\/li><li>Nel caso di &#8220;Save in Parameters&#8221; \u00e8 necessario specificare il nome del parametro da popolare<\/li><\/ul><\/li><\/ol>\n\n\n\n<p class=\"has-text-align-center\"><img decoding=\"async\" loading=\"lazy\" width=\"602\" height=\"179\" src=\"https:\/\/lh3.googleusercontent.com\/9-PYDSZhHzTatApEmBvidfgJHRrDjs_7u-Kv_YQOyzDnzEOuuQynckz40RyOkjfY_0OewdXtKxkW_0Mu0gZ4Nw1EG7vTCtqpHA2Bryqqr6JfUiTrPgm0swpAW1ROB7OAKTKI4AEk\"><\/p>\n\n\n\n<h3 id=\"dialogflow-cx\">Dialogflow CX<\/h3>\n\n\n\n<ol><li>Il percorso del payload da cui estrarre il dato, utilizzando se necessario la &#8220;dot notation&#8221; per navigare all&#8217;interno del payload JSON (es. <em>nome-connettore.0.percorso<\/em>)<ul><li>Dove consentito, \u00e8 possibile utilizzare la <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#configurazione-di-una-risposta-dynamic\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#configurazione-di-una-risposta-dynamic\">lettura dinamica di un payload<\/a>, selezionando l\u2019opzione <strong>&#8220;Set as dynamic<\/strong>&#8220;.<\/li><li>Se necessario \u00e8 possibile inserire anche valori di parametro, contraddistinti dall\u2019utilizzo di doppi apici (&#8221; &#8220;). Questa opzione \u00e8 utile soprattutto per l\u2019utilizzo di parametri di default.<\/li><\/ul><\/li><li>La &#8220;entit\u00e0 logico-conversazionale&#8221; in cui memorizzare il valore estratto dal percorso specificato precedentemente:<ul><li><strong>Save in Cache<\/strong>: memorizza il valore all\u2019interno della cache<\/li><li><strong>Save in Session Entity<\/strong> : memorizza il valore all\u2019interno di un parametro legato all&#8217;intento, sar\u00e0 possibile sovrascrivere una entit\u00e0 gi\u00e0 esistente o crearne una che verr\u00e0 accodata alle pre-esistenti<\/li><li><strong>Save in Parameters<\/strong> <strong>(solo fulfillment)<\/strong>: memorizza il valore all\u2019interno di un parametro legato al parametro di sessione<\/li><li><strong>Clear Session Entity<\/strong>: Permette di resettare l\u2019entit\u00e0 di sessione selezionata<\/li><\/ul><\/li><li>Per il nome di tutti i percorsi disponibili \u00e8 necessario specificare il nome del parametro da popolare:<ul><li>Nel caso di &#8220;Cache&#8221; \u00e8 necessario specificare il nome del parametro da salvare in memoria cache<\/li><li>Nel caso di &#8220;Session Entity&#8221; \u00e8 necessario specificare il nome dell&#8217;entit\u00e0 di sessione da popolare<\/li><\/ul><ul><li>Nel caso di &#8220;Save in Parameters&#8221; \u00e8 necessario specificare il nome del parametro da popolare<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Per entrambe le tipologie di NLU:<\/p>\n\n\n\n<ul><li>Nel caso si vogliano trasferire tutte le chiavi del percorso specificato, sar\u00e0 possibile utilizzare l\u2019apposito selettore. Attivando tale opzione, campo &#8220;Save in field\u2026&#8221;, verr\u00e0 disabilitato.<\/li><li>Nel caso si selezionasse l&#8217;opzione &#8220;Save in Session entity&#8221;, l&#8217;input testuale verr\u00e0 sostituito da una un elenco contenente tutte le entit\u00e0 di sessione disponibili. In aggiunta sar\u00e0 possibile, tramite selezione, definire se l\u2019entit\u00e0 scelta dovr\u00e0 essere sovrascritta (flag) o semplicemente aggiunta a quelle gi\u00e0 esistenti (no flag).<\/li><\/ul>\n\n\n\n<h3 id=\"no-fulfillment\">Utilizzo output connettori<\/h3>\n\n\n\n<p>Per accedere al contenuto e alle informazioni precedentemente generate da alcuni connettori in modo tale da poterle utilizzare all&#8217;interno del connettore Data Transfer, \u00e8 necessario ricorrere ad una specifica sintassi che fa uso della <em>dot notation<\/em> per navigare all&#8217;interno del contenuto stesso.<\/p>\n\n\n\n<p>Ogni connettore salva i propri risultati all&#8217;interno di un oggetto identificato da un nome (cfr. la tabella sottostante), detto &#8220;chiave&#8221;, all&#8217;interno del quale \u00e8 possibile trovare tutte le informazioni generate da tale connettore<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Connettore<\/td><td>&#8220;Chiave&#8221; Data Transfer<\/td><\/tr><tr><td>REST HTTP<\/td><td>restHttp<\/td><\/tr><tr><td>Salesforce<\/td><td>zendesk<\/td><\/tr><tr><td>Zendesk<\/td><td>salesforce<\/td><\/tr><tr><td>User Data<\/td><td>userData<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Se nella journey da costruire vi \u00e8 la necessit\u00e0 di avere pi\u00f9 connettori dello stesso tipo (ad esempio due restHttp) \u00e8 importante selezionare a quale connettore in ordine si fa riferimento.Es: Nella journey sono inseriti due connettori di tipo restHttp. Sar\u00e0 necessario utilizzare il numero d\u2019ordine (a partire dall\u2019alto) dello stesso.<\/p>\n\n\n\n<p><br>Quindi per recuperare i dati del secondo connettore restHttp dovremo utilizzare la notazione \u2192 <em>restHttp.1.percorso<\/em><\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">\u00c9 importante ricordarsi che l&#8217;ordine dei connettori parte da 0.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/03\/dispatcher.png\" class=\"connector-logo connector-errorHandler\"><h2 class=\"connector-title\">Dispatcher<\/h2>\n\n\n\n<p>Il connettore \u201cDispatcher\u201d permette di configurare le dinamiche di smistamento supportate da una <em>journey <\/em>di tipo \u201c<a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\" rel=\"noreferrer noopener\">Dispatcher<\/a>\u201d, al fine di definire le modalit\u00e0 e le regole di trasferimento del dialogo da una <em>journey<\/em> all\u2019altra.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Il connettore \u201cDispatcher\u201d \u00e8 selezionabile solo all\u2019interno di una <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\" rel=\"noreferrer noopener\"><em>journey <\/em>di tipo \u201cDispatcher\u201d<\/a>.<\/p>\n\n\n\n<p>All\u2019inizio del dialogo tra utente ed agente virtuale, l\u2019elemento di chat che si occupa di inviare la richiesta utente verso Tellya (es. il canale \u201c<a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/channels\/#chat-widget\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/channels\/#chat-widget\" target=\"_blank\" rel=\"noreferrer noopener\">Chat Widget<\/a>\u201d), deve anche il parametro \u201cJourney code\u201d (identificato dal campo \u201ccurrentJourneyCode\u201d nell\u2019<a href=\"https:\/\/docs.tellya.ai\/index.php\/orchestrate-api\/\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/orchestrate-api\/\" target=\"_blank\" rel=\"noreferrer noopener\">API Orchestrate<\/a>) che identifica la <em>journey <\/em>di default da invocare alla prima interazione (tipicamente l\u2019intento di \u201cWelcome\u201d).<\/p>\n\n\n\n<p>Al parametro \u201cJourney code\u201d, il cui valore \u00e8 da scegliere arbitrariamente in fase di configurazione, deve corrispondere l\u2019indicazione che informa Tellya riguardo a quale journey invocare quando si presenta tale valore di parametro. Tale collegamento viene impostato sfruttando le prime due colonne della configurazione del connettore \u201cDispatcher\u201d:<\/p>\n\n\n\n<ul><li><strong>Parameters<\/strong>: valore del parametro che invier\u00e0 l\u2019elemento di chat verso Tellya<\/li><li><strong>Default Journey<\/strong>: <em>journey <\/em>che il \u201cDispatcher\u201d deve invocare quando l\u2019elemento di chat invia a Tellya il valore di parametro definito nel campo \u201cParameters\u201d.<\/li><\/ul>\n\n\n\n<p>Facendo riferimento all\u2019esempio quindi, se l\u2019elemento di chat invia come \u201cJourney Code\u201d\/\u201dParameters\u201d il valore \u201cAT\u201d, il connettore \u201cDispatcher\u201d indirizzer\u00e0 la conversazione verso la <em>journey<\/em> \u201cAssistenza Tecnica\u201d.<\/p>\n\n\n\n<p>Una volta configurato il collegamento alla &#8220;Default journey\u201d \u00e8 possibile procedere con la configurazione delle altre journey a cui \u00e8 possibile che che l\u2019utente venga trasferito mentre sta dialogando con la &#8220;Default journey\u201d (nell\u2019esempio la <em>journey<\/em> \u201cAssistenza Tecnica\u201d).<\/p>\n\n\n\n<p>In particolare, all\u2019interno dell\u2019agent configurato nella &#8220;Default journey\u201d, sar\u00e0 possibile contrassegnare tramite Tag alcuni elementi (intenti, page, route\u2026): quando il flusso conversazionale transiter\u00e0 per tali elementi, verr\u00e0 innescato il passaggio ad una <em>journey<\/em> (e quindi ad un agent) differente.<\/p>\n\n\n\n<p>A tale scopo \u00e8 possibile sfruttare le ultime due colonne della configurazione del connettore \u201cDispatcher\u201d:<\/p>\n\n\n\n<ul><li><strong>Dispatcher code (Tag)<\/strong>: valore utilizzato per contrassegnare l\u2019elemento e che determina una transizione verso una <em>journey<\/em> differente.<\/li><li><strong>Switch journey<\/strong>: journey che il \u201cDispatcher\u201d dovr\u00e0 invocare quando il Tag associato ad un elemento dell\u2019agente della \u201cDefault journey\u201d assume il valore specificato come \u201cDispatcher code (Tag)\u201d<\/li><\/ul>\n\n\n\n<p>Facendo ancora riferimento all\u2019esempio quindi, se durante il dialogo con l\u2019agent configurato per la <em>journey<\/em> \u201cAssistenza Tecnica\u201d si transita per un elemento contrassegnato dal Tag con valore \u201cCO\u201d, il \u201cDispatcher\u201d effettuer\u00e0 la transizione verso la <em>journey<\/em> \u201cConsumer\u201d che si occuper\u00e0, attraverso il suo agente, di rispondere alle successive richieste dell\u2019utente.<\/p>\n\n\n\n<p>\u00c8 possibile configurare pi\u00f9 transizioni attivabili dalla \u201cDefault journey\u201d (tramite il pulsante \u201c+Add\u201d): nell\u2019esempio \u00e8 stato anche configurato un possibile passaggio verso la journey \u201cCustomer Experience\u201d quando il Tag assume valore \u201cCX\u201d.<\/p>\n\n\n\n<p>Analogamente \u00e8 inoltre possibile configurare diverse combinazioni di \u201cParameters\u201d &#8211; \u201cDefault Journey\u201d in modo da prevedere diverse <em>journey <\/em>di avvio della conversazione ed ulteriori transizioni tra <em>journey<\/em>.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh5.googleusercontent.com\/TLF77xkPs5DfDRMDd9EZ74X4kI7MRYFKvmUAyMzhJ9sKyixKh2R2ubcQGZoy6423b33NxQlelO77dYTQeE5YYqXeHQu_SM7bJGNWMbVm_LUOgzrR5EDYplUNo3OtPjsrg9kPbCGN\" alt=\"\"\/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Come \u201cDefault Journey\u201d e \u201cSwitch\u201d journey possono essere selezionate unicamente <em>journey <\/em>Standard (non \u201cDispatcher\u201d o \u201cFulfillment\u201d).<\/p>\n\n\n\n<p>Per completare la configurazione del meccanismo del \u201cDispatcher\u201d e definire gli snodi conversazionali in cui effettuare il passaggio tra una <em>journey<\/em> e l\u2019altra \u00e8 necessario contrassegnare tali snodi sfruttando i <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/tag\/\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/tag\/\" target=\"_blank\" rel=\"noreferrer noopener\">Tag<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh5.googleusercontent.com\/Gu-gntIqugLdiyn_9I_nY0sX2mjHOahehtYnHgtxDxivF6QP28NagHeCb1yEjzlInITYZuUUi9XDzjgf-ySNVrIwy56E5GoQW-e_B61t8cIq2Yts1s_LTUj7mGWSXqcRZ66Ys-P4\" alt=\"\"\/><\/figure>\n\n\n\n<p>All\u2019interno della journey contrassegnata come \u201cDefault journey\u201d \u00e8 quindi necessario contrassegnare uno o pi\u00f9 snodi conversazionali (nell\u2019esempio l\u2019intento \u201cDispatch-to-CO\u201d) con un tag le seguenti caratteristiche:<\/p>\n\n\n\n<ul><li><strong>Category: <\/strong>\u201cDispatcher\u201d<\/li><li><strong>Name<\/strong>: uno dei valori definiti come \u201cDispatcher code (Tag)\u201d, a seconda della journey verso cui si desidera dirottare il dialogo una volta che lo snodo conversazionale viene raggiunto (nell\u2019esempio \u201cCO\u201d).<\/li><\/ul>\n\n\n\n<p>Se, nell&#8217;agente configurato per la <em>journey <\/em>\u201cCO\u201d, si vuole poter tornare alla journey che ha generato la transizione (nell\u2019esempio \u201cAT\u201d), \u00e8 possibile associare un tag <em>Category <\/em>\u201cDispatcher\u201d e <em>Name<\/em> \u201c{back}\u201d. Attraverso l\u2019impostazione di tale \u201cparola chiave\u201d (che per funzionare correttamente non pu\u00f2 essere modificata) in un determinato snodo conversazionale, Tellya si occuper\u00e0, attraverso il \u201cDispatcher\u201d di dirottare la conversazione tornando all\u2019agente originale di partenza.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/error-handler.png\" class=\"connector-logo connector-errorHandler\"><\/img><h2 class=\"connector-title\">Error Handler<\/h2>\n\n\n\n<p>Il connettore Error handler consente di gestire direttamente nel Process flow le operazioni da effettuare in caso di errore da parte di una chiamata REST HTTP, gestendo in un solo connettore diverse tipologie di codice errore.<\/p>\n\n\n\n<p>All&#8217;interno della schermata \u00e8 possibile modificare principalmente 3 elementi:<\/p>\n\n\n\n<ul><li><strong>Error code<\/strong>: in questo input \u00e8 possibile inserire il codice di errore da gestire con due possibili formattazioni<ul><li>Codice completo, quindi la cifra completa (es formattazione: 402, 403) dividendoli utilizzando una virgola tra uno e l&#8217;altro<\/li><li>Insieme di codici, facendo riferimento alla prima e\/o seconda cifra di errore, comprendendo tutti i possibili codici successivi (es formattazione: 40*, 5**)<\/li><\/ul><\/li><li><strong>Connector<\/strong>: tramite una select sar\u00e0 possibile selezionare i connettori che verranno eseguiti al verificarsi del codice precedentemente inserito. Sono con ordine &#8220;a scendere&#8221; e possono essere impostati aprendoli singolarmente Una volta cliccato sull&#8217;icona &#8220;setting&#8221; si accede alla modale classica di modifica. Nel caso si selezionasse il connettore sbagliato \u00e8 possibile rimuoverlo tramite l&#8217;icona &#8220;trash&#8221;<\/li><li><strong>Skip journey<\/strong>: questa checkbox permette di saltare i connettori successivi all&#8217;error handler in caso il codice di errore sia censito nell&#8217;elenco. Questo permette di evitare possibili stati di errore al proseguire della journey<br><em>Esempio<\/em>: come da immagine, se la checkbox \u201cSkip journey\u201d \u00e8 selezionata, al verificarsi dell\u2019errore 403 viene eseguito il percorso configurato per Error handler ma non il connettore Translate successivo, terminando di fatto la journey<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"575\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-1024x575.png\" alt=\"\" class=\"wp-image-979\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-1024x575.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-300x169.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-768x431.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-50x28.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-1536x863.png 1536w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-60x34.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata-100x56.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Error-Handler-schermata.png 1597w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Ogni riga della tabella pu\u00f2 essere eliminata, rimuovendo anche tutti i connettori ad essa associati tramite la croce (X) presente sulla sinistra.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Non tutti i connettori presenti in catalogo possono essere utilizzati nel connettore Error Handler<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/InvokeEvent.png\" class=\"connector-logo connector-eventCaller\"><\/img><h2 class=\"connector-title\">Event Caller<\/h2>\n\n\n\n<p>Il connettore Event Caller permette di invocare eventi.<\/p>\n\n\n\n<p>Event Caller ha due comportamenti diversi in base al connettore Dialogflow presente all\u2019interno della journey:<\/p>\n\n\n\n<ul><li><strong>Journey ES<\/strong>: se la journey \u00e8 di tipo ES, sar\u00e0 possibile configurare sia il nome dell\u2019evento, che i parametri da utilizzare.<\/li><\/ul>\n\n\n\n<ul><li><strong>Journey CX<\/strong>: se la journey \u00e8 di tipo CX, sar\u00e0 possibile configurare solo il nome dell\u2019evento.<\/li><\/ul>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Questo connettore non \u00e8 disponibile per le journey di tipo fulfillment e dispatcher<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/Generic-rule.png\" class=\"connector-logo connector-genericrule\"><\/img><h2 class=\"connector-title\">Generic Rule<\/h2>\n\n\n\n<p>Il connettore &#8220;Generic Rule&#8221; permette di innescare l&#8217;esecuzione di un flusso secondario di connettori, all&#8217;interno di una journey, solo al verificarsi di particolari condizioni. Tale connettore permette quindi di introdurre delle &#8220;esecuzioni condizionali&#8221; all&#8217;interno del normale flusso di processo e di esecuzione di una journey.<\/p>\n\n\n\n<p>La configurazione del connettore &#8220;Generic Rule&#8221; varia a seconda della tipologia di NLU utilizzato all&#8217;interno della journey, ma in tutti i casi viene richiesto di specificare una o pi\u00f9 condizioni che devono verificarsi al fine di innescare il flusso secondario (di cui viene richiesto di specificare il primo connettore da eseguire).<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Il connettore &#8220;Generic Rule&#8221; non \u00e8 disponibile all&#8217;interno delle journey di tipo &#8220;<a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\">dispatcher<\/a>&#8220;.<\/p>\n\n\n\n<h3 id=\"dialogflow-es\"><strong>Configurazione<\/strong><\/h3>\n\n\n\n<p>Dalla finestra di configurazione del connettore \u201cGeneric Rule\u201d \u00e8 possibile specificare:<\/p>\n\n\n\n<ul><li>Un <strong>nome <\/strong>da assegnare alla regola, in modo tale da distinguere il connettore pi\u00f9 facilmente all&#8217;interno della journey, nel caso in cui ne vengano configurati diversi<\/li><li>Una o pi\u00f9 <strong>condizioni <\/strong>che devono essere soddisfatte per poter innescare il flusso secondario. Le condizioni possono essere valutate in <strong>congiunzione logica AND<\/strong> (&#8220;Match EVERY rule&#8221;), caso in cui tutte le condizioni configurate devono verificarsi per poter innescare il flusso secondario, oppure in <strong>disgiunzione logica OR<\/strong> (&#8220;Match AT LEAST ONE rule&#8221;), dove \u00e8 sufficiente che una sola delle condizione configurate venga verificata.<br>Per ogni condizione devono essere configurati i tre relativi campi:<ul><li><strong>Field type<\/strong>: campo o parametro conversazionale che deve essere verificato (scelto tra quelli elencati nella tabella sottostante)<\/li><li><strong>Operand<\/strong>: operatore logico di confronto<\/li><li><strong>Value<\/strong>: valore che il campo o parametro specificato in &#8220;Field type&#8221; deve assumere per considerare la condizione come verificata<\/li><\/ul><\/li><li><strong>Run the connector<\/strong>: il primo connettore del flusso secondario che deve essere eseguito al verificarsi delle condizioni configurate all&#8217;interno del connettore &#8220;Generic Rule&#8221;.<\/li><\/ul>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th class=\"has-text-align-left\" data-align=\"left\">Field type<\/th><th class=\"has-text-align-left\" data-align=\"left\">NLU<\/th><th class=\"has-text-align-left\" data-align=\"left\">Descrizione<\/th><\/tr><\/thead><tbody><tr><td class=\"has-text-align-left\" data-align=\"left\">$actionName<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<\/td><td class=\"has-text-align-left\" data-align=\"left\">Valore del campo \u201caction\u201d associato all\u2019intento innescato<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$[cachePath]<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<br>Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Percorso memorizzato all\u2019interno della cache<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">${contextName.paramName}<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome di un parametro contenuto all\u2019interno di un contesto<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$intentName<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome dell\u2019intento innescato<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$landedPage<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome della pagina di atterraggio al termine di una interazione<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$magnitude<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<br>Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Valore di <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#natural-language\" target=\"_blank\" rel=\"noreferrer noopener\">magnitude calcolato dal connettore Natural Language<\/a> (se presente all\u2019interno della journey)<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">${{paramName}}<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<br>Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome del parametro estratto durante il turno conversazione (nel caso di Dialogflow ES) o presenti nella sessione conversazionale come \u201c<a href=\"https:\/\/cloud.google.com\/dialogflow\/cx\/docs\/concept\/parameter#session\" data-type=\"URL\" data-id=\"https:\/\/cloud.google.com\/dialogflow\/cx\/docs\/concept\/parameter#session\" target=\"_blank\" rel=\"noreferrer noopener\">session parameters<\/a>\u201d (nel caso di Dialogflow CX)<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$route<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome della route innescata<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$sentiment<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<br>Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Valore di <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#natural-language\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#natural-language\" target=\"_blank\" rel=\"noreferrer noopener\">sentiment (score) calcolato dal connettore Natural Language<\/a> (se presente all\u2019interno della journey)<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$topic<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow ES<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome del <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/tag\/#tag-topic\" target=\"_blank\" rel=\"noreferrer noopener\">tag di tipo topic<\/a> associato all\u2019intento innescato<\/td><\/tr><tr><td class=\"has-text-align-left\" data-align=\"left\">$transitionPage<\/td><td class=\"has-text-align-left\" data-align=\"left\">Dialogflow CX<\/td><td class=\"has-text-align-left\" data-align=\"left\">Nome della pagina per la quale si \u00e8 transitati durante l\u2019interazione<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/smtp-server.png\" class=\"connector-logo connector-smtp\"><\/img><h2 class=\"connector-title\">Generic SMTP<\/h2>\n\n\n\n<p>Il connettore Generic SMTP consente di innescare l\u2019invio di un messaggio di posta elettronica di cui \u00e8 possibile definire le diverse caratteristiche e propriet\u00e0.<\/p>\n\n\n\n<p>Il wizard di configurazione si articola in tre step:<\/p>\n\n\n\n<ol><li>SMTP server, configurazioni relative al server di posta che effettuer\u00e0 l\u2019invio del messaggio di posta:<ul><li>Indirizzo dell\u2019host<\/li><li>Numero di porta del server<\/li><li>Username e password per l\u2019accesso<\/li><li>Eventuale alias da impostare<\/li><\/ul><\/li><li>Recipient, per configurare i dettagli del destinatario<ul><li>Indirizzo del destinatario<\/li><li>Eventuali indirizzi da aggiungere in copia conoscenza o copia conoscenza nascosta<\/li><\/ul><\/li><li>Content, per configurare le caratteristiche del messaggio:<ul><li>Oggetto del messaggio<\/li><li>Corpo del messaggio, il quale pu\u00f2 essere un testo semplice oppure un template HTML.<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Nel caso si selezioni l\u2019opzione template HTML come corpo del messaggio \u00e8 possibile anche definire, all\u2019interno della tabella che appare nella parte inferiore della modale, i valori che sostituiranno le eventuali chiavi presenti nel template.<\/p>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2020\/11\/connector-dialogflow.png\" class=\"connector-logo connector-df\"><h2 class=\"connector-title\">Google Dialogflow ES<\/h2>\n\n\n\n<p>Il connettore Google Dialogflow ES permette di inserire all\u2019interno della journey un agente virtuale creato tramite la piattaforma conversazionale Dialogflow ES di Google.<\/p>\n\n\n\n<p>Aggiungendo un nuovo connettore di questo tipo all\u2019area di lavoro \u00e8 possibile, accedendo alle sue impostazioni, selezionare quale agente Dialogflow ES utilizzare all\u2019interno della journey tra quelli disponibili all\u2019interno del proprio account Tellya.<\/p>\n\n\n\n<p>Accedendo successivamente alla configurazione di tale connettore vengono messe a disposizione due opzioni:<\/p>\n\n\n\n<ul><li>&#8220;Switch agent&#8221;: permette di modificare l\u2019agente Dialogflow ES assegnato alla journey. Prima di concludere tale operazione \u00e8 possibile esportare in locale tutti i dati relativi agli intenti (risposte, tag, ecc&#8230;) e la cronologia conversazionale.<br>Inoltre \u00e8 possibile mantenere o eliminare tutti i dati analitici e conversazionali dell&#8217;agente precedente.<\/li><li>&#8220;Import agent data&#8221;: permette di importare delle configurazioni relative agli intenti all\u2019interno dell\u2019attuale agente Dialogflow ES assegnato alla journey<\/li><\/ul>\n\n\n\n<h3 id=\"switch-agent\">Switch agent<\/h3>\n\n\n\n<p>La modifica dell\u2019agente associato ad una journey si sviluppa in due passaggi:<\/p>\n\n\n\n<ol><li>&#8220;General Settings&#8221;: tramite il menu a tendina &#8220;Agent&#8221; \u00e8 possibile selezionare l&#8217;agente Dialogflow ES desiderato.<\/li><li>&#8220;Export data &amp; history&#8221;: \u00e8 possibile esportare le configurazioni relative agli intenti dell\u2019agente attualmente associato alla Journey (\u201cStatus\u201d degli intenti, configurazioni di risposte, tag associati&#8230;) e la relativa cronologia conversazionale. Tutte le configurazioni relative all\u2019agente definite all\u2019interno del progetto Dialogflow ES non subiranno invece modifiche.<\/li><\/ol>\n\n\n\n<p>Effettuando un cambio di agente vengono eliminate tutte le configurazioni relative agli intenti ma, di default, vengono mantenuti i dati statistici e analitici, oltre che la cronologia conversazionale. Tramite l&#8217;apposita opzione in &#8220;Export data &amp; history&#8221; \u00e8 invece possibile eliminare anche queste informazioni durante il cambio di agente.<\/p>\n\n\n\n<h3 id=\"import-agent-data\">Import agent data<\/h3>\n\n\n\n<p>Tramite l\u2019opzione \u201cImport agent data\u201d \u00e8 possibile caricare le configurazioni di un agente precedentemente esportato all\u2019interno dell\u2019agente attualmente configurato nella Journey.&nbsp;<\/p>\n\n\n\n<p>\u00c9 necessario importare un file in formato .xlxs, esportato ad esempio in una precedente operazione di \u201cSwitch agent\u201d. Affinch\u00e8 il caricamento delle informazioni sia valido, \u00e8 necessario che gli intenti del file caricato per cui sono presenti configurazioni (come tag o risposte) siano presenti anche nell\u2019agente in cui tali configurazioni verranno importate.<\/p>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/07\/connettore-dialogflow-cx.png\" class=\"connector-logo connector-df\"><h2 class=\"connector-title\">Google Dialogflow CX<\/h2>\n\n\n\n<p>Il connettore Google Dialogflow CX permette di inserire all\u2019interno della journey un agente virtuale creato tramite la piattaforma conversazionale Dialogflow CX di Google.<\/p>\n\n\n\n<p>Aggiungendo un nuovo connettore di questo tipo all\u2019area di lavoro \u00e8 possibile, accedendo alle sue impostazioni, selezionare quale agente Dialogflow CX utilizzare all\u2019interno della journey tra quelli disponibili all\u2019interno del proprio account Tellya.<\/p>\n\n\n\n<p>Accedendo successivamente al connettore, dopo aver selezionato un agente vengono messe a disposizione due opzioni:<\/p>\n\n\n\n<ul><li>&#8220;Switch agent&#8221;: permette di modificare l\u2019agente Dialogflow CX assegnato alla journey. Prima di concludere tale operazione \u00e8 possibile esportare in locale tutti i dati relativi all\u2019agente e la cronologia conversazionale.<br>Inoltre \u00e8 possibile mantenere o eliminare tutti i dati analitici e conversazionali dell&#8217;agente precedente.<\/li><li>\u201cImport agent data\u201d: permette di importare delle configurazioni relative agli intenti all\u2019interno dell\u2019attuale agente Dialogflow CX assegnato alla journey<\/li><\/ul>\n\n\n\n<h3>Switch agent<\/h3>\n\n\n\n<p>La modifica dell\u2019agente associato ad una journey si sviluppa in due passaggi:<\/p>\n\n\n\n<ol><li>&#8220;General Settings&#8221;: tramite il menu a tendina &#8220;Agent&#8221; \u00e8 possibile selezionare l&#8217;agente Dialogflow CX desiderato.<\/li><li>&#8220;Export data &amp; history&#8221;: \u00e8 possibile esportare le configurazioni relative all\u2019agente dell\u2019agente attualmente associato alla Journey (\u201cStatus\u201d degli elementi, tag associati&#8230;) e la relativa cronologia conversazionale. Tutte le configurazioni relative all\u2019agente definite all\u2019interno del progetto Dialogflow CX (come ad esempio le risposte) non subiranno invece modifiche.<\/li><\/ol>\n\n\n\n<p>Effettuando un cambio di agente vengono eliminate tutte le configurazioni ma, di default, vengono mantenuti i dati statistici e analitici, oltre che la cronologia conversazionale. Tramite l&#8217;apposita opzione in &#8220;Export data &amp; history&#8221; \u00e8 invece possibile eliminare anche queste informazioni durante il cambio di agente.<\/p>\n\n\n\n<h3>Import agent data<\/h3>\n\n\n\n<p>Tramite l\u2019opzione \u201cImport agent data\u201d \u00e8 possibile caricare le configurazioni di un agente precedentemente esportato all\u2019interno dell\u2019agente attualmente configurato nella Journey.&nbsp;<\/p>\n\n\n\n<p>\u00c8 necessario importare un file in formato .xlxs, esportato ad esempio in una precedente operazione di \u201cSwitch agent\u201d. Affinch\u00e9 il caricamento delle informazioni sia valido, \u00e8 necessario che gli elementi del file caricato per cui sono presenti configurazioni siano presenti anche nell\u2019agente in cui tali configurazioni verranno importate.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2020\/11\/connector-natural.png\" class=\"connector-logo\"><\/img><h2 class=\"connector-title\">Natural Language<\/h2>\n\n\n\n<p>Il connettore Natural Language consente di analizzare le richieste degli utenti sfruttando il servizio Natural Language API di Google, allo scopo di determinarne il \u201csentiment\u201d, ovvero l\u2019attitudine positiva o negativa di un\u2019interazione, fornendo un relativo punteggio.<\/p>\n\n\n\n<p>In particolare il \u201csentiment\u201d \u00e8 rappresentato da due valori:<\/p>\n\n\n\n<ul><li><strong>Score<\/strong>: punteggio che va da -1.0 (negativo) a 1.0 (positivo) corrispondente al valore dell\u2019inclinazione emotiva complessiva della frase analizzata<\/li><li><strong>Magnitude<\/strong>: indica la forza complessiva dell&#8217;emozione (<em>score<\/em>), all&#8217;interno del testo analizzato, sia positiva che negativa. Ogni espressione di emozione all&#8217;interno della frase analizzata contribuisce alla <em>magnitude <\/em>complessiva della frase (quindi testi pi\u00f9 lunghi potrebbero avere un valore di <em>magnitude<\/em> pi\u00f9 elevato).<\/li><\/ul>\n\n\n\n<p>Per ulteriori informazioni riguardo all\u2019analisi del \u201csentiment\u201d e l\u2019interpretazione dei valori \u00e8 possibile fare riferimento alla <a href=\"https:\/\/cloud.google.com\/natural-language\/docs\/basics#sentiment_analysis\">Documentazione Google<\/a>.<\/p>\n\n\n\n<p>Il comportamento e le logiche di analisi del connettore differiscono a seconda del motore di NLU selezionato e della tipologia di journey scelta:<\/p>\n\n\n\n<ul><li>Per journey <strong>Dialogflow CX<\/strong> Standard e Fulfillment \/ <strong>Dialogflow ES<\/strong> Standard<ul><li>L&#8217;analisi del sentiment viene eseguita unicamente quando l&#8217;interazione \u00e8 innescata da una query utente (testuale o vocale)<\/li><li>Vengono escluse le interazioni da eventi<\/li><\/ul><\/li><li>Per journey <strong>Dialogflow ES<\/strong> Fulfillment<ul><li>L&#8217;analisi del sentiment viene eseguita sempre, anche nel caso di evento, caso in cui la stringa analizzata \u00e8 il nome stesso dell&#8217;evento<\/li><\/ul><\/li><\/ul>\n\n\n\n<p>Il risultato dell\u2019analisi effettuata dal connettore Natural Language Understanding e i relativi valori di <em>sentiment<\/em> (<em>score<\/em>) e <em>magnitude <\/em>vengono visualizzati in differenti sezioni della piattaforma:<\/p>\n\n\n\n<ul><li><a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/analizzare-le-statistiche-relative-agli-intenti-intents\/\" data-type=\"ht_kb\" data-id=\"78\">Analytics &gt; Engagement<\/a>: vengono riportati i valori di sentiment e magnitude per ogni intento&nbsp;<\/li><li><a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/analizzare-lo-storico-delle-conversazioni-history\/\" data-type=\"ht_kb\" data-id=\"95\">Analytics &gt; History<\/a>: vengono riportati i valori di <em>sentiment <\/em>e <em>magnitude <\/em>per ogni interazione (se l\u2019interazione \u00e8 stata analizzata)<\/li><li>Training: vengono riportati i valori di <em>sentiment <\/em>e <em>magnitude <\/em>per ogni interazione all\u2019interno della <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/dettaglio-conversazione\/\" data-type=\"ht_kb\" data-id=\"113\">finestra di dettaglio di ogni sessione conversazionale<\/a> (se l\u2019interazione \u00e8 stata analizzata)<\/li><\/ul>\n\n\n\n<p>Inoltre, il risultato dell\u2019analisi di tale connettore viene sempre fornito in output dall\u2019<a href=\"https:\/\/docs.tellya.ai\/index.php\/orchestrate-api\/\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/orchestrate-api\/\">API \u201cOrchestrate\u201d<\/a>.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/12\/rest-http.png\" class=\"connector-logo connector-rest\"><h2 class=\"connector-title\">REST HTTP<\/h2>\n\n\n\n<p>Il connettore REST HTTP permette di eseguire delle chiamate REST verso servizi o API esterne. Il wizard di configurazione si articola in quattro step:<\/p>\n\n\n\n<ol><li><strong>General settings<\/strong>, deve essere specificato:<ul><li>Il <strong>metodo <\/strong>HTTP (POST\/GET\/PUT\/DELETE)<\/li><li>L\u2019<strong>URL<\/strong> della risorsa invocare<\/li><\/ul><\/li><li><strong>Headers<\/strong>, \u00e8 possibile specificare eventuali coppie chiave valore da specificare nell\u2019intestazione del messaggio HTTP.<\/li><li><strong>Query Params<\/strong>, \u00e8 possibile specificare eventuali argomenti del messaggio HTTP (coppie chiave\/valore).<\/li><li><strong>Payload<\/strong>, \u00e8 possibile specificare un eventuale corpo del messaggio HTTP.<\/li><\/ol>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/10\/Salesforce-logo.png\" class=\"connector-logo connector-rest\"><h2 class=\"connector-title\">Salesforce Sales Cloud<\/h2>\n\n\n\n<p>Il connettore \u201cSalesforce Service Cloud\u201d permette di gestire, tramite la conversazione, i contatti, i lead, le opportunit\u00e0 e gli account dei clienti, insieme al processo vendita.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Il connettore Salesforce Sales Cloud \u00e8 disponibile solo per il motore di NLU Dialogflow ES.<\/p>\n\n\n\n<p>Prima di procedere con la configurazione del connettore \u00e8 necessario aver creato una Connected App all\u2019interno del proprio account Salesforce.<\/p>\n\n\n\n<p>Una Connected App \u00e8 un framework che consente ad una piattaforma esterna di integrarsi con Salesforce tramite le sue API. Nel caso di Tellya, pu\u00f2 essere usata per interfacciarsi, attraverso una chat, alla piattaforma Salesforce tramite API. Per configurare una Connected App \u00e8 possibile fare riferimento alla <a href=\"https:\/\/help.salesforce.com\/s\/articleView?id=sf.connected_app_overview.htm&amp;type=5\" target=\"_blank\" rel=\"noreferrer noopener\">documentazione ufficiale<\/a> di Salesforce.<\/p>\n\n\n\n<p>Per poter configurare i seguenti passaggi accedere a Salesforce e navigare la sezione \u201cSetup\u201d &gt; \u201cApps\u201d &gt; \u201cApp Manager\u201d, selezionare quella desiderata e tramite il pulsante azione fare clic su \u201cview\u201d.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"436\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1024x436.png\" alt=\"\" class=\"wp-image-1193\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1024x436.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-300x128.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-768x327.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-50x21.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1536x655.png 1536w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-60x26.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-100x43.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps.png 1915w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"411\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-1024x411.png\" alt=\"\" class=\"wp-image-1194\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-1024x411.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-300x120.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-768x308.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-50x20.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-60x24.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings-100x40.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-general-settings.png 1148w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>La configurazione del connettore si articola in due passaggi:<\/p>\n\n\n\n<ol><li><strong>General setting<\/strong>, dedicato alla configurare dei parametri di base del servizio, in particolare:<ul><li><strong>Client ID<\/strong>: Chiave Utente corrispondente alla \u201cCustomer Key\u201d della Connected App di Salesforce<\/li><li><strong>Client Secret<\/strong>: Chiave Segreta corrispondente alla \u201cConsumer Secret\u201d della Connected App di Salesforce<\/li><li><strong>Callback URL<\/strong>: URL da inserire nell\u2019omonimo campo della sezione \u201cManage Connected Apps\u201d<\/li><li><strong>AUTH_CODE<\/strong>: Codice di autorizzazione generato tramite Salesforce, e visualizzato selezionando la voce \u201cAuthorize on Salesforce\u201d per autorizzare Tellya.<\/li><\/ul><\/li><li><strong>Actions &amp; fields,<\/strong> per configurare le azioni che si vogliono eseguire con gli account:<ul><li><strong>Query Object<\/strong>: si pu\u00f2 scegliere tra gli oggetti selezionabili nel men\u00f9 a tendina e descrive il tipo di operazione che si vuole eseguire. Per maggiori informazioni fare riferimento alla <a href=\"https:\/\/developer.salesforce.com\/docs\/atlas.en-us.api.meta\/api\/sforce_api_objects_list.htm\" target=\"_blank\" rel=\"noreferrer noopener\">documentazione<\/a> Salesforce.<\/li><li><strong>Type Query<\/strong>: permette di scegliere l\u2019azione che si vuole eseguire. Le scelte possibili sono: create, delete, select e update<\/li><li><strong>Action value<\/strong>: la \u201caction\u201d Dialogflow che viene configurata nell\u2019intento specifico e che permette di invocare l\u2019azione<\/li><li><strong>Field name<\/strong>: il nome del parametro sul quale si deve eseguire l\u2019azione, il men\u00f9 a tendina visualizzato permette la selezione tra i campi disponibili<\/li><li><strong>Value<\/strong>: il valore de che deve assegnato al field name&nbsp;<\/li><li><strong>Record ID<\/strong>: l\u2019identificativo del record che deve essere aggiornato o eliminato<\/li><li><strong>Query Result<\/strong>: a seguito di una ricerca indica quali informazioni restituire \u00e8 possibile anche selezionare la count dei vai record<\/li><li><strong>Group By<\/strong>: permette di aggregare i risultati della ricerca, cos\u00ec come offerto dalla sintassi SQL<\/li><li><strong>Clause Type<\/strong>: clausola condizionale per il tipo ricerca che si vuole effettuare<\/li><li><strong>Operator<\/strong>: operatore logico che permette di concatenare pi\u00f9 campi o clausole nella ricerca<\/li><\/ul><\/li><\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"539\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-1024x539.png\" alt=\"\" class=\"wp-image-1195\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-1024x539.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-300x158.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-768x404.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-50x26.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-60x32.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione-100x53.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-configurazione.png 1147w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div class=\"is-layout-flow wp-block-group\"><div class=\"wp-block-group__inner-container\">\n<div class=\"is-layout-flex wp-container-3 wp-block-columns\">\n<div class=\"is-layout-flow wp-block-column\">\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" loading=\"lazy\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat.png\" alt=\"\" class=\"wp-image-1196\" width=\"262\" height=\"444\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat.png 377w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat-177x300.png 177w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat-30x50.png 30w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat-35x60.png 35w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-Chat-59x100.png 59w\" sizes=\"(max-width: 262px) 100vw, 262px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"is-layout-flow wp-block-column\">\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"638\" height=\"890\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details.png\" alt=\"\" class=\"wp-image-1197\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details.png 638w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details-215x300.png 215w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details-36x50.png 36w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details-43x60.png 43w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Sales-account-details-72x100.png 72w\" sizes=\"(max-width: 638px) 100vw, 638px\" \/><\/figure>\n<\/div>\n<\/div>\n<\/div><\/div>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/10\/Salesforce-logo.png\" class=\"connector-logo connector-rest\"><h2 class=\"connector-title\">Salesforce Service Cloud<\/h2>\n\n\n\n<p>Il connettore \u201cSalesforce Service Cloud\u201d permette di gestire, tramite la conversazione, la creazione di un ticket di segnalazione o una richiesta di supporto all\u2019interno dell\u2019omonima piattaforma di assistenza clienti.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">&nbsp;Il connettore Salesforce Service Cloud \u00e8 disponibile solo per il motore di NLU Dialogflow ES.<\/p>\n\n\n\n<p>Prima di procedere con la configurazione del connettore \u00e8 necessario aver creato una Connected App all\u2019interno del proprio account Salesforce.<\/p>\n\n\n\n<p>Una Connected App \u00e8 un framework che consente ad una piattaforma esterna di integrarsi con Salesforce tramite le sue API. Nel caso di Tellya pu\u00f2 essere usata per interfacciarsi tramite chat alla piattaforma Salesforce tramite API. Per configurare una Connected App fare riferimento alla <a href=\"https:\/\/help.salesforce.com\/s\/articleView?id=sf.connected_app_overview.htm&amp;type=5\" target=\"_blank\" rel=\"noreferrer noopener\">documentazione ufficiale<\/a> di Salesforce.<\/p>\n\n\n\n<p>Per poter configurare i seguenti passaggi accedere a Salesforce e navigare la sezione \u201cSetup\u201d &gt; \u201cApps\u201d &gt; \u201cApp Manager\u201d. Selezionare l\u2019applicazione desiderata e tramite il pulsante azione fare clic su \u201cview\u201d.&nbsp;<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"436\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1024x436.png\" alt=\"\" class=\"wp-image-1193\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1024x436.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-300x128.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-768x327.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-50x21.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-1536x655.png 1536w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-60x26.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps-100x43.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/Manage_Connected_Apps.png 1915w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"411\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-1024x411.png\" alt=\"\" class=\"wp-image-1198\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-1024x411.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-300x120.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-768x308.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-50x20.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-60x24.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings-100x40.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-general-settings.png 1148w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>La configurazione del connettore si articola in due passaggi:<\/p>\n\n\n\n<ol><li><strong>General setting<\/strong>, dedicato alla configurare dei parametri di base del servizio, in particolare:<ul><li><strong>Client ID<\/strong>: Chiave Utente corrispondente alla \u201cCustomer Key\u201d della Connected App di Salesforce<\/li><li><strong>Client Secret<\/strong>: Chiave Segreta corrispondente alla \u201cConsumer Secret\u201d della Connected App di Salesforce<\/li><li><strong>Callback URL<\/strong>: URL da inserire nell\u2019omonimo campo della sezione \u201cManage Connected Apps\u201d<\/li><li><strong>AUTH_CODE<\/strong>: Codice di autorizzazione generato tramite Salesforce, e visualizzato selezionando la voce \u201cAuthorize on Salesforce\u201d per autorizzare Tellya.<\/li><\/ul><\/li><li><strong>Actions &amp; fields,<\/strong> dedicato alla configurare le azioni connesse al ticket:<ul><li><strong>Query Object<\/strong>: \u00e8 possibile scegliere tra l\u2019oggetto \u201cCase\u201d, che permette di gestire un ticket, e l\u2019oggetto \u201cCase comment\u201d, che permette di aggiungere un commento al ticket. Per maggiori informazioni fare riferimento alla <a href=\"https:\/\/developer.salesforce.com\/docs\/atlas.en-us.api.meta\/api\/sforce_api_objects_list.htm\" target=\"_blank\" rel=\"noreferrer noopener\">documentazione<\/a> Salesforce.<\/li><li><strong>Type Query<\/strong>: permette di scegliere l\u2019azione che si vuole eseguire. Le scelte possibili sono: create, delete, select e update<ul><li>Create: creazione di un nuovo case<\/li><li>Delete: cancellazione del case selezionato<\/li><li>Select; permette di ricercare un case dato un parametro<\/li><li>Update: permette di aggiornare le informazioni di un case<\/li><\/ul><\/li><li><strong>Action value<\/strong>: il valore \u201caction\u201d configurato all\u2019interno di uno o pi\u00f9 intenti in Dialogflow e che decreta l\u2019innesco dell\u2019azione.<\/li><li><strong>Field name<\/strong>: il nome del parametro sul quale si deve eseguire l\u2019azione, il men\u00f9 a tendina visualizzato permette la selezione tra i campi disponibili<\/li><li><strong>Value<\/strong>: il valore che deve assegnato al field name&nbsp;<\/li><li><strong>Record ID<\/strong>: l\u2019identificativo del record che deve essere aggiornato o eliminato<\/li><li><strong>Query Result<\/strong>: a seguito di una ricerca indica quali informazioni restituire. \u00c8 possibile anche selezionare il totale (\u201ccount\u201d) dei record<\/li><li><strong>Group By<\/strong>: permette di aggregare i risultati della ricerca, per uno dei parametri restituiti<\/li><li><strong>Clause Type<\/strong>: clausola condizionale per il tipo di ricerca che si vuole effettuare<\/li><li><strong>Operator<\/strong>: operatore logico che permette di concatenare pi\u00f9 campi o clausole nella ricerca<\/li><\/ul><\/li><\/ol>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"541\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-1024x541.png\" alt=\"\" class=\"wp-image-1199\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-1024x541.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-300x158.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-768x405.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-50x26.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-60x32.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione-100x53.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-configurazione.png 1146w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<div class=\"is-layout-flex wp-container-7 wp-block-columns\">\n<div class=\"is-layout-flow wp-block-column\">\n<figure class=\"wp-block-image size-full is-resized\"><img decoding=\"async\" loading=\"lazy\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat.png\" alt=\"\" class=\"wp-image-1200\" width=\"231\" height=\"397\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat.png 372w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat-175x300.png 175w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat-29x50.png 29w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat-35x60.png 35w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-chat-58x100.png 58w\" sizes=\"(max-width: 231px) 100vw, 231px\" \/><\/figure>\n<\/div>\n\n\n\n<div class=\"is-layout-flow wp-block-column\">\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"617\" height=\"763\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails.png\" alt=\"\" class=\"wp-image-1201\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails.png 617w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails-243x300.png 243w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails-40x50.png 40w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails-49x60.png 49w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/04\/SF-Service-case-datails-81x100.png 81w\" sizes=\"(max-width: 617px) 100vw, 617px\" \/><\/figure>\n<\/div>\n<\/div>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/connector_SG.png\" class=\"connector-logo\"><\/img><h2 class=\"connector-title\">SendGrid<\/h2>\n\n\n\n<p>Il connettore SendGrid permette di configurare l&#8217;invio di messaggi di posta elettronica attraverso l&#8217;omonimo servizio di &#8220;email automation&#8221;.<\/p>\n\n\n\n<p>La configurazione del connettore si articola in tre passaggi:<\/p>\n\n\n\n<ol><li><strong>Configurations<\/strong>, per configurare i parametri di base del servizio SendGrid, in particolare:<ul><li><strong>Api Key<\/strong>: generata dall&#8217;<a href=\"http:\/\/app.sendgrid.com\" target=\"_blank\" rel=\"noreferrer noopener\">interfaccia di amministrazione<\/a> SendGrid (Settings &gt; API Keys)<\/li><li><strong>Sender<\/strong>: indirizzo email mittente. L\u2019indirizzo specificato deve necessariamente essere <a href=\"https:\/\/docs.sendgrid.com\/ui\/sending-email\/sender-verification\" target=\"_blank\" rel=\"noreferrer noopener\">censito e verificato<\/a> all\u2019interno dell\u2019<a href=\"http:\/\/app.sendgrid.com\" target=\"_blank\" rel=\"noreferrer noopener\">interfaccia di amministrazione<\/a> SendGrid (Settings &gt; Sender Authentication)<\/li><\/ul><\/li><li><strong>Recipient<\/strong>, per configurare gli indirizzi destinatari del messaggio email:<ul><li><strong>Email recipient<\/strong>: indirizzo email destinatario<\/li><li><strong>CC<\/strong>: eventuale indirizzo email inserito in \u201ccopia conoscenza\u201d<\/li><li><strong>Ccn<\/strong>: eventuale indirizzo email inserito in \u201ccopia conoscenza nascosta\u201d<\/li><\/ul><\/li><li><strong>Content<\/strong>, per configurare il contenuto del messaggio inviato:<ul><li><strong>Subject<\/strong>: oggetto del messaggio<\/li><li>Corpo del messaggio, il quale pu\u00f2 essere costituito da un testo semplice (\u201c<strong>Plain Text<\/strong>\u201d) oppure da un template HTML (\u201c<strong>HTML template<\/strong>\u201d).<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Nel caso si selezioni l&#8217;opzione &#8220;HTML template&#8221; come corpo del messaggio \u00e8 possibile utilizzare tag HTML per formattare il messaggio e anche definire, all\u2019interno della sottostante tabella &#8220;Template Keys&#8221;, un elenco di valori (anche estratti come <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" data-type=\"ht_kb\" data-id=\"58\">variabile<\/a>) che andranno a sostituire le corrispondenti parti di testo eventualmente presenti nel corpo del messaggio.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img decoding=\"async\" loading=\"lazy\" width=\"817\" height=\"730\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html.png\" alt=\"\" class=\"wp-image-1347\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html.png 817w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html-300x268.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html-768x686.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html-50x45.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html-60x54.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/06\/sendGrid-config-html-100x89.png 100w\" sizes=\"(max-width: 817px) 100vw, 817px\" \/><\/figure>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2020\/11\/connector-translate.png\" class=\"connector-logo\"><\/img><h2 class=\"connector-title\">Translate<\/h2>\n\n\n\n<p>Il connettore Translate sfrutta le Cloud Translation API di Google per rilevare la lingua di un testo (tipicamente la richiesta dell\u2019utente) e\/o tradurlo in una lingua differente.<\/p>\n\n\n\n<p>La configurazione del connettore varia a seconda del tipo di azione selezionato:<\/p>\n\n\n\n<ul><li><strong>Rilevamento lingua<\/strong> (Detect language), dove \u00e8 possibile specificare:<ul><li>Campo del payload in input da analizzare e sul quale effettuare il rilevamento della lingua (obbligatorio).<\/li><li>Numero minimo di caratteri di cui deve essere composta la frase o la parola affinch\u00e9 venga attivato il connettore<\/li><li>Possibilit\u00e0 di sovrascrivere con il valore lingua rilevato dal connettore con un eventuale informazione relativa alla lingua proveniente da sistemi Front End.<\/li><li>Possibilit\u00e0 di effettuare il rilevamento della lingua solo alla prima interazione di ogni sessione.<\/li><\/ul><\/li><li><strong>Traduzione <\/strong>(Translate language), dove \u00e8 possibile specificare:<ul><li>Campo del payload in input da analizzare e sul quale effettuare il rilevamento della lingua (obbligatorio).<\/li><li>Lingua di traduzione<\/li><\/ul><\/li><\/ul>\n\n\n\n<h3 id=\"esempio-di-configurazione\">Esempio di configurazione<\/h3>\n\n\n\n<p>\u00c8 possibile configurare una <em>journey <\/em>utilizzando pi\u00f9 connettori Translate al fine di rendere \u201cmultilingua\u201d un agente configurato per gestire unicamente una lingua.<\/p>\n\n\n\n<p>Poniamo, ad esempio, di avere a disposizione un agente Dialogflow con intenti in lingua italiana, ma di voler comprendere anche le richieste utente che utilizzano una lingua differente e rispondere ad essi traducendo le risposte previste in italiano proprio nella lingua di interazione dell\u2019utente.<\/p>\n\n\n\n<p>Per rendere possibile tale meccanismo \u00e8 necessario configurare due connettori Translate posti rispettivamente prima e dopo un connettore Google Dialogflow ES.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"681\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-1024x681.png\" alt=\"\" class=\"wp-image-1057\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-1024x681.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-300x200.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-768x511.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-50x33.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-60x40.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain-100x67.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/02\/transalteChain.png 1040w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Il primo connettore Translate (posto prima del connettore Dialogflow) si occuper\u00e0 di tradurre la richiesta utente (qualunque sia la lingua) nella lingua comprensibile all\u2019agente (ad esempio l\u2019italiano, se l\u2019agente \u00e8 configurato con intenti in grado di comprendere tale lingua).<\/p>\n\n\n\n<p>\u00c8 quindi necessario indicare nel campo &#8220;Field to analyze&#8221; la <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" data-type=\"URL\" data-id=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" target=\"_blank\" rel=\"noreferrer noopener\">variabile<\/a> $userQuery, che ad ogni interazioni verr\u00e0 popolata con l&#8217;input inserito dall&#8217;utente e abilitare l&#8217;opzione &#8220;Override Front End language detection&#8221;, per demandare al connettore Transalte il riconoscimento della lingua dell&#8217;utente.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"809\" height=\"426\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1.png\" alt=\"\" class=\"wp-image-856\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1.png 809w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1-300x158.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1-768x404.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1-50x26.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1-60x32.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-1-100x53.png 100w\" sizes=\"(max-width: 809px) 100vw, 809px\" \/><\/figure>\n\n\n\n<p>Il secondo connettore Translate invece (posizionato dopo al connettore Dialogflow), si occuper\u00e0 di tradurre la risposta in italiano restituita da Dialogflow nella lingua di interazione dell\u2019utente, rilevata dal primo connettore Translate in fase di input (selezionando l&#8217;opzione &#8220;Use original user language&#8221;).<br>Il campo da analizzare quindi, sar\u00e0 in questo caso configurato con la <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" target=\"_blank\" rel=\"noreferrer noopener\">variabile <\/a>$outpuText.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"809\" height=\"425\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2.png\" alt=\"\" class=\"wp-image-858\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2.png 809w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2-300x158.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2-768x403.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2-50x26.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2-60x32.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/example-translate-2-100x53.png 100w\" sizes=\"(max-width: 809px) 100vw, 809px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Per verificare il corretto funzionamento dalla Test Chat di Tellya \u00e8 necessario, dalle impostazioni, abilitare l&#8217;opzione &#8220;Use translate result&#8221;, che restituisce all&#8217;utente la traduzione risultante dall&#8217;esecuzione del secondo connettore Translate.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/twilio.png\" class=\"connector-logo\"><h2 class=\"connector-title\">Twilio SMS<\/h2>\n\n\n\n<p>Il connettore Twilio SMS permette di configurare l\u2019invio di SMS tramite l\u2019omonimo servizio.<\/p>\n\n\n\n<p>La configurazione del connettore si articola in due passaggi:<\/p>\n\n\n\n<ol><li><strong>Configuration<\/strong>, per configurare i parametri di base del servizio Twilio, in particolare:<ul><li><strong>Account SID<\/strong>: generata dall\u2019<a href=\"https:\/\/console.twilio.com\/\">interfaccia di amministrazione<\/a> Twilio (Home &gt; Account Info)<\/li><li><strong>Auth Token<\/strong>: generata dall\u2019<a href=\"https:\/\/console.twilio.com\/\">interfaccia di amministrazione<\/a> Twilio (Home &gt; Account Info)<\/li><\/ul><\/li><li>Recipients &amp; Contents, per configurare i numeri di mittente e destinatario e il contenuto del messaggio da inviare:<ul><li><strong>Sender<\/strong>: numero di telefono del mittente, completo di prefisso internazionale(standard <a href=\"https:\/\/www.twilio.com\/docs\/glossary\/what-e164\">E.164<\/a>). Deve essere quello configurato nell\u2019<a href=\"https:\/\/console.twilio.com\/\">interfaccia di amministrazione<\/a> Twilio.<\/li><li><strong>Receiver<\/strong>: numero di telefono del destinatario, completo di prefisso internazionale(standard <a href=\"https:\/\/www.twilio.com\/docs\/glossary\/what-e164\">E.164<\/a>).<\/li><li><strong>SMS Text<\/strong>: corpo del messaggio da inviare. (max 1600 char. Se il corpo del messaggio contiene pi\u00f9 di 160 caratteri GSM-7 (o 70 caratteri UCS-2), Twilio invier\u00e0 il messaggio come un SMS suddiviso).<\/li><\/ul><\/li><\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Per i campi <strong>Sender <\/strong>e <strong>Receiver <\/strong>\u00e8 possibile non selezionare alcun valore per il campo \u201cprefisso\u201d e inserire il numero completo nell\u2019input \u201cSender\u201d o \u201cReceiver\u201d o recuperarlo dinamicamente dalla conversazione tramite i parametri.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"655\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-1024x655.png\" alt=\"\" class=\"wp-image-1365\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-1024x655.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-300x192.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-768x491.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-50x32.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-1536x983.png 1536w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-60x38.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS-100x64.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2022\/07\/Twilio-SMS.png 1610w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<hr class=\"wp-block-separator has-css-opacity is-style-wide\"\/>\n\n\n\n<img decoding=\"async\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/connector-zendesk.png\" class=\"connector-logo\"><\/img><h2 class=\"connector-title\">Zendesk<\/h2>\n\n\n\n<p>Il connettore Zendesk permette di creare, tramite la conversazione, un ticket di segnalazione o di richiesta supporto all\u2019interno dell\u2019omonima piattaforma di assistenza clienti.<\/p>\n\n\n\n<p>La configurazione del connettore si articola in due step:<\/p>\n\n\n\n<ol><li><strong>General setting<\/strong>, per configurare i parametri di base del servizio, in particolare:<ul><li>Zendesk Support URL: indirizzo del proprio &#8220;help center&#8221; Zendesk<\/li><li>Email: indirizzo mail associato all\u2019account<\/li><li>API token: generabile dall\u2019interfaccia di amministrazione Zendesk (Admin &gt; Channel &gt; API)<\/li><\/ul><\/li><li><strong>Ticket details<\/strong>, per configurare i dettagli del ticket (i quali possono essere anche estratti dalla conversazione sfruttando le <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/variabili-connettori\/\" data-type=\"ht_kb\" data-id=\"58\">Variabili connettori<\/a>):<ul><li>Subject: titolo\/oggetto della segnalazione<\/li><li>Body: corpo\/dettaglio della segnalazione<\/li><\/ul><\/li><\/ol>\n","protected":false},"excerpt":{"rendered":"<p>I connettori sono i vari elementi che costituisco il flusso logico e di processo delle richieste degli utenti e vengono elencati nella colonna di destra della sezione Process Flows, raggruppati per tematica. Selezionando un connettore dalla lista viene visualizzata la relativa configurazione. Al salvataggio di tale configurazione, il connettore aggiunto&#8230;<\/p>\n","protected":false},"author":3,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[22],"ht-kb-tag":[],"_links":{"self":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/156"}],"collection":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/comments?post=156"}],"version-history":[{"count":103,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/156\/revisions"}],"predecessor-version":[{"id":1545,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/156\/revisions\/1545"}],"wp:attachment":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/media?parent=156"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=156"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=156"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}