Guida all'integrazione di Salesforce

Questo documento spiega come integrare Salesforce con Contact Center AI Platform (CCAI Platform).

Configura la ricerca degli account e la mappatura dei campi

Puoi configurare l'integrazione di Salesforce per fornire una ricerca flessibile degli account utilizzando oggetti di ricerca principali e secondari. Puoi mappare i campi di questi oggetti di ricerca ai campi dell'adattatore per chiamate, il che aiuta gli agenti a identificare i clienti o i lead. Queste ricerche di account sono disponibili sia per Sales Cloud che per Service Cloud.

Puoi configurare quanto segue:

  • Oggetti di ricerca: definisci gli oggetti di ricerca per trovare i record dei clienti per le chiamate in entrata e le chiamate in uscita. Gli oggetti di ricerca possono essere di tipo contatto, account o lead. Puoi definire oggetti di ricerca principali e secondari. Se la ricerca principale non restituisce una corrispondenza, il sistema utilizza l'oggetto secondario. Questo è utile quando esiste un record cliente in un tipo di oggetto, ma non in un altro.

  • Campi di ricerca: seleziona i campi di ricerca del numero di telefono per ogni oggetto di ricerca. Quando arriva una chiamata in arrivo, il sistema tenta di trovare una corrispondenza tra il numero di telefono in arrivo e il campo di ricerca per identificare il cliente.

  • Campi di visualizzazione dell'adattatore per chiamate: seleziona i tipi di campo visualizzati nell'adattatore per chiamate quando vengono trovati più account o record corrispondenti. Gli agenti possono utilizzare questi campi per identificare la corrispondenza che rappresenta il cliente che vogliono. Puoi configurare un secondo campo di visualizzazione (o un terzo, per i campi di visualizzazione dei record) per distinguere le corrispondenze.

Prima di iniziare

Prima di iniziare, installa Salesforce.

Procedura

Per configurare la ricerca dell'account e la mappatura dei campi, segui questi passaggi:

  1. Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.

  2. Nel riquadro CRM, per SFDC Cloud Selection, seleziona Service Cloud o Sales Cloud, a seconda di quello che stai configurando.

  3. Per configurare l'utente predefinito, segui questi passaggi. L'utente predefinito è l'amministratore dell'istanza, che puoi assegnare alle interazioni CRM in cui non è stato identificato o assegnato un agente specifico. Per saperne di più, consulta Amministratore predefinito.

    1. Seleziona la casella di controllo Utilizza l'utente amministratore per tutte le creazioni/aggiornamenti di record che non possono essere attribuiti a un agente specifico per impostare l'amministratore dell'istanza come autore predefinito dei ticket nuovi o aggiornati creati in CCAI Platform quando non è stato assegnato un agente specifico.

    2. Seleziona la casella di controllo Utilizza sempre l'utente amministratore per tutte le creazioni/aggiornamenti dei record per impostare l'amministratore dell'istanza come autore predefinito di tutti i ticket nuovi o aggiornati.

  4. Per configurare l'oggetto di ricerca principale, vai alla sezione Oggetto di ricerca principale e segui questi passaggi:

    1. Per definire l'oggetto di ricerca principale, segui questi passaggi:

      1. Nell'elenco Tipo di oggetto, seleziona il tipo di oggetto di ricerca.

      2. (Facoltativo) Nel campo Tipi di record, seleziona un tipo di record.

      3. Nell'elenco Campi di ricerca del numero di telefono, seleziona uno o più campi di ricerca del numero di telefono. Seleziona i tipi di numeri di telefono che identificano record diversi nell'oggetto di ricerca. La piattaforma CCAI cerca una corrispondenza tra il numero di telefono di una chiamata in arrivo e il numero di telefono in questo campo (ad eccezione delle sessioni basate su SDK in cui è attivata la corrispondenza dei campi personalizzati dell'SDK).

      4. Nel campo Campo principale del numero di telefono, seleziona un campo principale del numero di telefono. Quando CCAI Platform crea un nuovo account CRM, utilizza questo campo per memorizzare il numero di telefono dell'utente finale.

      5. Per criptare il numero di telefono nel campo di ricerca, seleziona la casella di controllo Il campo di ricerca del numero di telefono è criptato.

    2. Nell'elenco Formato numero di telefono, seleziona il formato del numero di telefono.

    3. Per configurare un campo di ricerca personalizzato per le sessioni provenienti dall'SDK web o dagli SDK mobile, segui questi passaggi:

      1. Seleziona la casella di controllo SDK per dispositivi mobili/web: cerca gli utenti in base al campo personalizzato per le sessioni SDK.

      2. Nell'elenco Campo di ricerca personalizzato nel CRM, seleziona il campo di ricerca personalizzato.

    4. Per configurare i campi di visualizzazione dell'account CRM nell'adattatore per chiamate, segui questi passaggi:

      1. Nell'elenco Matched account display field (Campo di visualizzazione dell'account corrispondente), seleziona il campo dall'oggetto di ricerca che viene visualizzato quando i record dell'account corrispondenti vengono visualizzati nel campo dell'adattatore per chiamate.

      2. (Facoltativo) Per visualizzare un secondo campo, segui questi passaggi:

        1. Seleziona la casella di controllo Mostra un secondo campo.

        2. Nell'elenco Secondo campo di visualizzazione, seleziona un campo.

        3. Per Posizione di visualizzazione del secondo campo, configura se il secondo campo viene visualizzato prima o dopo il campo di visualizzazione dell'account corrispondente.

  5. (Facoltativo) Per configurare un oggetto di ricerca secondario, segui questi passaggi:

    1. Seleziona la casella di controllo Secondary Lookup Object (Oggetto di ricerca secondario).

    2. Configura l'oggetto di ricerca secondario nello stesso modo in cui hai configurato l'oggetto di ricerca principale, ma non è necessario selezionare un campo del numero di telefono principale.

  6. Per configurare i campi di visualizzazione dei record CRM nell'adattatore per chiamate, segui questi passaggi:

    1. Nell'elenco Campo di visualizzazione del record corrispondente, seleziona il campo (dal record corrispondente) da visualizzare nel campo dell'adattatore per chiamate.

    2. (Facoltativo) Per visualizzare un secondo campo, segui questi passaggi:

      1. Seleziona la casella di controllo Mostra un secondo campo.

      2. Nell'elenco Secondo campo di visualizzazione, seleziona un campo.

    3. (Facoltativo) Per visualizzare un terzo campo, segui questi passaggi:

      1. Seleziona la casella di controllo Visualizza un terzo campo.

      2. Nell'elenco Terzo campo di visualizzazione, seleziona un campo.

  7. Fai clic su Salva.

Salesforce: ereditarietà dello stato dell'agente

La funzionalità di ereditarietà dello stato degli agenti della piattaforma CCAI consente agli amministratori di mappare gli stati degli agenti CRM allo stato degli agenti della piattaforma CCAI da aggiornare in tempo reale. Ereditando lo stato dell'agente del CRM, consente agli amministratori di trasferire gli stati degli agenti dal CRM alla piattaforma CCAI.

La mappatura personalizzata offre la flessibilità necessaria per adattarsi ai processi e alle impostazioni di stato distinti di ogni organizzazione. Un esempio potrebbe essere la configurazione degli agenti che gestiscono le email nel CRM per definire lo stato dell'agente come "non disponibile" nella piattaforma CCAI.

In questo modo, un agente può anche determinare il proprio stato da un'unica posizione. Quando aggiornano il widget Salesforce Omni-Channel, lo stato della piattaforma CCAI viene aggiornato in tempo reale, fornendo un unico meccanismo per l'impostazione degli stati aggiornati manualmente e dal sistema.

Requisiti di installazione e configurazione

  • Accesso a Salesforce e CCAI Platform richiesto

    • CCAI Platform: chiedi al tuo contatto o amministratore interno di CCAI Platform un account utente CCAI Platform con i ruoli di amministratore e agente assegnati

      • Il ruolo Amministratore ti consente di accedere alle impostazioni dello sviluppatore

      • Il ruolo Agente ti consente di accedere all'adattatore dell'agente per utilizzare e testare la funzionalità di stato dell'agente.

    • Account Salesforce con accesso amministrativo

      • Accesso omnicanale assegnato

      • Il tuo profilo dovrà essere assegnato al call center di CCAI Platform configurato per visualizzare l'adattatore dell'agente di CCAI Platform in Salesforce.

  • L'URL dell'ambiente della piattaforma CCAI della tua organizzazione e il nome del tenant o dell'ambiente verranno utilizzati durante l'intero processo e sono disponibili nel link del portale dell'amministratore della piattaforma CCAI. Avrai accesso quando il tuo account della piattaforma CCAI sarà configurato. L'URL è https://[my-instance-name].ccaiplatform.com.

Dettagli della funzionalità

  • È richiesta la mappatura 1:1 dell'account agente Salesforce all'account agente CCAI Platform

  • Questa funzionalità consente la sincronizzazione unidirezionale dal CRM alla piattaforma CCAI

  • Se lo stato viene modificato nella piattaforma CCAI, lo stato del CRM non verrà modificato

Comportamento della modifica dello stato

  • Stati della piattaforma CCAI protetti dalle modifiche del CRM in tempo reale

    • Se un agente è In chiamata, In chat o In tempo di wrap up, lo stato ereditato dal CRM verrà applicato al termine della chiamata, della chat o del tempo di wrap up.
  • Una volta attivato e configurato, lo stato di un agente può essere aggiornato in tre modi

    • Stato degli aggiornamenti dell'agente nell'adattatore: comportamento dello stato dell'agente esistente

    • L'agente seleziona lo stato successivo durante una sessione live: funzionalità esistente per gli agenti, descritta in Consenti agli agenti di impostare lo stato successivo durante una chiamata o una chat.

    • Il CRM invia l'aggiornamento dello stato dell'agente

      • Quando l'agente non è offline in CCAI Platform, le modifiche allo stato del CRM verranno apportate in CCAI Platform in base alla mappatura dello stato

      • Quando l'agente è offline nella piattaforma CCAI, le modifiche allo stato del CRM verranno ignorate

  • Quando lo stato del CRM cambia durante una sessione o una chiamata attiva

    • La piattaforma CCAI tratta questa modifica dello stato allo stesso modo della funzionalità Stato successivo dell'agente e, al termine della sessione, dopo il tempo di wrap up, lo stato successivo è regolato dal nuovo stato del CRM.

      • Se l'agente ha definito il proprio stato successivo e viene ricevuta anche una richiesta di modifica dello stato del CRM, lo stato successivo dell'agente verrà impostato sull'ultimo stato ricevuto

