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:
Nel portale della piattaforma CCAI, fai clic su Impostazioni > Impostazioni sviluppatore. Se non vedi il menu Impostazioni, fai clic su Menu.
Nel riquadro CRM, per SFDC Cloud Selection, seleziona Service Cloud o Sales Cloud, a seconda di quello che stai configurando.
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.
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.
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.
Per configurare l'oggetto di ricerca principale, vai alla sezione Oggetto di ricerca principale e segui questi passaggi:
Per definire l'oggetto di ricerca principale, segui questi passaggi:
Nell'elenco Tipo di oggetto, seleziona il tipo di oggetto di ricerca.
(Facoltativo) Nel campo Tipi di record, seleziona un tipo di record.
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).
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.
Per criptare il numero di telefono nel campo di ricerca, seleziona la casella di controllo Il campo di ricerca del numero di telefono è criptato.
Nell'elenco Formato numero di telefono, seleziona il formato del numero di telefono.
Per configurare un campo di ricerca personalizzato per le sessioni provenienti dall'SDK web o dagli SDK mobile, segui questi passaggi:
Seleziona la casella di controllo SDK per dispositivi mobili/web: cerca gli utenti in base al campo personalizzato per le sessioni SDK.
Nell'elenco Campo di ricerca personalizzato nel CRM, seleziona il campo di ricerca personalizzato.
Per configurare i campi di visualizzazione dell'account CRM nell'adattatore per chiamate, segui questi passaggi:
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.
(Facoltativo) Per visualizzare un secondo campo, segui questi passaggi:
Seleziona la casella di controllo Mostra un secondo campo.
Nell'elenco Secondo campo di visualizzazione, seleziona un campo.
Per Posizione di visualizzazione del secondo campo, configura se il secondo campo viene visualizzato prima o dopo il campo di visualizzazione dell'account corrispondente.
(Facoltativo) Per configurare un oggetto di ricerca secondario, segui questi passaggi:
Seleziona la casella di controllo Secondary Lookup Object (Oggetto di ricerca secondario).
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.
Per configurare i campi di visualizzazione dei record CRM nell'adattatore per chiamate, segui questi passaggi:
Nell'elenco Campo di visualizzazione del record corrispondente, seleziona il campo (dal record corrispondente) da visualizzare nel campo dell'adattatore per chiamate.
(Facoltativo) Per visualizzare un secondo campo, segui questi passaggi:
Seleziona la casella di controllo Mostra un secondo campo.
Nell'elenco Secondo campo di visualizzazione, seleziona un campo.
(Facoltativo) Per visualizzare un terzo campo, segui questi passaggi:
Seleziona la casella di controllo Visualizza un terzo campo.
Nell'elenco Terzo campo di visualizzazione, seleziona un campo.
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:
Accedi a Salesforce come amministratore.
In Setup (Configurazione), inserisci omni nella casella Quick Find (Ricerca rapida), quindi seleziona Omni-Channel Settings (Impostazioni omnicanale).
Seleziona Enable Omni-Channel (Attiva omnicanale).
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.
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).
Fai clic su Nuovo.
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.
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.
In Setup (Configurazione), inserisci App nella casella Quick Find (Ricerca rapida), quindi seleziona Apps (App) in Create (Crea).
Fai clic sul pulsante Modifica a sinistra di Sample Console (potresti avere un nome diverso).
Nella schermata di modifica, individua la sezione Choose Console Components (Scegli componenti della console).
Seleziona Omnicanale nell'elenco a discesa Elementi disponibili.
Fai clic su Aggiungi, quindi Omnicanale verrà visualizzato nell'elenco a discesa Elementi selezionati.
Fai clic su Save nella parte inferiore dello schermo.
Salesforce Lightning
Se utilizzi solo la versione classica, salta questo passaggio.
Se utilizzi Classic, fai clic su Passa a Lightning Experience.
Fai clic sull'icona a forma di ingranaggio, poi su Setup (Configurazione) nell'area in alto a destra della schermata Lightning.
In Setup (Configurazione), inserisci App nella casella Quick Find (Ricerca rapida), quindi seleziona App Manager (Gestione app) in Apps (App).
Fai clic sull'icona della Freccia giù in alto a destra nella Console di assistenza (potrebbe avere un nome diverso).
Fai clic su Modifica.
Fai clic su Utility Items (Elementi di utilità) nella schermata Lightning App Builder (Generatore di app Lightning).
Fai clic su Add Utility Item (Aggiungi elemento di utilità) e seleziona Omni-Channel (Omnicanale).
Fai clic su Salva.
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.
In Setup (Configurazione), inserisci Users (Utenti) nella casella di ricerca rapida, quindi seleziona Profiles (Profili) in Manage Users (Gestisci utenti).
Nella sezione principale, fai clic sul nome di un profilo a cui vuoi concedere l'accesso a Service Presence Status.
Trova Enabled Service Presence Status Access (Accesso allo stato di presenza del servizio abilitato) e fai clic su Edit (Modifica).
Nella schermata di modifica, seleziona gli elementi nell'elenco a discesa Stati di presenza del servizio disponibili e fai clic su Aggiungi.
Fai clic su Salva.
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.
Se ti trovi in Configurazione, fai clic su Torna alla console di esempio.
Fai clic su Omnicanale.
Fai clic sul link Offline nel widget Omni-Channel.
Seleziona uno degli stati di presenza del servizio e verifica se puoi modificarlo.
Salesforce Lightning
Se utilizzi solo la versione classica, salta questo passaggio.
Nella parte in basso a sinistra della schermata della console, fai clic sul pulsante Omni-Channel.
Fai clic sul link Offline nel widget Omni-Channel.
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.
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).
Fai clic su New Remote Site (Nuovo sito remoto).
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.
Nel portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.
Token amministratore Salesforce.
Fai clic su Collega nuovo utente.
Nella finestra di dialogo OAuth, accedi come amministratore di Salesforce e consenti la richiesta OAuth.
Vedrai il tuo utente amministratore collegato nella sezione Utenti amministratori collegati.
Attiva la mappatura dello stato
Dal portale di amministrazione, vai a Impostazioni > Impostazioni sviluppatore > Eredità dello stato dell'agente omnicanale di Salesforce.
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
Accedi al portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.
Ereditarietà dello stato dell'agente omnicanale di Salesforce.
Fai clic su Gestisci in Mappatura stato.
Nella finestra di dialogo, seleziona uno stato della piattaforma CCAI preferito per ogni stato di Salesforce.
Raccogli la chiave e il secret dell'azienda
Accedi al portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore.
Company Key & Secret Code.
Raccogli la chiave aziendale e il codice segreto aziendale.
Identifica il nome dell'app connessa
In Salesforce, vai a Setup (Configurazione), inserisci app nella casella di ricerca rapida, quindi seleziona Connected Apps (App connesse) in Manage Apps (Gestisci app).
Identifica il nome dell'app connessa alla piattaforma CCAI.
Installa l'app CCAI Platform Agent Status Inheritance
Incolla il link di installazione nella barra degli indirizzi del browser: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t6g000003Rzxv
Seleziona Installa per tutti gli utenti.
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
In Setup (Configurazione), inserisci package (pacchetto) nella casella Quick Find (Ricerca rapida), quindi seleziona Installed Packages (Pacchetti installati).
Fai clic su Configura a sinistra di UJET_App_Status.
Nella nuova finestra, fai clic su Aggiungi nuova configurazione.
Nella schermata di configurazione, seleziona Organizzazione come Proprietario della configurazione.
Compila i valori per Company Key, Company Secret, Tenant name e Connected App name che hai copiato nei passaggi precedenti.
Seleziona Attiva l'ereditarietà dello stato dell'agente.
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.
Fai clic su Save CCAI Platform Configuration (Salva configurazione della piattaforma CCAI).
Chiudi la finestra.
Verifica che l'app Agent Status Inheritance funzioni
Modifica lo stato omnicanale nella console.
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:
Nel portale della piattaforma CCAI, fai clic su Impostazioni > Gestione delle operazioni. Se non vedi il menu Impostazioni, fai clic su Menu.
Vai al riquadro Dettagli creazione record CRM.
Per Dati della sessione, nell'elenco Mappa i dati a, seleziona Sessione CCAI Platform.
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
In Configurazione di Salesforce, vai a Set di autorizzazioni.
Individua e seleziona il set di autorizzazioni CCAI Platform Agent Clone (potrebbe avere un nome diverso nelle tue impostazioni).
Seleziona Object Settings (Impostazioni oggetto).
Individua le seguenti autorizzazioni:
- Azioni di CCAI Platform
- Sessioni di CCAI Platform
- Trasferimenti di CCAI Platform
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.
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.
In Salesforce Setup, vai a Object Manager > Case OPPURE all'oggetto Account configurato.

