Grazie per il feedback.

Prima di continuare, si assicuri di soddisfare i seguenti prerequisiti:

• L'utente che esegue la configurazione deve essere un amministratore dell'organizzazione Salesforce in cui deve essere installata l'integrazione.
• Questa integrazione richiede almeno Salesforce Enterprise Edition. Vedere Salesforce Editions per ulteriori informazioni.
• L'organizzazione deve avere Webex configurato con le licenze corrette per le funzionalità richieste, tra cui messaggistica, riunioni e chiamate.
• Tutti gli utenti che utilizzano l'integrazione devono avere l'accesso a Salesforce e le licenze Salesforce richieste.
• Tutti gli utenti devono disporre delle licenze Webex necessarie per utilizzare funzionalità Webex specifiche, come e all'interno di Salesforce. Webex Meetings Webex Calling

  CUCM e Broadworks sono supportati con funzionalità parziali. Vedi Limitazioni alle chiamate nella sezione Chiamate per maggiori dettagli.

• Questa integrazione è disponibile per Salesforce Lightning.

  Deve implementare My Domain nella sua organizzazione se desidera utilizzare i componenti Lightning. Vedere My Domain Salesforce per ulteriori informazioni.

• Deve configurare l'accesso degli utenti alle integrazioni nella sua organizzazione.
  • Senza Pro Pack: quando dispone di Control Hub di base, può consentire o negare l'accesso a tutte le integrazioni per tutti i suoi utenti.
  • Con Pro Pack —Con Pro Pack, dispone di funzionalità avanzate per gestire l'accesso degli utenti alle integrazioni.

  Per ulteriori informazioni, vedere Configurare l'accesso degli utenti alle integrazioni.

Per le versioni dell'integrazione Webex Salesforce successive alla 1.14, ora può eseguire l'aggiornamento utilizzando Salesforce Exchange.

Per installare l'integrazione Webex utilizzando Salesforce Exchange:

1. Accedere all'app Webex per Salesforce in AppExchange.
2. Seleziona Ricevilo ora.
3. Seleziona la Connected Org in cui desidera installare l'integrazione.
4. Installi l'app solo per amministratori.
5. Continui con Autorizza l'integrazione Webex nella scheda Installa e amministra.

Prima di seguire i passaggi di configurazione, deve prima accedere alle note di rilascio e scaricare l'ultima versione del pacchetto Salesforce dell'app Webex.

Requisiti

Salesforce Enterprise Edition

Questa integrazione richiede almeno Salesforce Enterprise Edition. Vedere Salesforce Editions per ulteriori informazioni.

Il mio dominio in Salesforce org

Deve implementare My Domain nella sua organizzazione se desidera utilizzare i componenti Lightning. Consulta la documentazione di My Domain Salesforce per ulteriori informazioni.

Accesso utente a Control Hub

Deve configurare l'accesso degli utenti alle integrazioni nella sua organizzazione.

• Senza Pro Pack: quando dispone di Control Hub di base, può consentire o negare l'accesso a tutte le integrazioni per tutti i suoi utenti.

• Con Pro Pack —Con Pro Pack, dispone di funzionalità avanzate per gestire l'accesso degli utenti alle integrazioni.

Per ulteriori informazioni, vedere Configurare l'accesso degli utenti alle integrazioni.

Chiamata

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

• Le chiamate in Webex (Unified CM) sono parzialmente supportate. Solo le chiamate in uscita aprono un pop-up di registrazione in Salesforce. Per le chiamate in entrata, l'app Webex squilla ma Salesforce non può intercettare la chiamata, quindi il pop-up di registrazione non viene mostrato.

Se sta lavorando con Webex per Salesforce versione 1.18 o precedente, deve configurare un'autorizzazione Salesforce prima di poter lavorare con Salesforce. Webex Calling

Crei un'app connessa

1. In Configurazione, cerchi l'app client esterno.

   

2. In App client esterni, scelga Impostazioni.
3. Attiva Consenti la creazione di app connesse. Se il pulsante Nuova app connessa è già abilitato, può procedere e creare una nuova app connessa.

   

4. Per creare una nuova app connessa, faccia clic su Nuova app connessa e inserisca i dettagli richiesti.

   

5. Inserisca un nome per l'app connessa, ad esempio MyExampleApp.
6. Inserisca un indirizzo email di contatto.
7. Seleziona la casella Abilita le impostazioni OAuth.
8. Specifichi un URL di callback segnaposto (lo aggiorneremo più avanti), ad esempio. https://localhost/placeholder

   