Configurazione di Salesforce

Per configurare Salesforce per CCAI Platform, configura le impostazioni descritte in questa sezione.

Configura l'omnicanalità

Se la tua organizzazione ha già configurato Omni-Channel, salta questa sezione.

Queste informazioni supplementari devono essere utilizzate insieme alla documentazione di Salesforce. Ti guideremo nella configurazione delle impostazioni minime di Omni-Channel per poter utilizzare l'app CCAI Platform Agent Status Inheritance.

Per attivare le impostazioni omnicanale, segui questi passaggi:

  1. Accedi a Salesforce come amministratore.

  2. In Setup (Configurazione), inserisci omni nella casella Quick Find (Ricerca rapida), quindi seleziona Omni-Channel Settings (Impostazioni omnicanale).

  3. Seleziona Enable Omni-Channel (Attiva omnicanale).

  4. Fai clic su Salva.

Aggiungi stati di presenza

Gli stati di presenza devono corrispondere a quelli utilizzati nel portale della piattaforma CCAI. Se gli stati sono già configurati nel portale di amministrazione, assicurati che siano inseriti tutti anche qui.

  1. In Setup (Configurazione), inserisci Presence Statuses (Stati di presenza) nella casella di ricerca rapida, quindi seleziona Presence Statuses (Stati di presenza) in Omni-Channel (Omnicanale).

  2. Fai clic su Nuovo.

  3. Nella schermata successiva, puoi aggiungere uno stato. Ad esempio, digita "Disponibile per Generico" in Nome stato e verrà compilato automaticamente "Disponibile_per_Generico" in Nome sviluppatore.

  4. Ripeti il passaggio 3 in base alle tue esigenze. Ad esempio, puoi creare "Disponibile per email", "Occupato", "Pasto" e così via per gli stati di presenza.

Aggiungi omnicanale

I passaggi necessari per implementare l'approccio omnicanale dipendono dalla versione di Salesforce.

Salesforce Classic

Se utilizzi solo Lightning, salta questo passaggio.

  1. In Setup (Configurazione), inserisci App nella casella Quick Find (Ricerca rapida), quindi seleziona Apps (App) in Create (Crea).

  2. Fai clic sul pulsante Modifica a sinistra di Sample Console (potresti avere un nome diverso).

  3. Nella schermata di modifica, individua la sezione Choose Console Components (Scegli componenti della console).

  4. Seleziona Omnicanale nell'elenco a discesa Elementi disponibili.

  5. Fai clic su Aggiungi, quindi Omnicanale verrà visualizzato nell'elenco a discesa Elementi selezionati.

  6. Fai clic su Save nella parte inferiore dello schermo.

Salesforce Lightning

Se utilizzi solo la versione classica, salta questo passaggio.

  1. Se utilizzi Classic, fai clic su Passa a Lightning Experience.

  2. Fai clic sull'icona a forma di ingranaggio, poi su Setup (Configurazione) nell'area in alto a destra della schermata Lightning.

  3. In Setup (Configurazione), inserisci App nella casella Quick Find (Ricerca rapida), quindi seleziona App Manager (Gestione app) in Apps (App).

  4. Fai clic sull'icona della Freccia giù in alto a destra nella Console di assistenza (potrebbe avere un nome diverso).

  5. Fai clic su Modifica.

  6. Fai clic su Utility Items (Elementi di utilità) nella schermata Lightning App Builder (Generatore di app Lightning).

  7. Fai clic su Add Utility Item (Aggiungi elemento di utilità) e seleziona Omni-Channel (Omnicanale).

  8. Fai clic su Salva.

  9. Fai clic su Indietro nell'angolo in alto a destra dello schermo.

Concedi agli utenti l'accesso agli stati di presenza del servizio

Affinché uno stato di presenza del servizio sia disponibile per un utente, l'accesso per ogni stato deve essere concesso a ogni profilo o set di autorizzazioni applicabile. Se un profilo o un set di autorizzazioni non ha accesso a un determinato stato di presenza del servizio, questo stato non sarà disponibile o visibile nel widget Omni-Channel per gli utenti assegnati.

Consulta Give Users Access to Presence Statuses with Profiles e Give Users Access to Presence Statuses with Permission Sets di Salesforce. Di seguito sono riportati i passaggi semplificati per concedere l'accesso con i profili.

  1. In Setup (Configurazione), inserisci Users (Utenti) nella casella di ricerca rapida, quindi seleziona Profiles (Profili) in Manage Users (Gestisci utenti).

  2. Nella sezione principale, fai clic sul nome di un profilo a cui vuoi concedere l'accesso a Service Presence Status.

  3. Trova Enabled Service Presence Status Access (Accesso allo stato di presenza del servizio abilitato) e fai clic su Edit (Modifica).

  4. Nella schermata di modifica, seleziona gli elementi nell'elenco a discesa Stati di presenza del servizio disponibili e fai clic su Aggiungi.

  5. Fai clic su Salva.

  6. Ripeti i passaggi da 3 a 6 per ogni profilo a cui vuoi concedere l'accesso a Service Presence Status.

Verifica Omni-Channel

Verifica la configurazione di Omni-Channel nella console Salesforce.

Salesforce Classic Console

Se utilizzi solo Lightning, salta questo passaggio.

  1. Se ti trovi in Configurazione, fai clic su Torna alla console di esempio.

  2. Fai clic su Omnicanale.

  3. Fai clic sul link Offline nel widget Omni-Channel.

  4. Seleziona uno degli stati di presenza del servizio e verifica se puoi modificarlo.

Salesforce Lightning

Se utilizzi solo la versione classica, salta questo passaggio.

  1. Nella parte in basso a sinistra della schermata della console, fai clic sul pulsante Omni-Channel.

  2. Fai clic sul link Offline nel widget Omni-Channel.

  3. Seleziona uno degli stati di presenza del servizio e verifica se puoi modificarlo.

Omni-Channel dovrebbe ora essere abilitato nella tua organizzazione Salesforce, consentendoti di utilizzarlo nella tua console.

Impostazioni del sito remoto

Configura le impostazioni del sito remoto per l'app CCAI Platform Agent Status Inheritance in modo da poter inviare dati da Salesforce a CCAI Platform.

  1. In Setup (Configurazione), inserisci remote (remoto) nella casella di ricerca rapida, quindi seleziona Remote Site Settings (Impostazioni sito remoto) in Security Controls (Controlli di sicurezza).

  2. Fai clic su New Remote Site (Nuovo sito remoto).

  3. Nella schermata successiva, inserisci Remote Site Name (Nome sito remoto) e Remote Site URL (URL sito remoto). Ad es. Utilizza CCAI Platform per Remote Site Name (Nome sito remoto). Inserisci il dominio della piattaforma CCAI per Remote Site URL (URL del sito remoto).

Configurazione di CCAI Platform

Questa sezione descrive come configurare le impostazioni di CCAI Platform.

Stabilisci i token di amministratore

Configura uno o più token amministratore di Salesforce nel portale di amministrazione della piattaforma CCAI in modo che il portale di amministrazione possa recuperare gli stati di presenza del servizio omnicanale di Salesforce. Per saperne di più, consulta Amministratore CRM predefinito.

  1. Nel portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.

    Token amministratore Salesforce.

  2. Fai clic su Collega nuovo utente.

  3. Nella finestra di dialogo OAuth, accedi come amministratore di Salesforce e consenti la richiesta OAuth.

  4. Vedrai il tuo utente amministratore collegato nella sezione Utenti amministratori collegati.

Attiva la mappatura dello stato

  1. Dal portale di amministrazione, vai a Impostazioni > Impostazioni sviluppatore > Eredità dello stato dell'agente omnicanale di Salesforce.

  2. Attiva l'impostazione della funzionalità con On.

Gestisci la mappatura degli stati

Gli stati di Salesforce verranno recuperati automaticamente dalla tua organizzazione Salesforce. Se non vedi gli stati SFDC, controlla il passaggio Stabilisci i token amministratore e Configura Omni-Channel. Gli stati di Salesforce non mappati genereranno un errore

  1. Accedi al portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.

    Ereditarietà dello stato dell'agente omnicanale di Salesforce.

  2. Fai clic su Gestisci in Mappatura stato.

  3. Nella finestra di dialogo, seleziona uno stato della piattaforma CCAI preferito per ogni stato di Salesforce.

Raccogli la chiave e il secret dell'azienda

  1. Accedi al portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.

    Company Key & Secret Code.

  2. Raccogli la chiave aziendale e il codice segreto aziendale.

Identifica il nome dell'app connessa

  1. In Salesforce, vai a Setup (Configurazione), inserisci app nella casella di ricerca rapida, quindi seleziona Connected Apps (App connesse) in Manage Apps (Gestisci app).

  2. Identifica il nome dell'app connessa alla piattaforma CCAI.

Installa l'app CCAI Platform Agent Status Inheritance

  1. Incolla il link di installazione nella barra degli indirizzi del browser: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t6g000003Rzxv

  2. Seleziona Installa per tutti gli utenti.

  3. Al termine dell'installazione, fai clic su Fine.

    Per le installazioni più lunghe, riceverai un'email di notifica al termine dell'installazione.

Configura l'app

  1. In Setup (Configurazione), inserisci package (pacchetto) nella casella Quick Find (Ricerca rapida), quindi seleziona Installed Packages (Pacchetti installati).

  2. Fai clic su Configura a sinistra di UJET_App_Status.

  3. Nella nuova finestra, fai clic su Aggiungi nuova configurazione.

  4. Nella schermata di configurazione, seleziona Organizzazione come Proprietario della configurazione.

  5. Compila i valori per Company Key, Company Secret, Tenant name e Connected App name che hai copiato nei passaggi precedenti.

  6. Seleziona Attiva l'ereditarietà dello stato dell'agente.

  7. Inserisci il valore nell'URL della piattaforma CCAI che hai copiato nel passaggio 6 Copia il valore delle impostazioni dal portale di amministrazione della piattaforma CCAI.

  8. Fai clic su Save CCAI Platform Configuration (Salva configurazione della piattaforma CCAI).

  9. Chiudi la finestra.

Verifica che l'app Agent Status Inheritance funzioni

  1. Modifica lo stato omnicanale nella console.

  2. Conferma le modifiche dello stato della piattaforma CCAI in base all'impostazione di mappatura nel portale di amministrazione.