Fai clic su Case (Richiesta) o sull'oggetto Account Page Layouts (Layout di pagina) a sinistra.
Seleziona il layout di pagina utilizzato dagli utenti della piattaforma CCAI.
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.

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.
In Salesforce Setup, vai a Setup > Object Manager > Case > Lightning Record Page.
Fai clic su Nuovo.

Fai clic su Registra pagina, poi su Avanti.

Crea un'etichetta, seleziona Richiesta come oggetto e fai clic su Avanti.
Scegli un modello di pagina e fai clic su Fine.
Includi il componente con l'oggetto Sessione di CCAI Platform. Nel seguente scenario, è stato aggiunto al componente "Elenco correlato".

Fai clic su Salva.
Fai clic su Attiva.
Segui il flusso di configurazione di Salesforce per assegnare la pagina all'applicazione che utilizzi in Lightning.
Configurazione del portale CCAI Platform
Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.
Scorri fino a Configura i dettagli di creazione dei ticket e seleziona i comportamenti preferiti.
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
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.
Vai a Impostazioni > Impostazioni sviluppatore > CRM > Salesforce > Dati della sessione.
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.
V 1.16 - supporto di sessioni, trasferimenti, azioni, file
URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t4M000000syZQ&isdtp=p1
V 1.17 - aggiunto il campo Email nell'oggetto Account (UJET__Email__c)
URL: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t4M000000kkWd&isdtp=p1
Aggiornamenti della configurazione di Salesforce
In Salesforce sono necessarie le seguenti modifiche alla configurazione.
Passaggio 1: aggiorna le impostazioni degli oggetti
In Configurazione di Salesforce, vai a Gestore oggetti > Set di autorizzazioni.
Sessioni di oggetti.
Individua e seleziona il set di autorizzazioni CCAI Platform Agent (potrebbe avere un nome diverso nelle tue impostazioni).
Seleziona Object Settings (Impostazioni oggetto).

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.)