9. Scorra verso il basso e scelga i seguenti ambiti OAuth:
   • Accesso completo (completo)
   • Eseguire le richieste in qualsiasi momento (refresh_token,offline_access)

   

   L'ambito Perform requests at any time consente a Named Credentials di aggiornare il suo token di accesso alla scadenza di una sessione.

10. Scorra fino alla fine della pagina e faccia clic su Salva, quindi su Continua.
11. Nella pagina successiva, scorra fino all'API (Abilita le impostazioni OAuth) e faccia clic su Gestisci i dati del consumatore.

    

    Potrebbe essere necessario autenticarsi nuovamente con Salesforce.

12. Prendere nota della Consumer Key e del Consumer Secret.

    

Crei un fornitore di autenticazione

Quindi, crei un fornitore di autenticazione, che faciliti l'autenticazione con la sua organizzazione Salesforce.

1. In Configurazione, cerchi Auth e selezioni Auth. Fornitori. Faccia clic su Nuovo.

   

2. Seleziona Salesforce come tipo di fornitore.
3. Inserisca un nome per il provider di autenticazione, ad esempio ApexMDTAPI.
4. Incolla la Consumer Key e il Consumer Secret che ha salvato durante la configurazione della sua Connected App.
5. Inserire per intero refresh_token offline_access in Ambiti predefiniti.
6. Lasci tutto il resto vuoto e faccia clic su Salva.

   

7. Copia l'URL di callback dalla sezione Configurazione di Salesforce.

   

8. Modifichi la sua Connected App e sostituisca l'URL segnaposto con l'URL di callback che ha copiato dalla configurazione di Salesforce precedente.

   

9. Salvi la sua app connessa.

   Possono essere necessari fino a 10 minuti prima che le impostazioni abbiano effetto e si propaghino in tutta l'infrastruttura di Salesforce.

Crei una credenziale denominata

1. In Configurazione, cerchi Named e selezioni Named Credentials. Fai clic su New Legacy.

   

2. Inserisca ApexMDTAPI nell'etichetta.
3. Inserisca l'URL dell'istanza della sua organizzazione nell'URL, ad esempio https://na1.salesforce.com; oppure, se sta usando My Domain, il suo nome My Domain completo, ad esempio https://mycompany.my.salesforce.com.
4. Per Tipo di identità, selezioni Nominato Preside.
5. Per il protocollo di autenticazione, selezioni OAuth 2.0.
6. Per il fornitore di autenticazione, selezioni il provider di autenticazione che ha creato in precedenza.
7. Inserire per intero refresh_token offline_access l'ambito.
8. Spunta la casella accanto a Avvia il flusso di autenticazione al momento del salvataggio.

   

9. In Opzioni callout, seleziona la casella accanto a Consenti l'unione di campi nel corpo HTTP, quindi fai clic su Salva.

   

10. Acceda alla sua organizzazione. Dopo aver effettuato l'accesso, faccia clic su Consenti l'accesso.
11. Nella schermata Named Credential, Authenticated Status indica Authenticated come your-email@domain.com.

Crei il suo sito nella schermata di amministrazione di Webex

Continui a creare un sito per le chiamate nella sezione Chiamate.

Per le integrazioni Webex for Salesforce versione 1.19 e successive, segua le istruzioni in questo articolo per rimuovere qualsiasi app Webex Connected esistente per le autorizzazioni, le credenziali denominate e i provider di autenticazione, quindi creare una nuova app Webex Connected per l'autorizzazione Salesforce.

Rimuovere tutte le app Webex Connected esistenti, le credenziali denominate e i provider di autenticazione

Se in precedenza ha creato autorizzazioni per Webex Connected App, denominate credenziali o provider di autenticazione, dovrà rimuoverle prima di continuare. Altrimenti, continui a creare una nuova app Webex Connected di seguito.

Rimuovi la sua app Webex Connected esistente:

1. Nell'angolo in alto a destra della sua landing page di Salesforce, faccia clic , quindi seleziona Configurazione.
2. Nella casella di testo Ricerca rapida, inserisca App Manager, quindi lo selezioni dall'elenco.
3. Scorra fino alla sua app Webex Connected nell'elenco, faccia clic sull'icona della freccia verso il basso a destra della voce, quindi seleziona Visualizza.
4. Seleziona Elimina, quindi seleziona nuovamente Elimina quando gli viene chiesto di confermare.

Rimuovere eventuali credenziali denominate Webex esistenti:

1. Nella casella di testo Ricerca rapida, inserire Credenziali denominate, quindi selezionarle dall'elenco.
2. Fare clic sulla freccia verso il basso a destra della voce delle credenziali denominate Webex, quindi fare clic su Elimina.
3. Fai nuovamente clic su Elimina quando ti viene chiesto di confermare.

Rimuovere eventuali provider di autenticazione Webex esistenti:

1. Nella casella di testo Ricerca rapida, inserisca Auth. Fornitori, quindi selezionarlo dall'elenco.
2. Seleziona il link Del all'inizio della voce del provider di autenticazione Webex.
3. Faccia clic su OK quando gli viene chiesto di confermare.

Passare alla sezione successiva per creare una nuova app Webex Connected per l'autorizzazione di Salesforce .

Creare una nuova app Webex Connected per l'autorizzazione Salesforce

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

1. Nell'angolo in alto a destra della sua landing page di Salesforce, faccia clic , quindi seleziona Configurazione.
2. Recupera l'URL del suo dominio: in Ricerca rapida, cerca e seleziona Domini e salvi l'URL da Il mio dominio.
3. In Configurazione, cerchi l'app client esterno.

   

4. In App client esterne, seleziona Impostazioni.
5. Attiva Consenti la creazione di app connesse. Se il pulsante Nuova app connessa è già abilitato, può procedere e creare una nuova app connessa.

   

6. Per creare una nuova app connessa, faccia clic su Nuova app connessa e inserisca i dettagli richiesti.

   

7. Nella casella di testo Ricerca rapida, inserisca App Manager e lo selezioni dall'elenco.
8. Inserire il nome di un'app connessa, ad esempio Webex Salesforce Authorization.
9. Inserisca un indirizzo email per l'email di contatto.
10. Seleziona la casella Abilita le impostazioni OAuth.
11. Inserisca due URL di callback utilizzando l'URL recuperato in precedenza, uno per riga, e aggiungendo /apex/ webexsfdcauthe /apex/ cisco_webex__webexsfdcauthcome suffissi. Ad esempio:

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

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

12. Scegli i seguenti ambiti dall'elenco Ambiti OAuth disponibili in Ambiti OAuth selezionati:
    • Accesso completo (completo)
    • Eseguire le richieste in qualsiasi momento (refresh_token,offline_access)
13. Deseleziona la casella Richiedi l'estensione Request Proof Key for Code Exchange (PKCE) per i flussi di autorizzazione supportati.
14. Faccia clic su Salva.
15. Copia e salvi in modo sicuro la Consumer Key e il Consumer Secret. Le servono questi valori quando configura l'autorizzazione Salesforce in Control Hub.

Per Webex for Salesforce Integration versione 1.22 e successive, configura l'autorizzazione Salesforce con un'app client esterna. Se dispone già di un'autorizzazione Connected App for Webex Salesforce, può migrarla a un'app client esterna e conservarne la chiave di consumo.

Prima che Lei cominci

• È necessario l'accesso come amministratore di sistema di Salesforce.
• Il mio dominio deve essere abilitato nella sua organizzazione Salesforce.

Recupera il suo URL My Domain

1. Nell'angolo in alto a destra della sua landing page di Salesforce, faccia clic , quindi faccia clic su Configurazione.
2. Nella casella Ricerca rapida, cerchi Domini e lo selezioni.
3. Annoti il suo URL My Domain. Lo utilizzerà per configurare gli URL di callback. Ad esempio, il suo URL potrebbe essere https://my-company.my.salesforce.com.

Crei una nuova app per client esterni

1. In Configurazione, cerchi App Manager nella casella Ricerca rapida e lo selezioni.
2. Fai clic su Nuova app per client esterni.

   Inserisca i seguenti dati:

   • Nome app client esterno — Autorizzazione Webex Salesforce
   • Nome API — Webex_Salesforce_Authorization(compilato automaticamente)
   • Email di contatto — Il suo indirizzo email di amministratore
   • Stato di distribuzione: locale

3. Faccia clic su Crea.

Configurare le impostazioni OAuth

1. In API (Abilita impostazioni OAuth), faccia clic su Abilita OAuth.
2. Configura gli URL di callback. Sostituisca [your-domain]con il suo valore Salesforce My Domain e inserisca ogni URL in una riga separata:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Aggiungi questi ambiti OAuth agli ambiti OAuth selezionati:
   • Accesso completo (full)
   • Eseguire le richieste in qualsiasi momento (refresh_token, offline_access)