Salesforce: installazione e configurazione dell'oggetto sessione della piattaforma CCAI

L'oggetto sessione della piattaforma CCAI fornisce un oggetto personalizzato comodo e ottimizzato in cui verranno archiviati tutti i dati della sessione. Tutti i dati della sessione, inclusi i file associati come registrazioni vocali, trascrizioni delle chat e file multimediali caricati dall'utente finale, sono inclusi nell'oggetto Sessione della piattaforma CCAI correlato. Questo oggetto viene poi correlato alla richiesta appropriata o direttamente a un oggetto Account configurato.

Esegui le seguenti azioni e i seguenti passaggi nell'ordine indicato.

Installa il pacchetto Salesforce della piattaforma CCAI

Installa la versione 1.17 o successive del pacchetto Salesforce di CCAI Platform.

Per saperne di più, consulta la guida all'installazione di Salesforce.

Abilita la sessione della piattaforma CCAI

Per attivare la sessione di CCAI Platform, segui questi passaggi:

  1. Nel portale della piattaforma CCAI, fai clic su Impostazioni > Gestione delle operazioni. Se non vedi il menu Impostazioni, fai clic su Menu.

  2. Vai al riquadro Dettagli creazione record CRM.

  3. Per Dati della sessione, nell'elenco Mappa i dati a, seleziona Sessione CCAI Platform.

  4. Fai clic su Salva impostazioni generali.

Per saperne di più, consulta Salesforce - CCAI Platform session mapping to case or account objects (person account, contact, lead).

Configurazione di Salesforce

Passaggi per la configurazione in Salesforce:

Passaggio 1: configura e attiva l'utente amministratore predefinito

Definisci un utente amministratore CRM che rappresenti l'utente predefinito per tutte le azioni e gli eventi CRM in cui non è stato identificato o assegnato un agente specifico. Se questa funzionalità non viene utilizzata, la piattaforma CCAI assegnerà in modo casuale il ticket o il caso a qualsiasi utente.

Per saperne di più, consulta Amministratore predefinito di CRM.

Passaggio 2: aggiorna le impostazioni degli oggetti

  1. In Configurazione di Salesforce, vai a Set di autorizzazioni.

  2. Individua e seleziona il set di autorizzazioni CCAI Platform Agent Clone (potrebbe avere un nome diverso nelle tue impostazioni).

  3. Seleziona Object Settings (Impostazioni oggetto).

  4. Individua le seguenti autorizzazioni:

    - Azioni di CCAI Platform

    - Sessioni di CCAI Platform

    - Trasferimenti di CCAI Platform

  5. Fai clic sull'oggetto Azioni della piattaforma CCAI.

    Se utilizzi il token amministratore predefinito del passaggio 1, gli agenti non hanno bisogno delle autorizzazioni di creazione, modifica o visualizzazione di tutti gli elementi. Se non utilizzi l'utente amministratore predefinito, assegna tutte le autorizzazioni per l'accesso e la creazione di oggetti corretti.

    Se utilizzi l'utente amministratore predefinito, fai clic sull'oggetto Azioni della piattaforma CCAI e attiva l'autorizzazione Lettura.

    Se non utilizzi l'utente amministratore predefinito, fai clic sull'oggetto Azioni della piattaforma CCAI e attiva l'accesso Lettura, Crea, Modifica e Visualizza tutto, quindi fai clic su Salva.

  6. Ripeti questo passaggio per CCAI Platform Sessions e CCAI Platform Transfers.

Passaggio 3: aggiorna il layout di pagina dell'oggetto Case o Account

Per visualizzare l'oggetto Sessione della piattaforma CCAI, è necessario aggiornare il layout di pagina dell'oggetto Richiesta o Account.

Segui gli stessi passaggi per l'oggetto Account che stai utilizzando se non utilizzi Case.

  1. In Salesforce Setup, vai a Object Manager > Case OPPURE all'oggetto Account configurato.

    Gestore oggetti in Salesforce

  2. Fai clic su Case (Richiesta) o sull'oggetto Account Page Layouts (Layout di pagina) a sinistra.

  3. Seleziona il layout di pagina utilizzato dagli utenti della piattaforma CCAI.

  4. Individua le sessioni della piattaforma CCAI in Elenchi correlati e trascina l'oggetto della sessione della piattaforma CCAI nel punto in cui vuoi che venga visualizzato nella pagina Layout.

    Trascina l'oggetto Sessione della piattaforma CCAI

  5. Fai clic su Salva nella parte superiore della pagina.

Passaggio 4: passaggio aggiuntivo facoltativo richiesto per la configurazione di Lightning

Se utilizzi Lightning, segui questi passaggi per creare una nuova pagina di record Lightning o aggiornarne una esistente.

  1. In Salesforce Setup, vai a Setup > Object Manager > Case > Lightning Record Page.

  2. Fai clic su Nuovo.

    Nuova pagina dei record Lightning

  3. Fai clic su Registra pagina, poi su Avanti.

    Seleziona la pagina di registrazione

  4. Crea un'etichetta, seleziona Richiesta come oggetto e fai clic su Avanti.

  5. Scegli un modello di pagina e fai clic su Fine.

  6. Includi il componente con l'oggetto Sessione di CCAI Platform. Nel seguente scenario, è stato aggiunto al componente "Elenco correlato".

    Componente Elenco correlato

  7. Fai clic su Salva.

  8. Fai clic su Attiva.

  9. Segui il flusso di configurazione di Salesforce per assegnare la pagina all'applicazione che utilizzi in Lightning.

Configurazione del portale CCAI Platform

  1. Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.

  2. Scorri fino a Configura i dettagli di creazione dei ticket e seleziona i comportamenti preferiti.

  3. Se utilizzi Richieste, vai a Titolo ticket e configura il titolo della richiesta al momento della creazione.

Oggetto sessione personalizzato della piattaforma CCAI per la configurazione di Salesforce

L'oggetto di sessione personalizzato della piattaforma CCAI fornisce un oggetto di sessione della piattaforma CCAI personalizzato, ottimizzato e pratico, in cui tutti i dati della sessione verranno archiviati in un oggetto di sessione. Quando questa opzione è abilitata, anziché archiviare i dati della sessione nell'oggetto Attività utilizzando più voci, tutti i dati della sessione, inclusi i file associati, ad esempio registrazioni vocali, trascrizioni di chat e file multimediali caricati dall'utente finale, vengono inclusi nell'oggetto sessione di CCAI Platform. Questo oggetto viene poi allegato alla richiesta appropriata (o, facoltativamente, direttamente a un oggetto Account).

Oggetto sessione

L'oggetto sessione è un oggetto per le sessioni di chiamata o chat e può essere reso disponibile per Salesforce.

Configurazione amministratore

  1. Affinché l'opzione dell'oggetto di sessione della piattaforma CCAI sia disponibile nell'interfaccia utente dell'amministratore, è necessario installare il pacchetto della piattaforma CCAI 1.16 o versioni successive in Salesforce.

    Per saperne di più, consulta la guida all'installazione di Salesforce.

  2. Vai a Impostazioni > Impostazioni sviluppatore > CRM > Salesforce > Dati della sessione.

  3. Nell'elenco a discesa, imposta l'opzione Mappa dati su Sessione CCAI Platform.

Aggiornamenti di Salesforce

Sono necessari aggiornamenti periodici all'installazione e alla configurazione di Salesforce.

Upgrade del pacchetto Salesforce di CCAI Platform

È necessario eseguire l'upgrade al pacchetto Salesforce 1.16 o versioni successive della piattaforma CCAI.

Aggiornamenti della configurazione di Salesforce

In Salesforce sono necessarie le seguenti modifiche alla configurazione.

Passaggio 1: aggiorna le impostazioni degli oggetti
  1. In Configurazione di Salesforce, vai a Gestore oggetti > Set di autorizzazioni.

    Sessioni di oggetti.

  2. Individua e seleziona il set di autorizzazioni CCAI Platform Agent (potrebbe avere un nome diverso nelle tue impostazioni).

  3. Seleziona Object Settings (Impostazioni oggetto).

    Pagina delle impostazioni degli oggetti Salesforce

  4. Aggiorna le impostazioni degli oggetti da includere per:

    - Azioni della piattaforma CCAI

    - Sessioni di CCAI Platform

    - Trasferimenti di CCAI Platform (Nota: assicurati di aggiornare tutti e tre gli oggetti.)

  5. Fai clic sull'oggetto Agent Actions e attiva l'accesso Read, Create, Edit e View All, quindi fai clic su Save.

  6. Ripeti questo passaggio per CCAI Platform Sessions e CCAI Platform Transfers.

Passaggio 2: aggiorna il layout di pagina della richiesta
  1. In Salesforce Setup, vai alla sezione Case Page Layout (questo percorso varia per Classic e Lightning)

  2. Seleziona i layout delle richieste utilizzati dagli utenti della piattaforma CCAI.

  3. Individua le sessioni della piattaforma CCAI in Elenchi correlati e trascina l'oggetto Sessione della piattaforma CCAI nella posizione in cui vuoi che venga visualizzato nella pagina Layout richiesta.

  4. Fai clic su Salva nella parte superiore della pagina.

Passaggio 3: passaggio aggiuntivo facoltativo richiesto per la configurazione di Lightning

Se utilizzi Lightning, segui questi passaggi per creare una nuova pagina di record Lightning o aggiornarne una esistente.

  1. In Configurazione di Salesforce, vai a Configurazione > Gestore oggetti > Caso > Pagina dei record Lightning.

  2. Fai clic su Nuovo.

    Nuova pagina dei record Lightning

  3. Fai clic su Registra pagina, poi su Avanti.

    Seleziona la pagina di registrazione

  4. Crea un'etichetta, seleziona Richiesta come oggetto e fai clic su Avanti.

  5. Scegli un modello di pagina e fai clic su Fine.

  6. Includi il componente con l'oggetto della sessione di CCAI Platform. Nel seguente scenario è stato aggiunto al componente Related List (Elenco correlato).

    Componente Elenco correlato

  7. Fai clic su Salva.

  8. Fai clic su Attiva.

  9. Segui il flusso di configurazione di Salesforce per assegnare la pagina all'applicazione che stai utilizzando in Lightning.

Regole e comportamenti di Salesforce + CCAI Platform

Salesforce è una potente piattaforma CRM con infinite personalizzazioni possibili. La piattaforma CCAI ha un insieme specifico di interazioni che vengono eseguite per impostazione predefinita o che possono essere personalizzate da varie impostazioni nel portale di amministrazione.