Fai clic sull'oggetto Agent Actions e attiva l'accesso Read, Create, Edit e View All, quindi fai clic su Save.
Ripeti questo passaggio per CCAI Platform Sessions e CCAI Platform Transfers.
Passaggio 2: aggiorna il layout di pagina della richiesta
In Salesforce Setup, vai alla sezione Case Page Layout (questo percorso varia per Classic e Lightning)
Seleziona i layout delle richieste utilizzati dagli utenti della piattaforma CCAI.
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.
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.
In Configurazione di Salesforce, vai a Configurazione > Gestore oggetti > Caso > Pagina dei record Lightning.
Fai clic su Nuovo.

Fai clic su Registra pagina, poi su Avanti.

Crea un'etichetta, seleziona Richiesta come oggetto e fai clic su Avanti.
Scegli un modello di pagina e fai clic su Fine.
Includi il componente con l'oggetto della sessione di CCAI Platform. Nel seguente scenario è stato aggiunto al componente Related List (Elenco correlato).

Fai clic su Salva.
Fai clic su Attiva.
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.
- Questa opzione può essere disattivata nelle impostazioni di gestione delle operazioni generali.
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.


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 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
Nel portale della piattaforma CCAI, vai a Impostazioni > Impostazioni sviluppatore e seleziona Salesforce.

