Prima di seguire la procedura di configurazione, è necessario passare alle note di rilascio e scaricare l'ultima versione del pacchetto Salesforce dell'app Webex.

Requisiti

Salesforce Enterprise Edition

Questa integrazione richiede un minimo di Salesforce Enterprise Edition. Per ulteriori informazioni, vedere Edizioni Salesforce.

Il mio dominio nell'organizzazione Salesforce

Se si desidera utilizzare i componenti Lightning, è necessario distribuire Il mio dominio nella propria organizzazione. Per ulteriori informazioni, vedere la documentazione di Salesforce dominio personale.

Accesso utente in Control Hub

È necessario configurare l'accesso utente alle integrazioni nella propria organizzazione.

• Senza Pro Pack: quando disponi del Control Hub di base, puoi scegliere di consentire o negare l'accesso a tutte le integrazioni per tutti i tuoi utenti.

• Con Pro Pack: con Pro Pack, hai funzionalità avanzate per gestire l'accesso alle integrazioni per gli utenti.

Per ulteriori informazioni, vedere Configurazione dell'accesso utente alle integrazioni.

Chiamata

• Webex Calling è completamente supportato per le chiamate in entrata e in uscita per il controllo delle chiamate all'interno di Salesforce.

• La chiamata in Webex (Unified CM) è parzialmente supportata. Solo le chiamate in uscita aprono una finestra popup di registrazione in Salesforce. Per le chiamate in entrata, l'app Webex squilla ma Salesforce non riesce a intercettare la chiamata, pertanto la finestra popup di registrazione non viene visualizzata.

Se stai lavorando con Webex per Salesforce versione 1.18 o precedente, prima di poter lavorare con Webex Calling all'interno di Salesforce, dovrai configurare un'autorizzazione Salesforce. Segui le sezioni di questo articolo per iniziare a utilizzare.

Queste procedure si applicano ai clienti che utilizzano la versione 1.18 e precedenti dell'integrazione Webex Salesforce. Vedere le istruzioni aggiornate per le versioni 1.19 e successive: Configurare un'autorizzazione Salesforce (1.19 e versioni successive) nella scheda Installa e amministra

1. Creazione di un'app connessa

Per creare una nuova app connessa:

1. In Impostazione, cerca App Manager e scegli Nuova app connessa.

   

2. Immettere un nome app connessa, ad esempio, MyExampleApp.
3. Inserire un indirizzo e-mail di contatto.
4. Selezionare Abilita impostazioni OAuth.
5. specificare un URL di richiamata segnaposto (aggiorneremo questo aggiornamento in seguito), ad esempio, https://localhost/segnaposto.

   

6. Scorrere verso il basso e scegliere i seguenti scopi OAuth:
   • Accesso completo (pieno)
   • Eseguire le richieste in qualsiasi momento (refresh_token, offline_access)

   

   L'ambito Esegui richieste in qualsiasi momento consente alle credenziali denominate di aggiornare il token di accesso alla scadenza di una sessione.

7. Scorrere fino alla fine della pagina e fare clic su Salva, quindi su Continua.
8. Nella pagina successiva, scorrere fino all'API (Abilita impostazioni OAuth) e fare clic su Gestisci dettagli utente.

   

   Potrebbe essere necessario eseguire nuovamente l'autenticazione con Salesforce.

9. Annotare la Consumer Key e il Consumer Secret.

   

2. Creazione di un provider autenticazione

Successivamente dovrai creare un provider di autenticazione, che facilita l'autenticazione con la tua organizzazione Salesforce.

Per creare un provider di autenticazione:

1. In Impostazione, cercare Autenticazione e selezionare Autenticazione. Fornitori. Fare clic su Nuovo.

   

2. Selezionare Salesforce come tipo di fornitore.
3. Immettere un nome per il provider di autenticazione, ad esempio ApexMDTAPI.
4. Incollare nella chiave consumer e nel segreto consumer salvati durante la configurazione dell'app connessa.
5. Immettere i seguenti ambiti in Ambiti predefiniti, refresh_token completo offline_access.
6. Lasciare vuoto tutto il resto e fare clic su Salva.

   

7. Copiare l'URL di richiamata dalla sezione Configurazione Salesforce.

   

8. Modificare l'app connessa e sostituire l'URL del segnaposto con l'URL di richiamata copiato dalla configurazione Salesforce precedente.

   

9. Salvare l'app connessa.

   Potrebbe essere necessario attendere fino a 10 minuti per consentire alle impostazioni di entrare in vigore e propagarsi in tutta l'infrastruttura di Salesforce.

3. Crea una credenziale denominata

Sarà quindi necessario creare una credenziale denominata.

Per creare una credenziale denominata:

1. In Setup (Impostazione), cercare Named (Denominato) e selezionare Named Credentials (Credenziali denominate). Fare clic su Nuova eredità.

   

2. Inserire il seguente valore per Label, ApexMDTAPI.
3. Per l'URL, immettere l'URL di istanza dell'organizzazione, ad esempio, https://na1.salesforce.com o, se si utilizza Dominio personale, il nome di dominio Dominio personale completo, ad esempio, https://mycompany.my.salesforce.com.
4. Per Tipo di identità, scegliere Nominativo principale.
5. Per Protocollo di autenticazione scegliere OAuth 2.0.
6. Per provider di autenticazione, scegliere il provider di autenticazione creato in precedenza.
7. Per Scope, inserisci, refresh_token completo offline_access.
8. Abilita Avvia flusso autenticazione in salvataggio.

   

9. In Opzioni callout, abilitare Consenti unisci campi in HTTP Body, quindi fare clic su Salva.

   

10. Ti verrà richiesto di accedere alla tua organizzazione. Una volta eseguito l'accesso, viene visualizzata una finestra di dialogo Consenti accesso. Fare clic su Consenti.
11. Verrai reindirizzato alla schermata Credenziali denominate e lo Stato autenticato indicherà Autenticato come tuo-email@dominio.com.

4. Creazione del sito nella schermata di amministrazione Webex

Infine, continua con l'argomento successivo nella scheda Chiamata, Crea sito per la chiamata, sotto.

Seguire le convenzioni di denominazione precedenti durante la configurazione del sito.

Per le integrazioni Webex per Salesforce versione 1.19 e successive, seguire le istruzioni in questo articolo per rimuovere qualsiasi app connessa Webex esistente per autorizzazioni, credenziali denominate e provider di autenticazione, quindi creare una nuova app connessa Webex per autorizzazione Salesforce.

Queste procedure si applicano ai clienti che utilizzano la versione 1.19 e successive dell'integrazione Webex Salesforce. Per istruzioni sulle versioni 1.18 e precedenti, vedere Configurazione di un'autorizzazione Salesforce (1.18 e successive) nella scheda Installazione e amministrazione

Rimuovi app connesse Webex esistenti, credenziali denominate e provider di autenticazione

Se in precedenza sono state create autorizzazioni per un'app connessa Webex, credenziali denominate o provider di autenticazione, sarà necessario rimuoverle prima di continuare. Altrimenti, continua a Creare una nuova app connessa Webex di seguito.

Rimuovi l'app Webex Connected esistente:

1. Nell'angolo superiore destro della pagina di destinazione Salesforce, selezionare l'icona dell'ingranaggio e scegliere Setup (Impostazione).
2. Nella casella di testo Ricerca rapida immettere App Manager e selezionarlo dall'elenco.
3. Scorrere fino all'app connessa Webex nell'elenco, fare clic sull'icona con la freccia in basso a destra della voce e scegliere Visualizza.
4. Selezionare Elimina, quindi selezionare di nuovo Elimina quando viene richiesto di confermare.

Rimuovi eventuali credenziali denominate Webex esistenti:

1. Nella casella di testo Ricerca rapida, immettere Credenziali nominative e selezionarle dall'elenco.
2. 2. Fare clic sulla freccia in basso a destra della voce delle credenziali Webex denominate e scegliere Elimina.
3. 3. Quando viene richiesto di confermare, scegliere di nuovo Elimina.

Rimozione di qualsiasi provider di autenticazione Webex esistente:

1. Nella casella di testo Ricerca rapida immettere Autenticazione. Provider e selezionarlo dall'elenco.
2. Selezionare il collegamento Del all'inizio della voce del provider di autenticazione Webex.
3. Selezionare OK quando viene richiesto di confermare.

Continuare alla sezione successiva per creare una nuova app connessa Webex per l'autorizzazione Salesforce.

Crea una nuova app connessa Webex per l'autorizzazione Salesforce

Per creare una nuova app connessa Webex per l'autorizzazione Salesforce:

1. Nell'angolo superiore destro della pagina di destinazione Salesforce, selezionare l'icona dell'ingranaggio e scegliere Setup (Impostazione).
2. Recupera l'URL del dominio: in Ricerca rapida, ricercare e selezionare Domini e salvare l'URL da Dominio personale.

1. Nella casella di testo Ricerca rapida immettere App Manager e selezionarlo dall'elenco.
2. Immettere un nome app connessa, ad esempio, autorizzazione Webex Salesforce.
3. Inserire un indirizzo e-mail per l'e-mail contatto.
4. Selezionare Abilita impostazioni OAuth.
5. Inserire due URL di richiamata utilizzando l'URL recuperato in precedenza, uno per linea e aggiungendo /apex/webexsfdcauth e /apex/cisco_webex__webexsfdcauth come suffissi. Ad esempio:

   https://my-company.my.salesforce.com/apex/webexsfdcauth

   https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcauth

6. Scegliere i seguenti scopi dall'elenco Scopi OAuth disponibili in Scopi OAuth selezionati:
   • Accesso completo (pieno)
   • Eseguire le richieste in qualsiasi momento (refresh_token, offline_access)
7. Deselezionare Richiedi chiave a prova per estensione PKCE (Require Proof Key for Code Exchange) per flussi di autorizzazione supportati.
8. Salvare l'app connessa e annotare la chiave utente e il segreto utente generati per un utilizzo successivo.

Quando è disponibile un nuovo pacchetto, seguire la procedura in Installa l'app Webex in Salesforce. Non è necessario disinstallare prima la versione precedente e non si perderanno le impostazioni configurate.

Per visualizzare le informazioni sui nuovi pacchetti di installazione e su dove scaricarli, vedere le note di rilascio sull'integrazione Webex Salesforce.

Per abilitare o disabilitare la cronologia chiamate:

1. Vai ad Amministrazione Webex.
2. Scorrere fino a Cronologia chiamate Webex.
3. Attivare o disattivare l'impostazione desiderata.

   Quando questa opzione è abilitata, la cronologia chiamate è disponibile per tutti gli utenti e i profili.

Per gli utenti CUCM e BroadWorks, la seguente funzionalità non è supportata:

• Ricezione di chiamate in entrata nel dialer globale Salesforce (l'app Webex continuerà a ricevere chiamate in entrata)
• Visualizzazione delle durate delle chiamate nella finestra del registro chiamate Salesforce dopo aver effettuato una chiamata in uscita correttamente
• Terminazione delle chiamate tramite il pulsante nella finestra del registro chiamate Salesforce dopo aver effettuato una chiamata in uscita correttamente
• Popolamento automatico delle durate delle chiamate nella finestra di registro chiamate Salesforce dopo il termine di una chiamata in uscita

Per tutte le integrazioni Salesforce, tenere presente il seguente limite:

• Salesforce applica un limite di conteggio degli eventi (25.000) che può causare il mancato funzionamento delle integrazioni con un utilizzo pesante. I pacchetti Salesforce sono disponibili per aumentare tale limite. Per ulteriori informazioni, consultare https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

Utilizzando il pannello di configurazione dei dati del webinar di importazione Webex Webinars, gli utenti Salesforce autorizzati possono importare invitati, iscritti e partecipanti al webinar Webex direttamente in oggetti Salesforce come lead e contatti.

L'interfaccia di configurazione Importa dati webinar è disponibile dalla pagina Amministrazione Webex:

Una volta abilitata l'importazione webinar, gli utenti autorizzati possono importare i dati del webinar Webex utilizzando il widget Webex Webinars:

Assegna autorizzazioni webinar Webex a utenti Salesforce

Prima che i tuoi utenti possano accedere alla funzionalità di importazione di webinar Webex, devi assegnare a ciascuno l'autorizzazione di amministrazione dell'importazione Webex.

Per assegnare le autorizzazioni a un utente:

1. Vai a Integra Salesforce con l'app Webex.
2. Scegliere la scheda Gestisci in fondo all'articolo, quindi espandere Fornisci accesso:

   

3. Seguire le istruzioni per aggiungere l'autorizzazione di amministrazione importazione Webex agli account utente Salesforce.

Configura la visualizzazione dell'intervallo di tempo del webinar Webex

Per configurare l'intervallo di tempo dei webinar Webex visualizzati:

1. Fai clic sul pulsante App Salesforce, inserisci Webex nel campo di ricerca e scegli Amministrazione Webex:

   

2. Trova il pannello Webex Webinars e inserisci il numero di giorni per i quali desideri visualizzare i webinar passati e futuri nel widget dei webinar Webex della home page:

   

Continua a configurare le mappature dei campi di importazione webinar Webex.

Configura mappature campo importazione webinar Webex

Utilizzando le impostazioni di importazione del webinar Webex, definisci le mappature tra gli oggetti Salesforce e i campi degli oggetti Webinar. Ad esempio, è possibile mappare i nomi e i cognomi di un oggetto Salesforce Contact ai nomi dei campi paralleli per invitati, iscritti e partecipanti ai webinar: nome e cognome.

Per configurare le impostazioni di importazione di webinar Webex:

1. Nella pagina di amministrazione Webex, scorrere fino al pannello Importa dati webinar:

   

2. Scegliere un oggetto Salesforce dall'elenco a discesa Object (Oggetto):

   

   Per l'oggetto, è possibile scegliere tra i seguenti oggetti Salesforce standard oltre a qualsiasi oggetto personalizzato configurato disponibile:

   • Contatti
   • Contatti

   Scegli Inserisci nuovi record per ogni webinar se desideri che tutti i partecipanti al webinar importati vengano creati come nuovi record di oggetto, a meno che non siano già stati importati per lo stesso webinar (in base alla chiave principale selezionata). I record esistenti non verranno aggiornati, anche se la chiave principale corrisponde, a meno che non vengano importati per lo stesso webinar Webex.

   Per questi oggetti standard, è possibile scegliere di collegarli alle campagne Salesforce come:

   • Membri campagna: I lead e i contatti importati sono disponibili nella sezione Membri campagna di Salesforce target, che è una funzione standard di Salesforce. (Disponibile nella versione 1.16 e successive)
   • Membri della campagna Webex Webinar: I lead e i contatti importati sono disponibili nella sezione dei membri della campagna Webex Webinar della campagna Salesforce di destinazione, che è una funzione Webex personalizzata.
   • Sia i membri della campagna che i membri della campagna Webex Webinar: I lead e i contatti importati sono disponibili in entrambe le posizioni all’interno di una campagna Salesforce. (Disponibile nella versione 1.16 e successive)

   Qualsiasi altro oggetto personalizzato scelto dall'elenco verrà importato nella sezione Membri campagna Webex Webinar della campagna Salesforce di destinazione.

3. Nell'interfaccia di selezione della chiave principale, scegliere un campo univoco come chiave principale e utilizzare la freccia destra per spostarlo nell'elenco Selezionato:

   

   Per la chiave principale, scegliere un campo disponibile che sarà univoco per ogni record. Ad esempio, è possibile avere molti contatti con il nome Mark, ma ogni contatto avrà un indirizzo e-mail univoco.

4. Nell'interfaccia di mappatura del campo Dati, scegliere un campo dall'oggetto Salesforce selezionato e mappare a un campo corrispondente per l'oggetto webinar. Utilizzare il pulsante + Nuovo campo per aggiungere altri campi come richiesto.

   Tutti i campi dell'oggetto Salesforce devono essere mappati ai campi webinar corrispondenti come mostrato sopra.

   È possibile associare ai campi Salesforce solo le domande standard dei moduli di registrazione al webinar Webex. Le domande del webinar Webex personalizzato non sono supportate.

5. È possibile rimuovere i campi aggiunti utilizzando l'icona del cestino accanto al campo a destra.
6. Fare clic su Salva al termine e una volta verificata la chiave principale, fare clic su Salva nella finestra di dialogo di conferma:

   

   Le mappature vengono visualizzate nel pannello aggiornato:

   

   È possibile eliminare le mappature degli oggetti utilizzando l'icona del cestino, che visualizzerà una finestra di dialogo di conferma aggiuntiva o modificare le mappature esistenti utilizzando l'icona a forma di matita.

   È sempre possibile tornare qui e modificare la chiave principale, ma questa non verrà aggiornata per i record già importati nel sistema. Di conseguenza, ciò potrebbe portare a duplicati, quindi modificare i tasti primari con cautela.

Una volta configurate le mappature dei campi webinar, scegli chi ha accesso alla funzionalità di importazione dati del webinar.

Abilita l'importazione dei dati del webinar per i tuoi utenti Salesforce

Con le mappature dei campi del webinar stabilite, puoi quindi scegliere chi ha accesso alla funzione di importazione dati del webinar. Le opzioni includono l'accesso globale per ogni account utente con le autorizzazioni corrette, singoli account utente e utenti membri di particolari profili Salesforce.

Abilita importazione dati webinar per tutti gli utenti

Per abilitare l'importazione dei dati del webinar per tutti i membri dell'organizzazione Salesforce, attiva Abilita importazione webinar per tutti i profili/utenti su Abilitato:

Abilita importazione dati webinar per utenti o profili selezionati

Puoi abilitare l'importazione dei dati del webinar per i singoli utenti selezionati o per set specifici di utenti corrispondenti a un particolare profilo utente Salesforce.

Per abilitare l'importazione dei dati del webinar per gli utenti o i profili selezionati:

1. Assicurati che Abilita importazione webinar per tutti i profili/utenti sia disabilitato:

   

2. Dal menu a discesa Abilita importazione webinar solo per questi profili/utenti, seleziona Profilo o Utente:

   

   • Per aggiungere un profilo, selezionare Profilo, fare clic nella casella di testo di ricerca e scegliere un ruolo Salesforce dall'elenco a discesa. Fare clic su Add (Aggiungi) per aggiungere il ruolo:

     

   • Per aggiungere un singolo utente, selezionare Utente e immettere un nome utente nella casella di testo. Fare clic su Aggiungi per aggiungere l'utente:

     

   Per eliminare un utente o un profilo, fare clic sull'icona del cestino accanto alla voce.