Creazione della richiesta

Con la configurazione standard, utilizzando le richieste come tipo di record:

  • Quando arriva una chiamata/chat da SDK web o mobile, CCAI Platform:

    • Crea una richiesta in Salesforce.

    • Assegna la richiesta all'agente.

    • Include tutte le informazioni disponibili (ad es. informazioni sull'utente mobile + dati diagnostici, informazioni sull'utente web e così via).

  • Quando un agente risponde a una chiamata IVR, CCAI Platform:

    • Crea una richiesta in Salesforce.

    • Assegna la richiesta all'agente. In Salesforce esiste il concetto di proprietario di un oggetto. Per impostazione predefinita, un oggetto viene assegnato a chi lo crea. Per un oggetto richiesta, quando un agente risponde a una chiamata, la piattaforma CCAI cambia il proprietario dell'oggetto nell'agente che ha risposto alla chiamata.

    • Include tutte le informazioni disponibili (ad es. nome, selezione del menu, numero di telefono del chiamante).

  • Quando viene effettuata una chiamata in uscita utilizzando l'adattatore dell'agente, la piattaforma CCAI crea un nuovo caso in Salesforce.

  • Quando un utente chiama, ma abbandona la chiamata, CCAI Platform crea una richiesta in Salesforce.

  • Quando un chiamante chiama e la chiamata non va a buon fine perché l'agente la annulla (ag_canceled), viene richiesta l'apertura di una richiesta, ma questa non viene assegnata all'agente che ha annullato la chiamata.

  • Quando un chiamante lascia un messaggio vocale, la piattaforma CCAI crea una richiesta di messaggio vocale in Salesforce anche se esiste una richiesta con stato Aperto dello stesso cliente.

    • La richiesta di segreteria può essere riutilizzata da una nuova chiamata IVR o in uscita.

Aggiornamenti delle richieste

Tutti gli aggiornamenti della richiesta saranno visibili all'agente durante la chiamata o la chat e se era già in chiamata e ha trasferito la chiamata o la chat.

Aggiunta di chiamate o chat alle richieste

  • Quando è presente una chiamata in entrata o una chat dallo stesso contatto, con la stessa selezione di menu e lo stesso canale del caso più recente per quel contatto in stato Nuovo, Riassegnato o In lavorazione, la piattaforma CCAI aggiunge la chiamata o la chat al caso aperto come nuova attività del caso.

  • Quando viene effettuata una chiamata in uscita utilizzando la funzionalità click-to-call dalla sezione dei dettagli della richiesta (non dalla barra laterale), se la richiesta più recente con quell'utente è in stato Aperta, In lavorazione o Riassegnata, la piattaforma CCAI aggiungerà la chiamata in uscita alla richiesta esistente per le richieste di follow-up.

  • Quando un agente utilizza l'opzione Riaggancia e richiama dal widget, la piattaforma CCAI aggiunge la chiamata alla richiesta aperta.

  • Quando una chiamata dura meno di 10 secondi e l'agente utilizza il pulsante Richiamata, CCAI Platform aggiunge la chiamata alla richiesta aperta.

Proprietario e assegnazione della richiesta

  • Dopo l'attivazione dell'amministratore predefinito, quest'ultimo viene utilizzato come proprietario per quanto segue:

    • Creazione di ticket o richiesta e contatto quando viene avviata una nuova chat prima che venga assegnato un agente alla chat

    • Ticket o richieste di assistenza relativi ai messaggi vocali prima di ricevere una chiamata di richiamata

    • Ticket o richieste di assistenza per le chiamate abbandonate (se abilitati)

  • Quando una chiamata/chat viene trasferita:

    • La piattaforma CCAI assegna la richiesta all'agente a cui viene trasferita la chiamata.

    • Alla richiesta viene aggiunta una nuova attività relativa al trasferimento.

Allegati e azioni registrati

  • Quando una chiamata in entrata/in uscita termina, la piattaforma CCAI aggiorna la richiesta con il file di registrazione della chiamata, se la registrazione è attiva.

  • Quando una SmartAction viene completata, la piattaforma CCAI aggiorna la richiesta con i risultati dell'azione e gli allegati.

  • Quando una SmartAction non va a buon fine a causa di un errore da parte dell'utente (ad es. accesso con impronta non abilitato), la piattaforma CCAI aggiorna la richiesta con il messaggio di errore.

  • Quando l'azienda utilizza la mappatura dei campi personalizzati (configurata dal portale della piattaforma CCAI), i dati provenienti dall'SDK per dispositivi mobili o web o dall'API Apps (Chat) vengono inseriti nel campo designato nel CRM.

  • Quando l'utente finale valuta un IVR o una chiamata/chat mobile, CCAI Platform aggiunge un punteggio di valutazione alla richiesta.

  • Quando un agente legge/ignora/richiama dalla segreteria, la piattaforma CCAI aggiorna la richiesta.

  • Quando una richiesta viene chiusa, le viene assegnato lo stato isClosed.

Creazione di un contatto

  • Quando arriva una chiamata IVR con un nuovo numero di telefono, CCAI Platform crea un contatto in Salesforce.

  • Quando un nuovo utente dell'app (nuovo identificatore) avvia l'SDK mobile di CCAI Platform, CCAI Platform crea un contatto in Salesforce.

  • Quando il numero del chiamante IVR è bloccato, la piattaforma CCAI creerà un contatto utente sconosciuto in Salesforce.

  • Se esistono più contatti con lo stesso numero di telefono, CCAI Platform visualizzerà la schermata di selezione dei contatti nel widget Agente, in cui l'agente può scegliere quale contatto utilizzare o scegliere di crearne uno nuovo.

Aggiornamento dei contatti

  • Se il contatto è stato appena creato dalla chiamata corrente:

    • Per le chiamate IVR, il campo Proprietario contatto viene aggiornato con l'agente assegnato.

    • Per i contatti creati da chiamate da dispositivi mobili, richiamate e messaggi vocali, viene utilizzato il token amministratore predefinito se la configurazione è completa o, se il token amministratore predefinito non è disponibile, la piattaforma CCAI utilizzerà un token agente casuale. Per saperne di più sull'utente amministratore predefinito, consulta Amministratore predefinito di CRM.

Routing di chiamate e chat

  • DAP segmento utenti: la piattaforma CCAI cercherà un contatto utilizzando il numero di telefono (IVR), l'indirizzo email (dispositivo mobile) o il campo personalizzato (dispositivo mobile) di Salesforce per trovare le impostazioni corrispondenti nella coda e indirizzare direttamente la chiamata o la chat alla coda.

  • APEX REST DAP: l'amministratore può configurare l'endpoint APEX REST come endpoint API Direct Access Point (DAP). Per saperne di più, consulta API Direct Access Point - Salesforce REST API.

Click-to-call in uscita

Quando visualizzi un contatto in Salesforce, puoi fare clic sul suo numero di telefono per avviare una chiamata in uscita.

Se si fa clic all'interno dei dettagli della richiesta, a seconda delle impostazioni, la chiamata verrà aggiunta se la richiesta non è chiusa.

Numero di telefono di contatto in Salesforce

Chiamata in uscita in Salesforce

Salesforce: mappatura delle sessioni della piattaforma CCAI agli oggetti di richiesta o account (account personale, contatto, lead)

Quando viene effettuata una chiamata o una chat, i dati associati devono essere resi disponibili nel tuo CRM e la piattaforma CCAI offre flessibilità nel modo in cui i dati della sessione di chiamata o chat vengono allegati agli oggetti dati di Salesforce.

Sono disponibili le seguenti opzioni di configurazione:

  • Ricerca account: possibilità di eseguire la ricerca di account in qualsiasi oggetto account basato sull'utente finale di Salesforce

  • Posizione dei dati della sessione: mappa i dati della sessione a un oggetto Account (Contatto, Account personale, Account, Lead o Attività anziché una richiesta).

  • Nessuna richiesta: possibilità di collegare l'oggetto Sessione personalizzata della piattaforma CCAI direttamente a qualsiasi oggetto dell'account Salesforce, senza dover creare una richiesta

Questa funzionalità si basa su due funzionalità correlate:

  • Opzione per cercare gli utenti finali nell'oggetto Account personale (anziché Contatto (predefinito))

  • Opzione per sfruttare il nostro oggetto di sessione della piattaforma CCAI, che archivia tutti gli asset e i dati relativi a una singola sessione nell'oggetto di sessione della piattaforma CCAI ottimizzato

Requisiti di disponibilità della configurazione

Le opzioni di configurazione per la ricerca dell'account e i dati della sessione sono disponibili solo se sono soddisfatte le seguenti condizioni:

  • Configurazione della ricerca dell'account

    Per configurare le impostazioni di ricerca personalizzata degli account, è necessario:

    Agente che ha eseguito l'accesso: almeno un agente deve aver eseguito l'accesso a un adattatore della piattaforma CCAI in Salesforce. Questo è necessario per garantire che sia presente un token attivo che consenta alla piattaforma CCAI di accedere ai dati di Salesforce durante la sessione dell'amministratore.

  • Configurazione dei dati di sessione

    Per configurare le opzioni di mappatura dei dati della sessione, ad esempio la selezione dell'oggetto sessione della piattaforma CCAI, è necessario quanto segue:

    • Agente che ha eseguito l'accesso: almeno un agente deve aver eseguito l'accesso a un adattatore della piattaforma CCAI in Salesforce. Questo è necessario per garantire che sia presente un token attivo che consenta alla piattaforma CCAI di accedere ai dati di Salesforce durante la sessione dell'amministratore.

    • Il pacchetto Salesforce della piattaforma CCAI versione 1.16 (o successive) è installato nella tua istanza Salesforce. Per il supporto dell'oggetto Lead di Salesforce, è richiesta la versione 1.18 del pacchetto, ma è consigliata la versione 1.20 o successive.

Se i requisiti di accesso alla configurazione per una o entrambe queste impostazioni non sono soddisfatti, la UI del portale della piattaforma CCAI per configurare Ricerca account e Dati della sessione non sarà attiva, come mostrato nell'immagine seguente:

Configurazione della ricerca di account inattivi e dei dati della sessione

Configurazione del portale CCAI Platform

Configura le impostazioni di ricerca dell'account e di mappatura dei dati della sessione nel portale della piattaforma CCAI.