4. In Sicurezza, mantenga selezionata la casella Require Proof Key for Code Exchange (PKCE).
5. Faccia clic su Crea.

Recupera la Consumer Key e il Consumer Secret

1. In Configurazione, seleziona App Manager > External Client App Manager.
2. Fai clic su Autorizzazione Webex Salesforce.
3. Faccia clic sulla scheda Impostazioni, quindi apra le impostazioni OAuth.
4. Fai clic su Consumer Key and Secret.
5. Controlli la sua email per il codice di verifica di Salesforce.
6. Nella pagina Verifica la sua identità, inserisca il codice e faccia clic su Verifica.
7. Copia e salvi in modo sicuro la Consumer Key e il Consumer Secret. Le servono questi valori quando configura l'autorizzazione Salesforce in Control Hub.

Eseguire la migrazione di un'app connessa esistente

Se dispone già di un'autorizzazione Connected App per Webex Salesforce, esegua la migrazione a un'app client esterna. Ciò preserva la Consumer Key, mantiene validi i token esistenti e trasferisce le impostazioni OAuth. La Connected App originale rimane dopo la migrazione.

1. In Configurazione, cerchi App Manager e lo scelga.
2. Trova l'app connessa esistente, faccia clic sulla freccia verso il basso a destra della riga e scelga Visualizza.
3. Nella pagina dei dettagli dell'app connessa, faccia clic su Migrate to External Client App.
4. Riveda il riepilogo della migrazione, quindi faccia clic su Migrate.
5. Al termine della migrazione, Salesforce apre la nuova pagina dei dettagli dell'app client esterno.

Verifichi la migrazione

1. In Configurazione, scelga App Manager > External Client App Manager.
2. Confermi che l'autorizzazione Webex Salesforce sia visualizzata nell'elenco.
3. Faccia clic sull'app e verifichi che la scheda Impostazioni mostri gli URL di callback e gli ambiti OAuth corretti:
   • Accesso completo (full)
   • Eseguire le richieste in qualsiasi momento (refresh_token, offline_access)
4. (Facoltativo) Recupera la Consumer Key e il Consumer Secret e conferma che corrispondano ai valori originali.

Disattivi la Connected App originale (opzionale)

Dopo aver verificato che l'app External Client funzioni, proceda come segue:

1. In Configurazione, selezioni App Manager.
2. Trova la Connected App originale e faccia clic sulla freccia verso il basso a destra della riga corrispondente.
3. Scelga Gestisci.
4. In Politiche OAuth, imposti Utenti autorizzati per bloccare nuove autorizzazioni o lasciare attiva la Connected App durante un periodo di transizione.

Consigliamo di mantenere attiva la Connected App originale per un breve periodo di transizione, in modo che le integrazioni continuino a funzionare prima di disattivarla.

Quando è disponibile un nuovo pacchetto, segua la procedura descritta sopra in Installazione dell'app Webex in Salesforce. Non è necessario disinstallare prima la vecchia versione e non perderà le impostazioni configurate.

Per visualizzare le informazioni sui nuovi pacchetti di installazione e dove scaricarli, vedere le note sulla versione dell'integrazione di Webex Salesforce.

Per abilitare o disabilitare la cronologia delle chiamate:

1. Vai a Webex Admin.
2. Scorri verso il basso fino a Cronologia chiamate Webex.
3. Poni l'interruttore sull'impostazione desiderata, abilitata o disattivata.

   Se abilitata, la cronologia chiamate è disponibile per tutti gli utenti e i profili.

Per gli utenti del 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 della durata delle chiamate nella finestra del registro chiamate di Salesforce dopo aver effettuato con successo una chiamata in uscita
• Terminare le chiamate tramite il pulsante nella finestra del registro chiamate di Salesforce dopo aver effettuato con successo una chiamata in uscita
• Inserimento automatico della durata delle chiamate nella finestra del registro chiamate di Salesforce dopo aver terminato una chiamata in uscita

Per tutte le integrazioni Salesforce, nota la seguente limitazione:

• Salesforce impone una limitazione al numero di eventi (25.000) che può causare il fallimento delle integrazioni in caso di uso intenso. I pacchetti Salesforce sono disponibili per aumentare tale limite. Per ulteriori informazioni, vedere https://developer.salesforce.com/docs/atlas.en-us. platform_events.meta/ platform_events /.htm. platform_event_limits

• I componenti dell'utilità di chiamata Webex non sono disponibili nell'app mobile Salesforce.