{"id":788,"date":"2021-03-29T14:21:05","date_gmt":"2021-03-29T14:21:05","guid":{"rendered":"https:\/\/docs.tellya.ai\/?post_type=ht_kb&#038;p=788"},"modified":"2022-10-27T09:08:47","modified_gmt":"2022-10-27T09:08:47","slug":"channels","status":"publish","type":"ht_kb","link":"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/channels\/","title":{"rendered":"Channels"},"content":{"rendered":"\n<h2 id=\"chat-widget\">Chat widget<\/h2>\n\n\n\n<p>Il canale \u201cChat widget\u201d permette di integrare la propria <em>journey <\/em>all\u2019interno di una pagina web o applicazione tramite script.<\/p>\n\n\n\n<p>Prima di essere incluso all\u2019interno della pagina, il modulo pu\u00f2 essere personalizzato specificando caratteristiche grafiche dell\u2019elemento che verr\u00e0 generato. \u00c8 possibile creare pi\u00f9 template differenti (tramite il bottone \u201cAdd Version\u201d), ma \u00e8 possibile attivare solo una versione alla volta (selezionabile tramite l&#8217;interruttore).<\/p>\n\n\n\n<p>Per ogni versione, oltre ad indicarne un nome che permetta di identificarla, \u00e8 possibile scegliere o definire:<\/p>\n\n\n\n<ul><li><strong>Headbar settings:<\/strong><ul><li><strong>Agent name: <\/strong>il nome dell\u2019agente che verr\u00e0 visualizzato nella barra superiore della finestra di dialogo<\/li><li><strong>Agent subtitle: <\/strong>il sottotitolo dell\u2019agente che verr\u00e0 visualizzato nella barra superiore della finestra di dialogo (opzionale)<\/li><li><strong>Titlebar background color: <\/strong>colore della barra superiore della chat\u00a0<\/li><li><strong>Titlebar color: <\/strong>colore del carattere della barra superiore della chat<\/li><\/ul><\/li><li><strong>Chat settings:<\/strong><ul><li><strong>Agent balloons font color: <\/strong>colore del carattere delle risposte fornite dall\u2019agente virtuale\u00a0<\/li><li><strong>Agent balloons background color: <\/strong>colore del fumetto di risposta dell\u2019agente\u00a0<\/li><li><strong>User balloons font color: <\/strong>colore del carattere delle interazioni dell\u2019utente\u00a0<\/li><li><strong>Agent balloons background color: <\/strong>colore del fumetto delle interazioni dell\u2019utente\u00a0<\/li><li><strong>Link color: <\/strong>colore dei link nel fumetto di risposta dell\u2019agente\u00a0<\/li><li><strong>Chat background color: <\/strong>colore di sfondo della chat\u00a0<\/li><\/ul><\/li><li><strong>Graphic element settings:<\/strong><ul><li><strong>Graphic background color: <\/strong>colore di sfondo delle risposte grafiche<\/li><li><strong>Graphic border color: <\/strong>colore del bordo delle risposte grafiche\u00a0<\/li><li><strong>Graphic title color: <\/strong>colore del titolo delle risposte grafiche di tipo <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#card-carousel\" target=\"_blank\" rel=\"noreferrer noopener\">card<\/a> e <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#list\" target=\"_blank\" rel=\"noreferrer noopener\">list<\/a>\u00a0<\/li><li><strong>Graphic subtitle color: <\/strong>colore del sottotitolo delle risposte grafiche di tipo <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#card-carousel\" target=\"_blank\" rel=\"noreferrer noopener\">card<\/a> e <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#list\" target=\"_blank\" rel=\"noreferrer noopener\">list<\/a>\u00a0<\/li><li><strong>Graphic body color: <\/strong>colore del testo delle risposte grafiche\u00a0<\/li><li><strong>Upload file color: <\/strong>colore del bordo e dell\u2019icona del <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#upload-file\" target=\"_blank\" rel=\"noreferrer noopener\">file upload<\/a>\u00a0<\/li><li><strong>Button background color: <\/strong>colore di sfondo del bottone azione delle risposte grafiche di tipo <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#card-carousel\" target=\"_blank\" rel=\"noreferrer noopener\">card<\/a>\u00a0<\/li><li><strong>Button font color: <\/strong>colore del testo o icone del bottone azione delle risposte grafiche di tipo <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#card-carousel\" target=\"_blank\" rel=\"noreferrer noopener\">card<\/a> e <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/rich-responses\/#list\" target=\"_blank\" rel=\"noreferrer noopener\">list<\/a>\u00a0<\/li><li><strong>Next button background color: <\/strong>colore di sfondo del pulsante next delle <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#paginazione-risposte-dynamic\" target=\"_blank\" rel=\"noreferrer noopener\">risposte grafiche paginate<\/a>\u00a0<\/li><li><strong>Next button font color: <\/strong>colore del testo del pulsante \u201cNext\u201d delle <a href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/responses\/#paginazione-risposte-dynamic\" target=\"_blank\" rel=\"noreferrer noopener\">risposte grafiche paginate<\/a><\/li><\/ul><\/li><li><strong>Footer settings:<\/strong><ul><li><strong>Input text background color: <\/strong>colore di sfondo dell\u2019area di input\u00a0<\/li><li><strong>Input text border color: <\/strong>colore del bordo dell\u2019area di input<\/li><li><strong>Input text font color: <\/strong>colore del testo dell\u2019area di input\u00a0<\/li><li><strong>Text placeholder: <\/strong>testo segnaposto visualizzato all\u2019interno dell\u2019area di input<\/li><li><strong>Icon color: <\/strong>colore delle icone di azione\u00a0<\/li><li><strong>Scrollbar color: <\/strong>colore della barra di scorrimento della chat<\/li><\/ul><\/li><\/ul>\n\n\n\n<ul><li><strong>Agent icon<\/strong>: immagine che raffigura e rappresenta l\u2019agente all\u2019interno dell\u2019elemento grafico che permette l\u2019avvio della chat (generato dal Chat Widget e posizionato in basso a destra nella pagina) e presente all\u2019interno della barra superiore quando viene aperta la chat<\/li><li><strong>Balloon avatar<\/strong>: (opzionale) immagine che raffigura e rappresenta l\u2019agente vicino al primo fumetto della risposta dell\u2019agente virtuale, se non inserita non viene visualizzata<\/li><\/ul>\n\n\n\n<p><meta charset=\"utf-8\">Dopo aver configurato l\u2019aspetto desiderato e possibile integrare il Widget all\u2019interno del proprio sistema con due diverse tipologie di implementazione:<\/p>\n\n\n\n<ul><li><strong>Embedded:<\/strong> script da inserire prima di chiudere il tag &lt;body> di una pagina web; genera automaticamente sia il pulsante per attivare e chiudere chiudere la chat oltre all\u2019interfaccia di chat stessa<\/li><li><strong>Iframe:<\/strong> link che permette di integrare il Widget tramite iframe. Sar\u00e0 poi necessario gestire l\u2019apertura e la chiusura della chat tramite pulsante o altra tipologia di trigger.<\/li><li><strong>Language:<\/strong> lingua di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a rel=\"noreferrer noopener\" href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><li><strong>Output audio<\/strong>: permette di ricevere le risposte dell&#8217;agente virtuale anche in formato audio<\/li><li><strong>Translate result<\/strong>: permette di ricevere le risposte tradotte in una lingua differente viene correttamente configurato il <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#translate\" target=\"_blank\">connettore Translate<\/a> all\u2019interno della <em>journey<\/em> invocata<\/li><li><strong>UserData:<\/strong> \u00e8 possibile inserire nel campo userData delle informazioni da mandare alla request del chat widget<\/li><\/ul>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale il Widget deve avviare la conversazione.<\/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 Chat Widget supporta input testuali composti da massimo 256 caratteri.<\/p>\n\n\n\n<h2 id=\"facebook-messenger\">Facebook Messenger<\/h2>\n\n\n\n<p>Il canale \u201cFacebook Messenger\u201d permette di integrare la propria <em>journey <\/em>all\u2019interno di una Pagina Facebook tramite la creazione di un&#8217;Applicazione Facebook.<\/p>\n\n\n\n<p>L\u2019integrazione si articola quindi attraverso quattro attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Creazione di un\u2019Applicazione Facebook utilizzando la piattaforma <a href=\"https:\/\/developers.facebook.com\/docs\/development\" target=\"_blank\" rel=\"noreferrer noopener\">Facebook App Development<\/a>.<\/li><li>Configurazione dell&#8217;Applicazione Facebook per l\u2019utilizzo della piattaforma Facebook Messenger. \u00c8 possibile seguire i passaggi descritti all\u2019interno della <a href=\"https:\/\/developers.facebook.com\/docs\/messenger-platform\/getting-started\/app-setup\" target=\"_blank\" rel=\"noreferrer noopener\">documentazione ufficiale<\/a>:<ul><li>Aggiungere la piattaforma Messenger all&#8217;Applicazione Facebook.<\/li><li>Sottoscrivere l\u2019Applicazione ad una Pagina Facebook. In questo passaggio viene fornito un token di accesso che verr\u00e0 utilizzato per configurare l&#8217;integrazione con Tellya.<\/li><li>Non configurare il Webhook e non testare ancora la l\u2019integrazione.<\/li><\/ul><\/li><\/ol>\n\n\n\n<ol start=\"3\"><li>All\u2019interno della piattaforma Tellya, attivare il canale &#8220;Facebook Messenger&#8221; tramite l\u2019interruttore e configurare le informazioni richieste dalla finestra di dialogo:<ul><li><strong>Callback URL<\/strong>: copiare il valore presente nel campo, il quale verr\u00e0 utilizzato per configurare il \u201cFacebook Messenger Webhook\u201d.<\/li><li><strong>Verify Token<\/strong>: \u00e8 possibile specificare un qualsiasi valore, il quale verr\u00e0 utilizzato per configurare il \u201cFacebook Messenger Webhook\u201d.<\/li><li><strong>Page Access Token<\/strong>: inserire l\u2019Access Token generato alla creazione della Pagina Facebook.<\/li><li><strong>App Secret<\/strong>: inserire l\u2019App Secret associato all\u2019Applicazione Facebook precedentemente creata.<\/li><li><strong>Language<\/strong>: lingua di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><li>Salvare la configurazione.<\/li><\/ul><\/li><li>Completare la configurazione dell&#8217;Applicazione Facebook seguendo la <a rel=\"noreferrer noopener\" href=\"https:\/\/developers.facebook.com\/docs\/messenger-platform\/getting-started\/app-setup\" target=\"_blank\">documentazione ufficiale<\/a>:<ul><li>Configurare il Webhook di Facebook per l\u2019Applicazione. Utilizzare il valori del Callback URL e il Verify Token presenti all\u2019interno della piattaforma Tellya, assicurandosi di abilitare <em>messagges<\/em> e <em>messaging_postbacks<\/em>.<\/li><li>Testare l\u2019applicazione.<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Facebook Messenger deve avviare la conversazione.<\/p>\n\n\n\n<h2 id=\"vivocha\">Vivocha<\/h2>\n\n\n\n<p>Il canale &#8220;Vivocha&#8221; permette di integrare la propria <em>journey <\/em>all\u2019interno dell\u2019omonima piattaforma di Digital Customer Interations.<\/p>\n\n\n\n<p>L\u2019integrazione permetter\u00e0 agli utenti di interagire con un agente virtuale Tellya tramite la piattaforma Vivocha, eventualmente con il supporto e l\u2019intervento all\u2019interno della conversazione di un operatore di contact center, se disponibile o necessario.<\/p>\n\n\n\n<h3 id=\"configurazione-base\">Configurazione base<\/h3>\n\n\n\n<p>Il processo di configurazione base ed integrazione si articola attraverso due attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Dalla finestra di configurazione del canale Vivocha all\u2019interno di Tellya specificare:<ul><li>Il valore della <strong>Secret Key<\/strong> (pu\u00f2 essere una qualunque stringa).<\/li><li>La <strong>language<\/strong> di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><\/ul><\/li><li>All\u2019interno della piattaforma Vivocha configurare una nuovo <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.vivocha.com\/docs\/vcb-external-services?id=bot-agents\" target=\"_blank\">Bot Agents<\/a> con le seguenti caratteristiche:<ul><li><strong>Engine<\/strong>: Custom<\/li><li><strong>Engine type<\/strong>: tellya<\/li><li><strong>URL<\/strong>: (\u201cCallback URL\u201d presente all\u2019interno della finestra di configurazione di Vivocha nella piattaforma Tellya)<\/li><li><strong>Authentication type<\/strong>: No authentication<\/li><li><strong>Settings<\/strong>: specificare un oggetto con le propriet\u00e0 \u201cjourneyKey\u201d (presente all\u2019interno delle configurazione della <em>journey <\/em>Tellya) e \u201csecretKey\u201d (\u201cSecret Key\u201d presente all\u2019interno della finestra di configurazione di Vivocha nella piattaforma Tellya).<\/li><\/ul><\/li><\/ol>\n\n\n\n<h4 id=\"esempio-di-configurazione\">Esempio di configurazione<\/h4>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"726\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-1024x726.png\" alt=\"\" class=\"wp-image-834\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-1024x726.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-300x213.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-768x544.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-50x35.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-60x43.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config-100x71.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/04\/vivocha-config.png 1047w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Vivocha deve avviare la conversazione.<\/p>\n\n\n\n<h3 id=\"configurazione-del-passaggio-all-operatore-di-contact-center\">Configurazione del passaggio all\u2019operatore di contact center<\/h3>\n\n\n\n<p>Selezionando l&#8217;opzione &#8220;Show transfer agent configuration&#8221; dalla finestra di configurazione Vivocha \u00e8 possibile definire quando l\u2019operatore di contact center deve intervenire all\u2019interno della conversazione.<\/p>\n\n\n\n<p>\u00c8 necessario specificare:<\/p>\n\n\n\n<ul><li><strong>Dialogflow action<\/strong>: nome dell\u2019azione che innesca il passaggio all\u2019operatore, definita all\u2019interno di tutti gli intenti del motore di NLU per i quali si vuole prevedere tale comportamento.<\/li><li>L\u2019associazione tra i tag di tipo Topic e gli <a href=\"https:\/\/github.com\/vivocha\/bot-sdk#about-vivocha-bots-and-transfers-to-human-agents\" target=\"_blank\" rel=\"noreferrer noopener\">agenti Vivocha<\/a> che si desidera invocare. Ci\u00f2 permette di effettuare il passaggio verso specifici operatori al verificarsi di particolari intenti.<\/li><\/ul>\n\n\n\n<h2 id=\"twilio-for-waba\">Twilio for WABA<\/h2>\n\n\n\n<p>Il canale \u201cTwilio for WABA\u201d permette, grazie all&#8217;integrazione con Twilio, di integrare la propria journey all\u2019interno di una chat WABA (WhatsApp Business Account) da configurare seguendo la <a rel=\"noreferrer noopener\" href=\"https:\/\/www.twilio.com\/docs\/whatsapp\/api#whatsapp-message-template-format\" target=\"_blank\">documentazione ufficiale<\/a>.<\/p>\n\n\n\n<p>Per poter integrare WhatsApp \u00e8 necessario <a href=\"https:\/\/www.twilio.com\/docs\/whatsapp\/tutorial\/connect-number-business-profile#a-note-for-isvs-sis-and-third-party-vendors\" target=\"_blank\" rel=\"noreferrer noopener\">acquistare un numero<\/a> Twilio, <a href=\"https:\/\/support.twilio.com\/hc\/en-us\/articles\/360052171393-Can-I-activate-my-own-phone-number-for-WhatsApp-on-Twilio-\" target=\"_blank\" rel=\"noreferrer noopener\">convertire il proprio numero<\/a> in un numero Twilio o avere un <a href=\"https:\/\/support.twilio.com\/hc\/en-us\/articles\/360052171393-Can-I-activate-my-own-phone-number-for-WhatsApp-on-Twilio-#:~:text=Number%20reachability%3A%20Your%20non%2DTwilio,to%20activate%20it%20for%20WhatsApp\" target=\"_blank\" rel=\"noreferrer noopener\">account BYON<\/a>.<\/p>\n\n\n\n<p>Il processo di configurazione base ed integrazione si articola in due attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Copiare il valore presente nel campo Callback URL, aprire Twilio e seguire il percorso <a rel=\"noreferrer noopener\" href=\"https:\/\/www.twilio.com\/console\/sms\/whatsapp\/senders\" target=\"_blank\">Programmable Messaging &gt; Senders &gt; WhatsApp Senders<\/a>, abilitare l\u2019opzione \u201cuse webhook\u201d e incollare il valore nel campo sottostante.<\/li><li>Nella finestra di configurazione del canale WhatsApp all\u2019interno di Tellya specificare il valore dell\u2019Auth Token presente all\u2019interno della Dashboard Twilio. Salvare la configurazione.<\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Twilio for WABA deve avviare la conversazione.<\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img decoding=\"async\" loading=\"lazy\" width=\"1024\" height=\"561\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-1024x561.png\" alt=\"\" class=\"wp-image-876\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-1024x561.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-300x164.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-768x420.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-50x27.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-60x33.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image-100x55.png 100w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/05\/image.png 1443w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">\u00c8 possibile testare l\u2019integrazione anche tramite sandbox, configurando il webhook come sopra.<\/p>\n\n\n\n<h2 id=\"tim-ready-contact-center\">TIM Ready Contact Center<\/h2>\n\n\n\n<p>&nbsp;Il canale \u201cTIM RCC\u201d permette di integrare la propria journey all\u2019interno della piattaforma di customer service TIM Ready Contact Center.<\/p>\n\n\n\n<p>L\u2019integrazione permetter\u00e0 agli utenti di interagire con un agente virtuale Tellya tramite la piattaforma TIM RCC, eventualmente con il supporto e l\u2019intervento all\u2019interno della conversazione di un operatore di contact center, se disponibile o necessario. Oltre a dare la possibilit\u00e0 di definire dei Topics per l\u2019instradamento all\u2019operatore competente.<\/p>\n\n\n\n<h3 id=\"configurazione-base\">Configurazione base<\/h3>\n\n\n\n<p>Il processo di configurazione base ed integrazione si articola attraverso due attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Dalla finestra di configurazione del canale TIM RCC all\u2019interno di Tellya specificare il valore dell\u2019<strong>Auth Token<\/strong> (pu\u00f2 essere una qualunque stringa).<\/li><li>All\u2019interno della piattaforma TIM RCC inserire il <strong>Callback URL<\/strong> presente nella finestra di configurazione di TIM RCC su Tellya e l\u2019Auth Token scelto. <strong>(TBD)<\/strong><\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale TIM RCC deve avviare la conversazione.<\/p>\n\n\n\n<h3 id=\"configurazione-del-passaggio-all-operatore-di-contact-center\">Configurazione del passaggio all\u2019operatore di contact center<\/h3>\n\n\n\n<p>Selezionando l\u2019opzione \u201cShow transfer agent configuration\u201d dalla finestra di configurazione TIM RCC \u00e8 possibile definire quando l\u2019operatore di contact center deve intervenire all\u2019interno della conversazione.<\/p>\n\n\n\n<p>\u00c8 necessario specificare:<\/p>\n\n\n\n<ul><li><strong>Dialogflow action<\/strong>: nome dell\u2019azione che innesca il passaggio all\u2019operatore, definita all\u2019interno di tutti gli intenti del motore di NLU per i quali si vuole prevedere tale comportamento.<\/li><li>L\u2019associazione tra i tag di tipo Topic e gli operatori TIM RCC che si desidera invocare. Ci\u00f2 permette di effettuare il passaggio verso specifici operatori al verificarsi di particolari intenti.<\/li><\/ul>\n\n\n\n<h2 id=\"liveperson\">LivePerson<\/h2>\n\n\n\n<p>Il canale \u201cLivePerson\u201d permette di integrare la propria journey all\u2019interno dell\u2019omonima piattaforma di Digital Customer Interactions.<\/p>\n\n\n\n<p>L\u2019integrazione permetter\u00e0 agli utenti di interagire con un agente virtuale Tellya tramite la piattaforma LivePerson, eventualmente con il supporto e l\u2019intervento all\u2019interno della conversazione di un operatore di contact center, se disponibile o necessario. Oltre a dare la possibilit\u00e0 di definire dei Topics per l\u2019handover tramite skills.<\/p>\n\n\n\n<p>Per il canale LivePerson sar\u00e0 possibile configurare un agent bot e agganciarlo alla journey.<\/p>\n\n\n\n<h3 id=\"configurazione-base\">Configurazione base<\/h3>\n\n\n\n<p>Il processo di configurazione base ed integrazione si articola attraverso due attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Dalla finestra di configurazione del canale LivePerson all\u2019interno di Tellya specificare:<ul><li>il valore dell\u2019<strong>AccountID<\/strong> di LivePerson.<\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/li><\/ul><\/li><li>All\u2019interno della piattaforma LivePerson configurare un nuovo Agent e inserire su Tellya le seguenti informazioni:<ul><li><strong>Username<\/strong><\/li><li><strong>AppKey<\/strong><\/li><li><strong>Secret<\/strong><\/li><li><strong>accessToken<\/strong><\/li><li><strong>accessTokenSecret<\/strong><\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale LivePerson deve avviare la conversazione.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\"><em>Non si pu\u00f2 utilizzare lo stesso agente LivePerson su pi\u00f9 journey.<\/em><\/p>\n\n\n\n<h3 id=\"configurazione-del-passaggio-all-operatore-di-contact-center\">Configurazione del passaggio all\u2019operatore di contact center<\/h3>\n\n\n\n<p>LivePerson gestisce tramite skills le aree di competenza degli operatori, quindi quando avviene il passaggio ad operatore la piattaforma rimanda la conversazione all\u2019operatore competente.<\/p>\n\n\n\n<p>Per abilitare il passaggio ad operatore selezionare l\u2019opzione \u201cShow transfer agent configuration\u201d dalla finestra di configurazione LivePerson \u00e8 definire quando l\u2019operatore di contact center deve intervenire all\u2019interno della conversazione.<\/p>\n\n\n\n<p>\u00c8 necessario specificare:<\/p>\n\n\n\n<ul><li>Dialogflow action: nome dell\u2019azione che innesca il passaggio all\u2019operatore, definita all\u2019interno di tutti gli intenti del motore di NLU per i quali si vuole prevedere tale comportamento.<\/li><li>L\u2019associazione tra i tag di tipo Topic e gli SkillID degli agenti che si desidera invocare. Ci\u00f2 permette di effettuare il passaggio verso specifici operatori al verificarsi di particolari intenti.<\/li><\/ul>\n\n\n\n<h3 id=\"monitoring-stato-agente\">Monitoring stato agente<\/h3>\n\n\n\n<p>Si pu\u00f2 verificare la corretta configurazione dell\u2019agente LivePerson e il suo stato nella sezione Monitoring, all\u2019interno della piattaforma Tellya. Per verificarla bisogna cliccare sulla scheda LivePerson e si aprir\u00e0 una modale che contiene le informazioni dell\u2019agente configurato, in caso di problemi \u00e8 possibile fare il restart dell\u2019agente e il refresh dello stato.<\/p>\n\n\n\n<h2 id=\"google-chat\">Google Chat<\/h2>\n\n\n\n<p>Il canale \u201cGoogle Chat\u201d permette di dialogare con un agente virtuale presente in una journey Tellya tramite l&#8217;applicazione di comunicazione <a rel=\"noreferrer noopener\" href=\"https:\/\/chat.google.com\" data-type=\"URL\" data-id=\"https:\/\/chat.google.com\" target=\"_blank\">Google Chat<\/a>, la quale supporta le interazioni con i bot anche all&#8217;interno di &#8220;stanze virtuali&#8221;, oltre che quelle con i singoli utenti.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Per abilitare le API di Google Chat \u00e8 necessario disporre di un account Google Workspace.<\/p>\n\n\n\n<h3 id=\"configurazione-base\">Configurazione base <\/h3>\n\n\n\n<p>La configurazione del canale si articola in quattro attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Creare un progetto <a rel=\"noreferrer noopener\" href=\"https:\/\/cloud.google.com\/resource-manager\/docs\/creating-managing-projects#creating_a_project\" data-type=\"URL\" data-id=\"https:\/\/cloud.google.com\/resource-manager\/docs\/creating-managing-projects#creating_a_project\" target=\"_blank\">Google Cloud Platform<\/a> (se non gi\u00e0 disponibile).<\/li><li>Dalla sezione &#8220;Libreria API&#8221; del progetto Google Cloud, abilitare il servizio &#8220;<a rel=\"noreferrer noopener\" href=\"https:\/\/console.cloud.google.com\/apis\/library\/chat.googleapis.com\" target=\"_blank\">Google Chat API<\/a>&#8220;.<br><br><img decoding=\"async\" loading=\"lazy\" width=\"791\" height=\"516\" class=\"wp-image-1038\" style=\"width: 1000px;\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2.jpg\" alt=\"\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2.jpg 791w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2-300x196.jpg 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2-768x501.jpg 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2-50x33.jpg 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2-60x39.jpg 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/gh-2-100x65.jpg 100w\" sizes=\"(max-width: 791px) 100vw, 791px\" \/><br><\/li><li> Dopo aver abilitato il servizio, completare la configurazione di &#8220;Google Chat API&#8221; dall&#8217;omonima sezione (per maggiori dettagli riguardo alla procedura di configurazione \u00e8 possibile consultare la <a rel=\"noreferrer noopener\" href=\"https:\/\/developers.google.com\/chat\/how-tos\/bots-publish#enable_the_google_chat_api\" data-type=\"URL\" data-id=\"https:\/\/developers.google.com\/chat\/how-tos\/bots-publish#enable_the_google_chat_api\" target=\"_blank\">guida ufficiale di Google<\/a>):<br><br><img decoding=\"async\" loading=\"lazy\" width=\"1089\" height=\"514\" class=\"wp-image-1360\" style=\"width: 1000px;\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione.png\" alt=\"\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione.png 1089w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-300x142.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-1024x483.png 1024w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-768x362.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-50x24.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-60x28.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-100x47.png 100w\" sizes=\"(max-width: 1089px) 100vw, 1089px\" \/><br><ul><li>Nel campo <strong>Nome bot<\/strong> specificare il nome che verr\u00e0 utilizzato dagli utenti quando interagiranno con il bot.<\/li><li>Nel campo <strong>URL avatar<\/strong> inserire l&#8217;URL dell&#8217;immagine che verr\u00e0 utilizzata come avatar del bot (\u00e8 consigliato l&#8217;utilizzo di un&#8217;immagine JPEG o PNG, in formato quadrato di dimensioni minime 256&#215;256 px).<\/li><li>Nel campo <strong>Descrizione<\/strong> fornire una descrizione della funzionalit\u00e0 del bot, la quale apparir\u00e0 sotto il nome del bot (massimo 40 caratteri).<\/li><li>Selezionare come <strong>Impostazione di connessione<\/strong> l&#8217;opzione &#8220;Bot URL&#8221; e nel campo <strong>Bot URL <\/strong>indicare l&#8217;URL presente nella finestra di configurazione del canale Google Chat su Tellya, alla voce &#8220;Bot URL&#8221;.<\/li><\/ul><\/li><li>All\u2019interno della piattaforma Tellya, dopo aver attivare il canale &#8220;Google Chat&#8221; tramite l\u2019interruttore, configurare i campi richiesti:<ul><li>Nel campo <strong>ID App<\/strong> inserire il &#8220;Numero di progetto (ID app)&#8221; che viene generato dopo aver salvato la configurazione del servizio &#8220;Google Chat API&#8221; all&#8217;interno del progetto Google Cloud. <img decoding=\"async\" loading=\"lazy\" width=\"909\" height=\"674\" class=\"wp-image-1362\" style=\"width: 1000px;\" src=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2.png\" alt=\"\" srcset=\"https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2.png 909w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2-300x222.png 300w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2-768x569.png 768w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2-50x37.png 50w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2-60x44.png 60w, https:\/\/docs.tellya.ai\/wp-content\/uploads\/2021\/03\/Google-chat-configurazione-2-100x74.png 100w\" sizes=\"(max-width: 909px) 100vw, 909px\" \/><\/li><\/ul><ul><li>Crea un nuovo Account di Servizio associato al progetto <a rel=\"noreferrer noopener\" href=\"https:\/\/console.cloud.google.com\/iam-admin\/serviceaccounts\" data-type=\"URL\" data-id=\"https:\/\/console.cloud.google.com\/iam-admin\/serviceaccounts\" target=\"_blank\">Google Cloud<\/a>, esportarne una chiave in formato JSON ed imporla nel campo <strong>Service account<\/strong> presente nella finestra di configurazione del canale su Tellya.<\/li><li>Nel campo <strong>Bot name<\/strong> indicare il medesimo nome configurato nel servizio Google Chat API in corrispondenza del campo &#8220;Nome bot&#8221;.<\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it)<\/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\">Se il <strong>Nome bot<\/strong> viene modificato in Google Cloud Platform \u00e8 necessario aggiornarlo manualmente anche all&#8217;interno della configurazione Tellya.<\/p>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Google Chat deve avviare la conversazione.<\/p>\n\n\n\n<h3 id=\"recupero-ed-utilizzo-delle-informazioni-utente\">Recupero ed utilizzo delle informazioni utente<\/h3>\n\n\n\n<p>Abilitando l&#8217;opzione &#8220;<strong>Enable user information retrival and saving<\/strong>&#8220;, verranno rese disponibili all&#8217;interno  della sessione conversazionale alcuni parametri relativi all&#8217;utente forniti da Google Chat, in particolare:<\/p>\n\n\n\n<ul><li><strong>User ID<\/strong> (identificativo univoco dell&#8217;utente: corrisponde al valore del campo &#8220;name&#8221; fornito da Google Chat), salvato nel parametro <strong>googleChatId <\/strong>della sessione conversazionale.<\/li><li><strong>Display Name<\/strong> (nome e cognome dell&#8217;utente: corrisponde al valore del campo &#8220;displayName&#8221; fornito da Google Chat), salvato nel parametro <strong>googleChatDisplayName <\/strong>della sessione conversazionale.<\/li><li><strong>Email<\/strong> (indirizzo email dell&#8217;utente: corrisponde al valore del campo &#8220;email&#8221; fornito da Google Chat), salvato nel parametro <strong>googleChatEmail <\/strong>della sessione conversazionale.<\/li><\/ul>\n\n\n\n<p>A seconda del motore NLU utilizzato all&#8217;interno della journey, i parametri googleChatId, googleChatDisplayName e googleChatEmail vengono memorizzati in elementi differenti della sessione conversazionale, in particolare:<\/p>\n\n\n\n<ul><li>Nel caso di <strong>Dialogflow ES<\/strong>: i parametri vengono memorizzati all&#8217;interno di un contesto che viene creato appositamente per lo scopo, chiamato <strong>request-context<\/strong> (con lifespan configurato a 999, al fine di mantenere i parametri per l&#8217;intera durata della sessione). Per richiamare un parametro all&#8217;interno di una risposta, \u00e8 quindi necessario utilizzare la sintassi <strong>#request-context.<em>nomeParametro<\/em><\/strong> (es. #request-context.googleChatDisplayName per recuperare il nome e cognome dell&#8217;utente).<\/li><li>Nel caso di <strong>Dialogflow CX<\/strong>: i parametri vengono memorizzati come <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\">parametri di sessione<\/a>, si pu\u00f2 quindi far riferimento ad essi utilizzando la sintassi <strong>$session.params.<em>nomeParametro<\/em><\/strong> (es. session.params.googleChatDisplayName per recuperare il nome e cognome dell&#8217;utente).<\/li><\/ul>\n\n\n\n<h2 id=\"microsoft-teams\">Microsoft Teams<\/h2>\n\n\n\n<p>Il canale \u201cMicrosoft Teams\u201d permette di integrare la journey all\u2019interno di una chat o di una stanza dell\u2019omonima app di messaggistica.<\/p>\n\n\n\n<p>L\u2019integrazione si articola in tre attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Creare un\u2019app su Teams seguendo la <a href=\"https:\/\/docs.microsoft.com\/en-us\/microsoftteams\/platform\/concepts\/build-and-test\/teams-developer-portal\">documentazione<\/a>.<\/li><li>Configurare le capabilities dell&#8217;app creata aggiungendo un bot. Per maggiori informazioni consultare la <a href=\"https:\/\/docs.microsoft.com\/it-it\/microsoftteams\/platform\/sbs-gs-nodejs?tabs=AS&amp;tutorial-step=3#configure-bot\">guida<\/a> .<ul><li>Dare un nome al bot.<\/li><li>Copiare da Tellya il contenuto del campo <strong>Callback URL<\/strong> e incollarlo nel campo \u201cBot endpoint address\u201d.<\/li><li>Generare una <strong>Client Secret.<\/strong><\/li><\/ul><\/li><\/ol>\n\n\n\n<ol start=\"3\"><li>All\u2019interno della piattaforma Tellya, attivare il canale \u201cMicrosoft Teams\u201d tramite l\u2019interruttore e configurare i campi richiesti nella modale:<ul><li>Copiare da Microsoft Teams il <strong>BotID<\/strong> che viene generato al salvataggio e inserirlo nell\u2019omonimo campo della piattaforma Tellya.<\/li><li>Copiare da Microsoft Teams il <strong>Client Secret<\/strong> e incollarlo nell\u2019omonimo campo della piattaforma Tellya.<\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it).<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Microsoft Teams deve avviare la conversazione.<\/p>\n\n\n\n<h2><strong>Telegram<\/strong><\/h2>\n\n\n\n<p>&nbsp;Il canale \u201cTelegram\u201d permette di integrare la propria <em>journey <\/em>Tellya all\u2019interno dell&#8217;omonima piattaforma di messaggistica istantanea.<\/p>\n\n\n\n<h3><strong>Configurazione base<\/strong><\/h3>\n\n\n\n<p>Il processo di configurazione e integrazione base Telegram e Tellya si articolare in due attivit\u00e0 principali:<\/p>\n\n\n\n<ol><li>Creazione di un \u201cbot\u201d Telegram:<ul><li>Accedere all\u2019applicazione Telegram ed avviare una conversazione, cliccando sul comando \u201cStart\u201d (oppure inserendo l\u2019input \u201c\/start\u201d), con il bot di sistema \u201c<a rel=\"noreferrer noopener\" href=\"https:\/\/telegram.me\/botfather\" target=\"_blank\">BotFather<\/a>\u201d che permette di creare tramite conversazione un nuovo \u201cbot\u201d Telegram<\/li><li>Inserire nella conversazione l\u2019input \u201c\/newbot\u201d<\/li><li>Specificare l\u2019username da assegnare al nuovo \u201cbot\u201d (il nome deve terminare con la parola \u201cbot\u201d (es. \u201cTellya_bot\u201d)<\/li><li>Memorizzare il <strong>token <\/strong>generato da Telegram e restituito all&#8217;interno della conversazione<\/li><\/ul><\/li><li>All\u2019interno della piattaforma Tellya, attivare il canale \u201cTelegram\u201d tramite l\u2019interruttore ed inserire all\u2019interno della finestra di dialogo:<ul><li> Il <strong>token <\/strong>precedentemente generato in Telegram nel campo \u201c<strong>Access Token<\/strong>\u201d.<\/li><li>Selezionare la <strong>language<\/strong> di default di interazione (per le journey dispatcher inserire le sigle dei paesi in formato <a href=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" data-type=\"URL\" data-id=\"https:\/\/it.wikipedia.org\/wiki\/ISO_3166-1_alpha-2#Codici_attuali\" target=\"_blank\" rel=\"noreferrer noopener\">ISO 3166-1 alpha-2<\/a>. Es. it).<\/li><\/ul><\/li><\/ol>\n\n\n\n<p>Per le<a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/#creazione-di-una-dispatcher-journey\" target=\"_blank\"> <em>journey <\/em>di tipo Dispatcher<\/a> \u00e8 necessario configurare nel campo <strong>Journey Code<\/strong> il codice della <a rel=\"noreferrer noopener\" href=\"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/connettori\/#dispatcher\" target=\"_blank\">journey<\/a> di default con la quale Telegram deve avviare la conversazione.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/lh6.googleusercontent.com\/k12tapkR1xrkVtQelbRHstWdpS7x2DLT3HlmkcUTPlPBXWCntGzJ5PmT20DEcuSo7RRSmP8_NwF33voMR4LKSmDZlqVfOyN_WR2aO-KTfE7_jvavgODS1n7E6r4XOGnDGsL7fFc1\" alt=\"\"\/><\/figure>\n\n\n\n<h3><strong>Configurazione Command<\/strong><\/h3>\n\n\n\n<p>Il canale \u201cTelegram\u201d mette a disposizione la possibilit\u00e0 di configurare dei \u201c<strong>command<\/strong>\u201d che offrono all\u2019utente la possibilit\u00e0 di innescare velocemente specifiche funzionalit\u00e0 implementate dal \u201cbot\u201d.<\/p>\n\n\n\n<p>Tramite Tellya, nella finestra di configurazione del canale \u201cTelegram\u201d \u00e8 possibile definire un elenco di \u201ccommand\u201d e le relative azioni\/intenti che devono essere innescati quando vengono selezionati. La pressione su un \u201ccommand\u201d all\u2019interno di una chat \u201cTelegram\u201d comporta l\u2019innesco di un evento verso la <em>journey<\/em> Tellya.<\/p>\n\n\n\n<p>Per ogni \u201ccommand\u201d \u00e8 necessario specificare tre informazioni:<\/p>\n\n\n\n<ul><li><strong>Command: <\/strong>nome che identifica il comando (max 32 caratteri, in minuscolo). Oltre ai caratteri dell\u2019alfabeto pu\u00f2 comprendere numeri e il simbolo underscore (_).<\/li><li><strong>Description: <\/strong>descrizione del comando (max 256 caratteri)<\/li><li><strong>Event name<\/strong>: nome dell\u2019evento da invocare alla selezione del comando<\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Chat widget Il canale \u201cChat widget\u201d permette di integrare la propria journey all\u2019interno di una pagina web o applicazione tramite script. Prima di essere incluso all\u2019interno della pagina, il modulo pu\u00f2 essere personalizzato specificando caratteristiche grafiche dell\u2019elemento che verr\u00e0 generato. \u00c8 possibile creare pi\u00f9 template differenti (tramite il bottone \u201cAdd&#8230;<\/p>\n","protected":false},"author":2,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[28],"ht-kb-tag":[],"_links":{"self":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/788"}],"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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/comments?post=788"}],"version-history":[{"count":46,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/788\/revisions"}],"predecessor-version":[{"id":1521,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/788\/revisions\/1521"}],"wp:attachment":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/media?parent=788"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=788"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=788"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}