Ricerca dell'account e mappatura dei dati della sessione

  1. Nel portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore e seleziona Salesforce.

    Impostazioni sviluppatore Salesforce nel portale

  2. Seleziona un Tipo di oggetto:

    Contatto

    Account personale

    Account

    Lead

  3. Seleziona un Tipo di record. Queste opzioni variano in base al tipo di oggetto selezionato.

  4. Seleziona il campo specifico con cui la piattaforma CCAI deve far corrispondere il numero di telefono dell'utente finale dall'opzione Campo di ricerca del numero di telefono. La piattaforma CCAI recupererà tutti i campi "tipo di telefono" dall'oggetto account selezionato.

  5. Seleziona il campo SDK Custom Lookup (Ricerca personalizzata SDK) per attivare l'opzione per passare un identificatore dell'utente (UID) personalizzato alla piattaforma CCAI per la ricerca dell'utente finale. Disponibile per gli SDK web e per dispositivi mobili.

    Campo di ricerca personalizzato dell'SDK

  6. Seleziona una posizione in cui CCAI Platform può organizzare e allegare i dati principali della sessione (ID chiamata/chat, durata della sessione, caricamenti di file degli utenti finali e così via) a Salesforce.

    Opzioni per la posizione dei dati della sessione

    1. Oggetto Attività: i dati della sessione vengono archiviati nell'oggetto Attività di Salesforce. I record verranno creati con questa opzione.

    2. Sessione della piattaforma CCAI: tutti i dati della sessione vengono organizzati e raccolti in modo ottimale nell'oggetto Sessione della piattaforma CCAI.

      Offre un'opzione per allegare direttamente l'oggetto della sessione della piattaforma CCAI a un oggetto Account, Contatto o Lead di Salesforce in base alla selezione effettuata nel passaggio 2.

      In base alla selezione effettuata nel passaggio 2, se selezioni Contatto o Lead, l'oggetto della sessione della piattaforma CCAI viene collegato direttamente a un oggetto Attività, quindi l'Attività viene collegata all'oggetto Contatto o Lead. Se selezioni Account personali o Account, la sessione della piattaforma CCAI viene allegata a un oggetto Attività, quindi la sessione della piattaforma CCAI viene allegata all'account o all'account personale.

    3. Attach to Records: crea un record CRM e lo allega all'oggetto della sessione.

    Nessun record: se l'oggetto Sessione della piattaforma CCAI è collegato direttamente a un oggetto Account o Attività di Salesforce, non verranno creati record. Questa opzione è disponibile solo quando viene eseguito il mapping all'oggetto Sessione della piattaforma CCAI.

Configurazione dei set di autorizzazioni Salesforce richiesti

Sono necessarie modifiche alle autorizzazioni per i campi e l'oggetto Account.

  1. In qualità di amministratore di Salesforce, vai alla pagina Setup (Configurazione).

  2. Utilizzando il campo di ricerca, vai alla pagina delle impostazioni Permission Set (Set di autorizzazioni).

  3. Vedrai qualcosa di simile al set di autorizzazioni UJET_Agent.

    Viene visualizzato un elenco di autorizzazioni per ruolo.

  4. Seleziona il set di autorizzazioni UJET_Agent.

    Seleziona la voce UJET_Agent Permissions.

  5. Le autorizzazioni dell'account devono essere impostate per attivare: Lettura, Creazione, Modifica, Visualizza tutto. In caso contrario, aggiungi le autorizzazioni di lettura, creazione, modifica e visualizzazione di tutti gli elementi all'oggetto Account.

    Vengono visualizzati gli account e il relativo livello di autorizzazioni o accesso.

  6. Scorri o utilizza gli strumenti di ordinamento del menu a discesa per visualizzare o passare alla sezione Autorizzazione campo e attiva l'accesso in modifica per Tipo.

    Viene visualizzato un elenco scorrevole delle autorizzazioni dei campi e se hanno accesso in lettura o modifica.

  7. Fai clic su Salva per completare le modifiche e aggiornare il set di autorizzazioni.

Oggetto sessione personalizzato di CCAI Platform per Salesforce

L'oggetto di sessione personalizzato della piattaforma CCAI fornisce un oggetto di sessione della piattaforma CCAI personalizzato, ottimizzato e pratico, in cui tutti i dati della sessione verranno archiviati in un oggetto di sessione. Se questa opzione è attiva, anziché archiviare i dati della sessione nell'oggetto Attività utilizzando più voci, tutti i dati della sessione, inclusi i file associati, ad esempio registrazioni vocali, trascrizioni di chat e file multimediali caricati dall'utente finale, vengono inclusi nel nuovo oggetto sessione della piattaforma CCAI. Questo oggetto viene poi allegato alla richiesta appropriata (o, facoltativamente, direttamente a un oggetto Account).

Per informazioni sulla configurazione dell'amministratore per mappare i dati all'oggetto sessione, consulta Salesforce: CCAI Platform Session Object Installation and Configuration.

Dettagli dell'oggetto della sessione

Quando l'oggetto sessione è abilitato per la mappatura dei dati:

  • Tutti i dati della sessione della piattaforma CCAI verranno archiviati nel nuovo oggetto sessione della piattaforma CCAI, anziché nell'oggetto Attività predefinito.

  • L'oggetto della sessione della piattaforma CCAI verrà allegato direttamente alla richiesta.

  • A una richiesta possono essere associate più sessioni della piattaforma CCAI, se la configurazione e le sessioni dell'utente finale si allineano logicamente per consentire questo scenario, ad esempio se il consumatore richiama per lo stesso problema mentre la richiesta sottostante è ancora aperta.

Gerarchia dei dati degli oggetti della sessione

L'oggetto sessione è organizzato come segue:

Elenco di sessioni: l'elenco delle sessioni allegate a una richiesta.*

  • **Dettagli sessione: presenta i dettagli dell'oggetto della sessione principale**

    • Campi principali della sessione ed elenca tutti i trasferimenti e i file associati.

    • Elenco dei file: tutti i file caricati/creati nell'ambito della sessione.

  • Dettagli della sessione: presenta i dettagli principali dell'oggetto della sessione, ad esempio:

Interfaccia utente di esempio di più sessioni della piattaforma CCAI collegate a una richiesta

Panoramica della sessione

Dopo aver aperto una sessione, verrà visualizzata la seguente vista, che elenca tutte le azioni della sessione di CCAI Platform associate, i file allegati e i trasferimenti.

Panoramica della sessione

Dettagli sessione

Il set di dati disponibile per le sessioni include i seguenti campi:

  • ID chiamata o chat: ID chiamata o chat della piattaforma CCAI

  • Data e ora di creazione: quando è stata creata la chiamata o la chat

  • Ended at: quando la chiamata o la chat è terminata

  • Canale: tipo di chiamata o chat (ad esempio, Mobile, Web).

  • Tipo di sessione: chiamata o chat

  • Durata della chiamata: durata della sessione dall'inizio alla fine

  • Inserito in coda alle: ora in cui la sessione è stata inserita in coda

  • Assegnata alle: ora in cui la sessione è stata assegnata all'agente

  • Attesa: durata totale dell'attesa in coda prima dell'assegnazione a un agente per la sessione

  • Durata della messa in attesa: la durata della messa in attesa non include il tempo di attesa (solo chiamate)

  • Tipo di risposta: indica se la sessione ha ricevuto una risposta automatica (0) o manuale (1)

  • Motivo dell'errore: motivo per cui una sessione "non è riuscita" e dettagli.

  • Feedback: se attivato, mostra il feedback dei clienti raccolto durante la sessione registrata

  • Case: la richiesta a cui è associato l'oggetto della sessione

  • Menu iniziale selezionato: menu della coda iniziale selezionato

  • Percorso del menu materializzato: il percorso selezionato che porta alla connessione con l'agente

  • Lingua: la lingua utilizzata o selezionata per la sessione

  • Numero di telefono in uscita: numero di telefono in uscita applicabile

  • Stato: stato della sessione

  • Trasferimenti totali: il numero di trasferimenti totali durante la sessione

File

Tutti i file multimediali associati all'oggetto sessione sono allegati come file all'oggetto sessione. È incluso quanto segue:

  • Registrazioni delle chiamate

  • Cronologia chat

  • Pacchetto di diagnostica basato su SDK mobile

  • File multimediali inviati dagli utenti finali

Esempi di UI

UI dell'elenco dei file: esempio di elenco dei file di sessione per la registrazione delle chiamate

Elenco dei file di sessione per la registrazione delle chiamate

UI dei dettagli del file, ad esempio il caricamento di immagini da parte del consumatore.

Dettagli del file per il caricamento delle immagini dei consumatori

Azioni sessione

Riflette le attività della sessione:

  • Chiamata avviata

  • Sono arrivati i dati dei clienti personalizzati

  • Chiamata terminata

  • Feedback sulla valutazione dei clienti ricevuto

Esempio: UI dei dettagli dell'azione della sessione - Feedback dell'utente finale

Dettagli dell'azione della sessione per il feedback degli utenti finali

Trasferimenti

In questa sezione sono elencati tutti i trasferimenti associati alla sessione. Se non utilizzi già i dati dell'API, la sezione Dettagli trasferimento introduce un nuovo insieme di informazioni sulla chiamata. I dettagli del trasferimento rappresentano un resoconto completo di ogni trasferimento e sono definiti utilizzando i campi:

  • Nome del trasferimento: il nome del trasferimento.

  • ID trasferimento: l'ID univoco del trasferimento.

  • Agente trasferito da: l'agente che avvia il trasferimento della sessione

  • Agente trasferito a: l'agente che riceve il trasferimento della sessione

  • Created at: ora di creazione del trasferimento

  • Motivo dell'errore: motivo dell'errore di trasferimento della sessione

  • Menu trasferito da: il menu della coda di origine da cui è stato avviato il trasferimento

  • Menu trasferito a: menu della coda a cui è stata trasferita la sessione

  • Sessione: ID sessione della piattaforma CCAI

  • Stato: stato del trasferimento

  • Trasferimento da percorso materializzato: il trasferimento del percorso materializzato ha avuto origine da

  • Trasferimento al percorso materializzato: il percorso materializzato a cui è stata trasferita la sessione

Esperienza dell'agente di CCAI Platform in Salesforce Lightning

Fornire ad amministratori e agenti il comportamento previsto della piattaforma CCAI in Salesforce Lightning, in particolare quando si connettono all'oggetto Attività anziché all'oggetto Sessione della piattaforma CCAI.

Requisiti

  • Licenze Salesforce Service Cloud

  • App Salesforce Service Console Lightning

  • Istanza Salesforce aggiornata

  • Salesforce Lightning abilitato

  • CCAI Platform 1.15 o versioni successive