Seleziona un Tipo di oggetto:
Contatto
Account personale
Account
Lead
Seleziona un Tipo di record. Queste opzioni variano in base al tipo di oggetto selezionato.
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.
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.

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.

Oggetto Attività: i dati della sessione vengono archiviati nell'oggetto Attività di Salesforce. I record verranno creati con questa opzione.
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.
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.
In qualità di amministratore di Salesforce, vai alla pagina Setup (Configurazione).
Utilizzando il campo di ricerca, vai alla pagina delle impostazioni Permission Set (Set di autorizzazioni).
Vedrai qualcosa di simile al set di autorizzazioni UJET_Agent.

Seleziona il set di autorizzazioni UJET_Agent.

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.

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.

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.

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

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

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

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.

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 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.

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).

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

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.

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

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.

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.

UI dei dettagli del file: esempio di caricamento di un'immagine 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.

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
Vai a Object Manager (Gestore oggetti).
Seleziona l'account da modificare.
Fai clic su Fields & Relationships (Campi e relazioni).
Fai clic su Nuovo per aggiungere un nuovo campo.
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 comeField Namee Telefono comeData Type.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:
Vai a Impostazioni sviluppatore > Ricerca account.
Seleziona Object (Oggetto) e Record Type (Tipo di record) a cui applicare i campi di ricerca.
Nell'elenco a discesa Campi di ricerca del numero di telefono, seleziona i numeri di telefono da utilizzare come numeri di ricerca aggiuntivi.
Fai clic su Salva nella casella a discesa.
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.
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
Vai alla pagina delle impostazioni Set di autorizzazioni. Vedrai un set di autorizzazioni UJET_Agent clonato.
Fai clic su Object Settings (Impostazioni oggetto).
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.
Aggiungi l'accesso Read (Lettura), Create, Edit (Crea, Modifica) e View All (Visualizza tutto) alle autorizzazioni dell'oggetto account e salvalo.
Aggiungi l'autorizzazione per il campo di tipo Attività.
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:
Clic sul numero di telefono dal record Account o Contatto
Fare clic sull'icona di sincronizzazione per sincronizzare quando si è nella pagina di un record di un account o di un contatto
Inserimento di un numero di telefono in uscita associato a un account
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:
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.

Comportamento del pulsante di sincronizzazione

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.
Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.
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
Nel portale della piattaforma CCAI, vai a Impostazioni > Gestione delle operazioni.
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
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.
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.

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.
Mostra il numero di telefono attualmente selezionato, sincronizzato o inserito a cui verrà effettuata la chiamata.
L'icona del tastierino apre la schermata di inserimento del numero di telefono, dove puoi inserire o incollare un numero di telefono.
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.
Quando fai clic sul pulsante di sincronizzazione, le informazioni della scheda aperta vengono utilizzate per compilare i campi ID account o ID richiesta.
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.
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.
Una volta selezionati l'account e l'ID richiesta, Chiama effettua la chiamata in uscita.
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
In Salesforce, vai a una richiesta, un contatto, un account o un lead.
Fai clic su Sincronizza nell'adattatore agente.
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

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.
In Salesforce, individua l'account o il contatto e fai clic sul pulsante di sincronizzazione nell'adattatore agente.
(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.
Fai clic sull'icona del tastierino per modificare il numero.
Incolla o inserisci il numero di telefono nel campo corrispondente.
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
Cerca rapidamente "apex".
Seleziona Custom Code (Codice personalizzato) > Apex Classes (Classi Apex) > New (Nuovo).

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".
Una volta creata la classe APEX Rest, fai clic su Sicurezza per modificarla.

Seleziona tutti i profili degli agenti.
Fai clic sulla freccia per aggiungere il profilo alla colonna Enabled Profiles (Profili attivati).
Fai clic sul pulsante Salva.

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
Chiama l'IVR utilizzando un numero di telefono che dovrebbe attivare l'API DAP.
Verifica che la chiamata venga inoltrata alla coda corretta.