L'adattatore dell'agente

L'adattatore dell'agente verrà visualizzato in basso a sinistra nelle app Service Console Lightning (o Sales Console Lightning), nella barra delle utilità. Se non vedi l'adattatore telefonico della piattaforma CCAI, contatta il team Salesforce o IT della tua azienda.

Quando effettui o ricevi chiamate o chat, l'integrazione della piattaforma CCAI mostrerà automaticamente la richiesta di Salesforce.

Adattatore agente in Salesforce Lightning

Altre note

  • Il widget può essere ridotto a icona durante l'utilizzo.

  • La richiesta varia in base alle impostazioni di Salesforce.

  • La richiesta verrà assegnata automaticamente all'agente che risponde al ticket.

  • Viene creata automaticamente un'attività corrispondente, che viene correlata alla richiesta

Dati standard

Immediatamente dopo la creazione della richiesta, la piattaforma CCAI fornirà i dati standard nel campo Descrizione della richiesta. Sono inclusi l'ID chiamata, la lingua e la selezione del menu in entrata.

Dati standard della richiesta in Salesforce Lightning

Dati personalizzati

Se utilizzi dati personalizzati dagli SDK della piattaforma CCAI, le informazioni creeranno un'attività correlata alla richiesta. A seconda delle impostazioni di Salesforce, questa attività verrà visualizzata nel feed del publisher.

Attività di dati personalizzati in Salesforce Lightning

Esperienza dell'agente di CCAI Platform in Salesforce Classic

Le sezioni seguenti descrivono i comportamenti previsti tra Salesforce Classic e la piattaforma CCAI.

Requisiti

  • Licenze Salesforce Service Cloud

  • App Salesforce Service Console

  • Istanza Salesforce aggiornata

  • CCAI Platform 1.13 o versioni successive

Adattatore dell'agente

L'adattatore dell'agente verrà visualizzato in basso a destra nelle app Service Console (o Sales Console).

Adattatore agente in Salesforce Classic

Quando effettui o ricevi chiamate o chat, l'integrazione della piattaforma CCAI mostrerà automaticamente la richiesta di Salesforce.

Pop-up della richiesta di Salesforce Classic

Altre note

  • L'adattatore può essere ridotto a icona durante l'uso.

  • La richiesta varia in base alle impostazioni di Salesforce.

  • La richiesta verrà assegnata automaticamente all'agente che risponde al ticket.

  • Viene creata automaticamente un'attività corrispondente, che viene correlata alla richiesta

Dati standard

Immediatamente dopo la creazione della richiesta, la piattaforma CCAI fornirà i dati standard nel campo Descrizione della richiesta. Sono inclusi l'ID chiamata, la lingua e la selezione del menu in entrata.

Dati personalizzati

Se utilizzi dati personalizzati dagli SDK della piattaforma CCAI, le informazioni creeranno un'attività correlata alla richiesta. A seconda delle impostazioni di Salesforce, questa attività verrà visualizzata nel feed del publisher.

Attività di dati dei clienti personalizzati in Salesforce Classic

Salesforce: dettagli tecnici dell'oggetto sessione di CCAI Platform

L'oggetto sessione personalizzato della piattaforma CCAI fornisce un oggetto sessione della piattaforma CCAI personalizzato e ottimizzato, in cui verranno archiviati tutti i dati della sessione di chiamata o chat. Se attivata, anziché archiviare i dati della sessione nell'oggetto Attività utilizzando più voci, tutti i dati della sessione, inclusi i file associati come registrazioni vocali, trascrizioni di chat e file multimediali caricati dall'utente finale, vengono inclusi nell'oggetto della sessione della piattaforma CCAI. Questo oggetto viene poi correlato alla richiesta appropriata o direttamente a un oggetto Account configurato.

Per saperne di più, consulta Salesforce: mappatura delle sessioni della piattaforma CCAI agli oggetti caso o account (account personale, contatto, lead).

Oggetto sessione CCAI Platform

Quando l'oggetto sessione è abilitato:

  • Tutti i dati della sessione della piattaforma CCAI verranno archiviati nel nuovo oggetto sessione della piattaforma CCAI, anziché nell'oggetto "Attività" predefinito corrente.

  • L'oggetto della sessione della piattaforma CCAI sarà correlato direttamente all'oggetto Case o Account come singola relazione per ogni sessione.

  • Verranno rispettate le impostazioni per la "Creazione di richieste per chiamate abbandonate" configurate in Impostazioni > Gestione delle operazioni. Un oggetto sessione non verrà creato se l'impostazione "Crea ticket per chiamate/chat abbandonate" è disattivata.

  • È possibile che un oggetto caso o account abbia più sessioni della piattaforma CCAI correlate se la configurazione della piattaforma CCAI e le sessioni degli utenti finali si allineano logicamente per consentire questo scenario. Esempio: l'utente finale richiama per lo stesso problema mentre la richiesta di assistenza sottostante è ancora aperta.

Esempio di UI di più sessioni della piattaforma CCAI relative a una richiesta

Più sessioni correlate a una richiesta

Gerarchia dei dati dell'oggetto di sessione di CCAI Platform

L'oggetto sessione è organizzato come segue:

  • Elenco correlato di sessioni: l'elenco di sessioni correlate a un oggetto richiesta o account

    • Dettagli sessione: presenta i dettagli dell'oggetto della sessione principale

    • Campi della sessione di base: elenca tutti i trasferimenti e i file associati

    • Elenco dei file: tutti i file caricati o creati nell'ambito della sessione

      • Dettagli file: tutti i dettagli su un file, incluso l'accesso al file stesso
    • Azioni: un elenco di azioni che si sono verificate durante la sessione.

      • Dettagli azione: informazioni aggiuntive su un'azione specifica
    • Trasferimenti: elenco completo dei trasferimenti avvenuti durante la sessione

      • Dettagli trasferimento: mostra tutti i campi e i dati associati a un singolo evento di trasferimento

Panoramica della sessione di CCAI Platform

Dopo aver aperto una sessione, verrà visualizzata la seguente vista, che elenca tutte le azioni della sessione di CCAI Platform associate, i file allegati e i trasferimenti.

Panoramica della sessione

Campi del set di dati della sessione di CCAI Platform

Il set di dati disponibile per le sessioni include i seguenti campi. Per definizioni più dettagliate, consulta il dizionario dei dati.

  • ID chiamata/chat: l'ID univoco dell'interazione.

  • Data di creazione: la data di creazione della chiamata o della chat.

  • Terminata alle: l'ora in cui la chiamata o la chat è terminata.

  • Canale: il tipo di canale (ad esempio, mobile, web, IVR).

  • Tipo di sessione: il tipo di sessione o interazione.

  • Call duration: la durata della sessione dall'inizio alla fine.

  • In coda alle: l'ora in cui la sessione è entrata in coda.

  • Assegnata alle ore: l'ora in cui la sessione è stata assegnata all'agente.

  • Attesa: durata totale dell'attesa in coda prima dell'assegnazione a un agente per la sessione.

  • Durata della messa in attesa: durata del tempo di attesa, escluso il tempo di attesa (solo chiamate).

  • Tipo di risposta: indica se la sessione ha ricevuto una risposta automatica (0) o manuale (1).

  • Motivo dell'errore: il motivo per cui una sessione non è riuscita.

  • Feedback: se l'opzione è attiva, mostra il feedback dei clienti raccolto durante la sessione registrata.

  • Case: la richiesta a cui è associato l'oggetto della sessione.

  • Menu iniziale selezionato: menu della coda iniziale selezionato.

  • Percorso del menu materializzato: il percorso selezionato che porta alla connessione con l'agente.

  • Lingua: la lingua utilizzata o selezionata per la sessione.

  • Numero di telefono in uscita: numero di telefono in uscita applicabile.

  • Stato: lo stato della sessione.

  • Trasferimenti totali: il numero di trasferimenti totali durante la sessione.

File

Tutti i file multimediali associati all'oggetto sessione sono allegati come file all'oggetto sessione. È incluso quanto segue:

  • Registrazioni delle chiamate.

  • Cronologia chat.

  • Pacchetto di diagnostica basato sull'SDK per dispositivi mobili.

  • File multimediali inviati dagli utenti finali.

Esempi di UI

UI dell'elenco dei file: esempio di elenco dei file di sessione per la registrazione delle chiamate.

Elenco dei file di sessione per la registrazione delle chiamate

UI dei dettagli del file: esempio di caricamento di un'immagine da parte dell'utente finale.

Dettagli del file per il caricamento di immagini da parte dell'utente finale

Azioni sessione di CCAI Platform

Riflette le attività della sessione:

  • Chiamata avviata.

  • Sono arrivati i dati dei clienti personalizzati dal cliente.

  • Chiamata terminata. .

  • Feedback sulla valutazione dei clienti ricevuto

Esempio di UI dei dettagli delle azioni della sessione: feedback dell'utente finale.

Dettagli dell'azione della sessione per il feedback degli utenti finali

Trasferimenti

In questa sezione sono elencati tutti i trasferimenti associati alla sessione. Introduce un nuovo insieme di informazioni sulla chiamata che non è ancora disponibile nei report del portale di amministrazione (questi dati sono disponibili tramite API).

I dettagli del trasferimento rappresentano un resoconto completo di ogni trasferimento e sono definiti utilizzando i seguenti campi:

  • Nome del trasferimento: nome del trasferimento specifico della piattaforma CCAI.

  • ID trasferimento: l'ID del trasferimento.

  • Agente trasferito da: l'agente che avvia il trasferimento della sessione.

  • Agente trasferito a: l'agente che riceve il trasferimento della sessione.

  • Data/ora creazione: data e ora di creazione del trasferimento.

  • Fail reason: motivo dell'errore di trasferimento della sessione.

  • Menu trasferito da: il menu della coda di origine da cui è stato avviato il trasferimento.

  • Menu trasferito a: il menu della coda a cui è stata trasferita la sessione.

  • Session: ID sessione della piattaforma CCAI.

  • Stato: stato del trasferimento.

  • Trasferimento da percorso materializzato: il percorso materializzato da cui ha avuto origine il trasferimento.

  • Trasferimento al percorso materializzato: il percorso materializzato a cui è stata trasferita la sessione.

Ricerca di account in base a più numeri

Gli amministratori possono configurare il portale della piattaforma CCAI in modo che cerchi un account in più campi del numero di telefono in Salesforce. In questo modo è più facile collegare diverse sessioni di assistenza a un unico account per i consumatori che hanno più numeri di telefono, ad esempio numeri di cellulare, di casa o di lavoro. Questa funzionalità è valida sia per le chiamate in entrata che per quelle in uscita.

Crea un nuovo campo del numero di telefono in Salesforce

Tutti i campi dei numeri di telefono esistenti in Salesforce sono disponibili per l'utilizzo come campo di ricerca del numero di telefono. Se vuoi aggiungere altri campi per i numeri di telefono, puoi crearne uno nuovo. Per aggiungere un nuovo campo del numero di telefono

  1. Vai a Object Manager (Gestore oggetti).

  2. Seleziona l'account da modificare.

  3. Fai clic su Fields & Relationships (Campi e relazioni).

  4. Fai clic su Nuovo per aggiungere un nuovo campo.

  5. Inserisci le informazioni per il nuovo campo del numero di telefono. Ad esempio, se aggiungi un numero di cellulare, puoi inserire Cellulare come Field Label, il numero di cellulare come Field Name e Telefono come Data Type.

  6. Dopo aver creato il nuovo campo, questo verrà visualizzato come opzione di campo di ricerca nel portale della piattaforma CCAI. Puoi quindi aggiungerlo come numero di telefono di ricerca per un account.

Aggiungi numeri di telefono come numeri di ricerca nel portale della piattaforma CCAI

Tutti i tipi di numeri di telefono in ogni oggetto CRM (contatto, account, lead e così via) sono selezioni disponibili nel portale della piattaforma CCAI. Puoi aggiornare quanto segue:

  • Campi di ricerca del numero di telefono: campi di ricerca del numero di telefono con il nome precedente. Questa opzione consente di selezionare più numeri di telefono, ad esempio cellulare, telefono dell'account, fax dell'account. Puoi quindi associare questi numeri allo stesso account.

  • Campi principali del numero di telefono:questo campo cambia a seconda di ciò che selezioni per i campi di ricerca del numero di telefono. Offre la possibilità di selezionare il campo del numero di telefono da utilizzare quando crei un nuovo account CRM.

Per aggiungere più numeri di telefono come numeri di ricerca aggiuntivi:

  1. Vai a Impostazioni sviluppatore > Ricerca account.

  2. Seleziona Object (Oggetto) e Record Type (Tipo di record) a cui applicare i campi di ricerca.

  3. Nell'elenco a discesa Campi di ricerca del numero di telefono, seleziona i numeri di telefono da utilizzare come numeri di ricerca aggiuntivi.

  4. Fai clic su Salva nella casella a discesa.

  5. Seleziona il numero di telefono principale da utilizzare quando la piattaforma CCAI crea un nuovo account CRM. Questo elenco a discesa cambia in base ai numeri di telefono selezionati per il campo precedente.

  6. Fai clic su Salva nella sezione Impostazioni sviluppatore. I numeri di ricerca che hai selezionato ora si collegheranno allo stesso account.

Modifiche alle autorizzazioni di ricerca flessibile di Salesforce

Per la ricerca di account flessibili, il set di autorizzazioni dell'agente deve essere modificato per aprire la flessibilità in merito al modo in cui la piattaforma CCAI gestisce i dati e il flusso di processo di Salesforce.

Esempi di casi d'uso

  • Disattivazione della creazione di casi e associazione dell'oggetto Sessione della piattaforma CCAI a un account, un account personale o un oggetto account personalizzato.

  • Disattivazione della creazione di richieste e associazione dell'oggetto Sessione della piattaforma CCAI agli oggetti dell'account Salescloud, come Lead e Opportunità.

Ulteriori passaggi di configurazione

  1. Vai alla pagina delle impostazioni Set di autorizzazioni. Vedrai un set di autorizzazioni UJET_Agent clonato.

  2. Fai clic su Object Settings (Impostazioni oggetto).

  3. Vedrai che l'oggetto Case and Contact dispone delle autorizzazioni Read, Create, Edit e View All, ma Accounts no. Il passaggio successivo consiste nell'aggiungere le autorizzazioni anche per l'account.

  4. Aggiungi l'accesso Read (Lettura), Create, Edit (Crea, Modifica) e View All (Visualizza tutto) alle autorizzazioni dell'oggetto account e salvalo.

  5. Aggiungi l'autorizzazione per il campo di tipo Attività.

  6. Seleziona le caselle per consentire l'accesso in lettura e l'accesso in modifica per il campo Tipo.

Chiamate in uscita flessibili

La gestione flessibile delle chiamate in uscita offre flessibilità e granularità per la gestione delle chiamate in uscita.

Richiede il pacchetto CRM v1.24 e, per Sales Cloud, la versione v1.26.

Gli amministratori possono configurare se gli agenti possono creare o meno una richiesta e se possono comporre un numero che non verrà utilizzato per la ricerca di un account o l'associazione di una sessione.

Molti nuovi aggiornamenti all'adattatore per chiamate dell'agente

  • Esamina e seleziona tra più record di account corrispondenti

  • Seleziona tra le richieste aperte associate all'account selezionato

  • Crea nuova richiesta

  • Opzione configurabile per non creare un ticket o crearne uno nuovo

  • Gestione di più record di account corrispondenti

  • Associazione flessibile dei ticket alle sessioni

Dettagli della funzionalità

  • In questa sezione e nell'interfaccia utente dell'adattatore dell'agente viene fatto riferimento all'oggetto o al termine Account, tuttavia l'oggetto a cui viene fatto riferimento come "Account" potrebbe essere diverso in base alla configurazione in Impostazioni sviluppatore.

  • Le dipendenze delle impostazioni, come quelle per l'aggiunta di chiamate o chat alle richieste esistenti, influiscono su questa funzionalità.

  • La configurazione salvata in Impostazioni > Impostazioni sviluppatore per la ricerca dell'account può essere sostituita dalla selezione dell'agente nell'adattatore dell'agente se viene sincronizzato un oggetto diverso da quello principale

Dettagli dei campi ID account e ID richiesta

Questa sezione descrive in dettaglio i campi ID account e case ID nell'Agent Adapter.

Etichette

In questo documento e nell'interfaccia utente dell'adattatore dell'agente viene fatto riferimento all'oggetto o al termine Account, tuttavia l'oggetto a cui viene fatto riferimento come "Account" potrebbe essere diverso in base alla configurazione in Impostazioni sviluppatore.

  • Il tipo di oggetto, impostato nel portale di amministrazione > Impostazioni > Impostazioni sviluppatore, in Ricerca account, compila il campo denominato "ID account".

  • Il campo "ID richiesta" può essere disattivato.

Questa UI verrà aggiornata per aggiornare i campi dell'adattatore dell'agente in modo dinamico in base alle impostazioni in una release futura.

Comportamento dell'account e della richiesta

Questa sezione descrive come vengono selezionati l'ID account e l'ID richiesta.

ID account

L'ID account può essere selezionato tramite:

  1. Clic sul numero di telefono dal record Account o Contatto

  2. Fare clic sull'icona di sincronizzazione per sincronizzare quando si è nella pagina di un record di un account o di un contatto

  3. Inserimento di un numero di telefono in uscita associato a un account

  4. Fai clic su un numero di telefono in una richiesta associata a un ID account e a una richiesta

ID richiesta

L'ID richiesta può essere selezionato tramite:

  1. Una volta selezionato l'ID account tramite una delle opzioni precedenti, la piattaforma CCAI verifica la presenza di uno o più casi aperti per l'ID account selezionato e seleziona quello più recente o consente all'agente di selezionarlo in base alle tue impostazioni.

    Quando l'ID account è selezionato e l'opzione Prompt agents to select open case from list (when applicable) (Chiedi agli agenti di selezionare la richiesta aperta dall'elenco, se applicabile) è abilitata, seleziona un'opzione dall'elenco delle richieste aperte.

    Quando l'ID account è selezionato e l'opzione Consenti all'agente di selezionare l'opzione "Crea una nuova richiesta" per le chiamate in uscita è abilitata, viene inserito un nuovo case ID nel campo e CCAI Platform apre una richiesta e la chiamata allega i dati della sessione alla richiesta utilizzando l'attività o l'oggetto Sessione di CCAI Platform.

    Seleziona la richiesta aperta dall'elenco

Comportamento del pulsante di sincronizzazione

Pulsante di sincronizzazione in Salesforce

Il pulsante Sincronizza funziona con i seguenti tipi di oggetti Salesforce:

  • Pagina Richiesta

    • CCAI Platform trova l'oggetto di ricerca corrente: Contact, Account, Person Account o Lead

    • Il campo del numero di telefono viene compilato in base all'impostazione predefinita del telefono

  • Pagina Contact (Contatto), Account, PersonAccount (Account personale) o Lead

    • Se l'oggetto corrente è dello stesso tipo dell'oggetto di ricerca, l'oggetto viene compilato, così come il campo del numero di telefono dell'oggetto.

    • Se l'oggetto corrente non è lo stesso di un oggetto di ricerca (impostato in Impostazioni sviluppatore), viene compilato il numero di telefono del campo del telefono predefinito.

  • La pagina contiene una sessione, un task o un'attività di CCAI Platform

    • CCAI Platform verifica se l'oggetto ha l'associazione dell'oggetto di ricerca corrente.

      • Ad esempio, con l'oggetto Sessione di CCAI Platform, potrebbe essere UJET__Contact__c, UJET__Account__c, UJET__Lead__c.
    • Se non esiste un'associazione di oggetti di ricerca, le informazioni non possono essere sincronizzate

Configurazione di CCAI Platform

Configura gli oggetti di ricerca e le impostazioni di gestione delle operazioni nel portale della piattaforma CCAI.

Imposta oggetto di ricerca

In base al modello e al processo dei dati, puoi scegliere l'oggetto di ricerca principale quando interagisci con Salesforce.

Configurazione personalizzata: attiva o disattiva Cases

Quando utilizzi l'oggetto Sessione della piattaforma CCAI per mappare i dati della sessione a Salesforce, hai la possibilità di disattivare i casi. Se questa impostazione è disattivata, il campo ID richiesta nell'adattatore agente non sarà più disponibile.

  1. Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.

  2. Nella sezione Dati della sessione, quando è selezionata la sessione della piattaforma CCAI, attiva o disattiva l'opzione Collega le sessioni della piattaforma CCAI direttamente all'oggetto di ricerca dell'account. Non verranno create richieste.

Configurazione personalizzata: gestione delle operazioni

  1. Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.

  2. Nella sezione Più account o richieste, attiva o disattiva:

    Chiedi agli agenti di selezionare la richiesta aperta dall'elenco (se applicabile):

    Disattivata: verrà selezionata automaticamente la richiesta aperta più recente associata al contatto o all'account.

    Attivato: all'agente verrà chiesto di selezionare tra tutte le richieste aperte associate al contatto o all'account.

    Quando l'opzione precedente è attiva, è possibile attivare Consenti all'agente di selezionare l'opzione "Crea una nuova richiesta" per le chiamate in uscita. Se l'opzione è disattivata, l'agente deve utilizzare una richiesta esistente aperta.

    Consenti all'agente di selezionare l'opzione "Non creare una richiesta" per le chiamate in uscita

    1. Quando le impostazioni indicano che i dati della sessione sono mappati all'oggetto Sessione della piattaforma CCAI, i dati della chiamata, inclusa la registrazione della chiamata, verranno archiviati nella Sessione della piattaforma CCAI e associati all'oggetto di ricerca selezionato.

      Adattatore agente: il campo ID richiesta non verrà più visualizzato nell'interfaccia utente.

    2. Quando le impostazioni indicano che i dati della sessione sono mappati all'oggetto Attività, non verranno memorizzati dati della chiamata, inclusa la registrazione della chiamata. Non attivare questa opzione se le normative o gli standard di conformità richiedono l'accesso a tutte le registrazioni delle chiamate, perché la piattaforma CCAI non sarà in grado di recuperare le registrazioni delle chiamate per le quali non è stato creato un caso.

    Consenti l'opzione "Utilizza il numero inserito per effettuare la chiamata"

    Attivato: gli agenti possono selezionare l'ID account, quindi inserire un numero non salvato nell'account o nel contatto per effettuare una chiamata. I numeri non verranno memorizzati nell'account o nel contatto.

    Disattivato: le chiamate in uscita possono essere effettuate solo verso i numeri memorizzati nell'oggetto Account o Contatto.

Esperienza con l'agente

Questa sezione descrive l'esperienza dell'agente nell'adattatore dell'agente.

UI dell'agente

L'immagine seguente mostra un esempio di adattatore per chiamate con tutte le opzioni attivate.

Adattatore per chiamate con tutte le opzioni attivate

  1. La selezione della lingua e del numero in uscita determina quale numero verrà visualizzato quando il chiamante risponde alla chiamata. Per maggiori dettagli, consulta Più numeri in uscita.

  2. Mostra il numero di telefono attualmente selezionato, sincronizzato o inserito a cui verrà effettuata la chiamata.

  3. L'icona del tastierino apre la schermata di inserimento del numero di telefono, dove puoi inserire o incollare un numero di telefono.

  4. Seleziona la casella di controllo per utilizzare un numero non associato all'account o al contatto selezionato. Consulta l'opzione "Utilizza il numero inserito per effettuare la chiamata". Potrebbe non essere presente in base alle impostazioni.

  5. Quando fai clic sul pulsante di sincronizzazione, le informazioni della scheda aperta vengono utilizzate per compilare i campi ID account o ID richiesta.

  6. Il campo ID account mostra la ricerca principale, in base alle impostazioni di amministrazione in Impostazioni > Impostazioni sviluppatore > Ricerca account > Oggetto di ricerca. Descritte in dettaglio nella sezione Etichette.

  7. Il campo ID richiesta mostra il tipo di record selezionato, in base alle impostazioni dell'amministratore in Impostazioni > Impostazioni sviluppatore > Ricerca account | Oggetto di ricerca. Descritte in dettaglio nella sezione Etichette. Potrebbe non essere presente in base alle impostazioni.

  8. Una volta selezionati l'account e l'ID richiesta, Chiama effettua la chiamata in uscita.

  9. Annulla ti riporta alla UI principale di Agent Adapter.

Variabili della UI dell'agente

L'adattatore dell'agente mostrerà diverse opzioni e visualizzazioni in base alle impostazioni sviluppatore e alle impostazioni di gestione delle operazioni.

Impostazioni della Console di amministrazione che possono influire sull'esperienza dell'agente
  • Non aggiungere la sessione di chiamata o di chat a un ticket aperto esistente

  • Chiedi agli agenti di selezionare la richiesta aperta dall'elenco (se applicabile)

  • Consenti all'agente di selezionare l'opzione "Crea una nuova richiesta" per le chiamate in uscita

  • Consenti all'agente di selezionare l'opzione "Non creare una richiesta" per le chiamate in uscita

  • Consenti l'opzione "Usa il numero inserito per effettuare la chiamata"

  • Collega le sessioni della piattaforma CCAI direttamente all'oggetto di ricerca dell'account. Non verranno create richieste

Dati CRM che influiscono sull'esperienza dell'agente
  • Numero di contatti con lo stesso numero di telefono

    • Nessun contatto con numero di telefono

    • Un solo contatto con numero di telefono

    • Più contatti con numero di telefono

  • Numero di richieste aperte

    • Nessuna custodia

    • Solo un caso

    • Più richieste

Effettuare una chiamata in uscita

Gli agenti possono effettuare chiamate in uscita da Salesforce.

Chiamata in uscita effettuata

Gli agenti possono effettuare una chiamata in uscita direttamente utilizzando il tastierino.

Effettuare una chiamata sincronizzando la pagina corrente in Salesforce

  1. In Salesforce, vai a una richiesta, un contatto, un account o un lead.

  2. Fai clic su Sincronizza nell'adattatore agente.

  3. Se necessario, seleziona gli oggetti ID account e ID richiesta dai menu a discesa.

    Tieni presente i tre fattori che influiscono sulla schermata dell'adattatore che vedrai dopo la sincronizzazione

    Le impostazioni dell'ambiente: seleziona l'opzione Seleziona tra le richieste aperte abilitata o disabilitata, l'opzione Crea una nuova richiesta abilitata o disabilitata, l'opzione Non creare una richiesta abilitata o disabilitata

    Opzioni dell'adattatore per chiamate dopo la sincronizzazione

    Numero di contatti con lo stesso numero di telefono

    Nessun contatto con numero di telefono

    Un solo contatto con numero di telefono

    Più contatti con numero di telefono

    Numero di richieste aperte

    Nessuna custodia

    Solo un caso

    Più richieste

    Fai clic su Chiama.

Utilizza il numero inserito per effettuare l'opzione di chiamata

Un account specifico potrebbe avere più sedi o contatti e non tutti i numeri di telefono vengono salvati nell'account o nel contatto. In questa situazione, i tuoi agenti potrebbero dover aggiungere partecipanti con una telefonata a numeri non salvati nell'account/contatto. Questa opzione consente a un agente di aggiungere (partecipanti) con una telefonata a un numero non salvato nel contatto, associando comunque la richiesta al contatto. Il numero composto verrà salvato nei commenti dell'oggetto della sessione della piattaforma CCAI. Per attivare questa funzionalità, consulta Configurazione personalizzata: gestione delle operazioni.

  1. In Salesforce, individua l'account o il contatto e fai clic sul pulsante di sincronizzazione nell'adattatore agente.

  2. (Facoltativo) Fai clic sul pulsante di attivazione/disattivazione Chiama un numero separato per chiamare un numero diverso da quello utilizzato per trovare l'account o il record CRM.

  3. Fai clic sull'icona del tastierino per modificare il numero.

  4. Incolla o inserisci il numero di telefono nel campo corrispondente.

  5. Fai clic su Chiama.

Punto di accesso diretto all'API - API REST Salesforce

Il punto di accesso diretto (DAP) dell'API consente di implementare la logica di routing direttamente da un'origine API. Salesforce fornisce la classe APEX REST per recuperare i dati che la piattaforma CCAI può utilizzare per indirizzare i chiamanti utilizzando l'API per i punti di accesso diretto (DAP). A differenza di altre opzioni DAP, la logica AND può essere utilizzata con più coppie chiave-valore.

Configurazione dell'amministratore Salesforce

Configura la classe APEX REST e le impostazioni di sicurezza in Salesforce.

Prepara la classe APEX REST su Salesforce

  1. Cerca rapidamente "apex".

  2. Seleziona Custom Code (Codice personalizzato) > Apex Classes (Classi Apex) > New (Nuovo).

    Crea una nuova classe Apex in Salesforce

Crea una classe APEX REST

Anche se il tuo codice sarà diverso, vedi l'esempio seguente:

@RestResource(urlmapping = '/searchVIP')
global class UJETVIPSearch {
    @httpPOST
    global static void searchVIP(){
        RestRequest req = RestContext.request;
        RestResponse res = RestContext.response;
        responsewrapper response= new responsewrapper();
        try{
            requestWrapper jsonBody;
            jsonBody  = (requestWrapper) JSON.deserialize(req.requestBody.toString(), requestWrapper.class);

            String aninumber = jsonBody.phone;
            // CCAI Platform will send phone parameter in format %222%333%4444
            if(string.isNotBlank(aninumber)){
                integer cnt = [SELECT count() from Contact where Contact.Phone like :aninumber AND VIP__c = true];
                response.is_vip = (cnt > 0);
                res.responseBody = blob.valueof(JSON.serialize(response));
            }
            else{
                res.statuscode = 404;
                res.responseBody = blob.valueof('No Contact found');
            }
        }
        catch(exception e){
            res.statuscode = 500;
            res.responseBody = blob.valueof(e.getmessage());
        }
    }
    public class responsewrapper{
        public boolean is_vip;
    }
    public class requestWrapper{
        public string phone;
    }
}

Modifica sicurezza

Poiché alla classe Apex REST si accederà tramite il token OAuth dell'agente, dovrai aggiungere tutti i profili agente applicabili nella colonna "Profili abilitati".

  1. Una volta creata la classe APEX Rest, fai clic su Sicurezza per modificarla.

    Impostazione di sicurezza della classe Apex

  2. Seleziona tutti i profili degli agenti.

  3. Fai clic sulla freccia per aggiungere il profilo alla colonna Enabled Profiles (Profili attivati).

  4. Fai clic sul pulsante Salva.

    Profili abilitati in Salesforce

Configurazione

  • Scegli tra le opzioni di logica di routing disponibili

  • Abilita e configura nel portale della piattaforma CCAI

  • Crea DAP nelle impostazioni della coda

Testa il routing

  1. Chiama l'IVR utilizzando un numero di telefono che dovrebbe attivare l'API DAP.

  2. Verifica che la chiamata venga inoltrata alla coda corretta.