Hartelijk dank voor uw feedback

Voordat u verder gaat, moet u ervoor zorgen dat u aan de volgende voorwaarden voldoet:

• De gebruiker die de installatie uitvoert, moet een beheerder zijn voor de Salesforce-organisatie waar de integratie moet worden geïnstalleerd.
• Voor deze integratie is minimaal Salesforce Enterprise Edition vereist. Zie Salesforce Editions voor meer informatie.
• De organisatie moet Webex hebben geconfigureerd met de juiste licenties voor de vereiste functionaliteit, zoals berichten, vergaderingen en bellen.
• Alle gebruikers die de integratie gebruiken, moeten beschikken over Salesforce-toegang en de vereiste Salesforce-licenties.
• Alle gebruikers moeten over de vereiste Webex-licenties beschikken om specifieke Webex-functionaliteit te kunnen gebruiken, zoals Webex Meetings en Webex Calling vanuit Salesforce.

  CUCM en Broadworks worden ondersteund met gedeeltelijke functionaliteit. Zie Oproepbeperkingen in de sectie Bellen voor meer informatie.

• Deze integratie is beschikbaar voor Salesforce Lightning.

  U moet My Domain in uw organisatie implementeren als u Lightning-componenten wilt gebruiken. Zie My Domain Salesforce voor meer informatie.

• U moet gebruikerstoegang tot integraties in uw organisatie configureren.
  • Zonder Pro Pack — Als u een eenvoudige Control Hub hebt, kunt u al uw gebruikers de toegang tot alle integraties toestaan of weigeren.
  • Met Pro Pack — Met Pro Pack beschikt u over geavanceerde functionaliteit om de toegang van gebruikers tot integraties te beheren.

  Zie Gebruikerstoegang tot integraties configureren voor meer informatie.

Voor versies van de Webex Salesforce-integratie die hoger is dan 1.14, kunt u nu upgraden met Salesforce Exchange.

Om de Webex-integratie te installeren met Salesforce Exchange:

1. Navigeer naar de Webex-app voor Salesforce in de AppExchange.
2. Selecteer Nu downloaden.
3. Selecteer de Connected Org waarin u de integratie wilt installeren.
4. Installeer de app alleen voor beheerders.
5. Ga verder met Autoriseer de Webex-integratie op het tabblad Installeren en beheren.

Voordat u de configuratiestappen volgt, moet u eerst naar de releasenotes gaan en de laatste versie van het Webex App Salesforce-pakket downloaden.

Vereisten

Salesforce Enterprise-editie

Voor deze integratie is minimaal Salesforce Enterprise Edition vereist. Zie Salesforce Editions voor meer informatie.

Mijn domein in Salesforce org

U moet My Domain in uw organisatie implementeren als u Lightning-componenten wilt gebruiken. Zie de My Domain Salesforce-documentatie voor meer informatie.

Gebruikerstoegang in Control Hub

U moet gebruikerstoegang tot integraties in uw organisatie configureren.

• Zonder Pro Pack — Als u een eenvoudige Control Hub hebt, kunt u al uw gebruikers de toegang tot alle integraties toestaan of weigeren.

• Met Pro Pack — Met Pro Pack beschikt u over geavanceerde functionaliteit om de toegang van gebruikers tot integraties te beheren.

Zie Gebruikerstoegang tot integraties configureren voor meer informatie.

Bellen

• Webex Callingwordt volledig ondersteund voor inkomende en uitgaande gesprekken voor gespreksbeheer binnen Salesforce.

• Inbellen in Webex (Unified CM) wordt gedeeltelijk ondersteund. Alleen bij uitgaande gesprekken wordt een pop-up geopend om in te loggen in Salesforce. Voor inkomende gesprekken gaat de Webex-app over, maar Salesforce kan de oproep niet onderscheppen, zodat de pop-up voor logboekregistratie niet wordt weergegeven.

Als u met Webex voor Salesforce versie 1.18 of eerder werkt, moet u een Salesforce-autorisatie configureren voordat u binnen Salesforce kunt werken. Webex Calling

Maak een verbonden app

1. Zoek in Setup naar de External Client-app.

   

2. Kies Instellingen onder Externe client-apps.
3. Schakel het aanmaken van verbonden apps toestaan in. Als de knop Nieuwe verbonden app al is ingeschakeld, kunt u doorgaan en een nieuwe verbonden app maken.

   

4. Om een nieuwe verbonden app te maken, klikt u op Nieuwe verbonden app en voert u de vereiste gegevens in.

   

5. Voer een naam voor een verbonden app in, zoals MyExampleApp.
6. Voer een e-mailadres voor contactpersonen in.
7. Vink het vakje aan voor OAuth-instellingen inschakelen.
8. Geef een tijdelijke callback-URL op (we updaten dit later), zoals. https://localhost/placeholder

   

9. Scroll naar beneden en kies de volgende OAuth-scopes:
   • Volledige toegang (volledig)
   • Verzoeken op elk gewenst moment uitvoeren (refresh_token,offline_access)

   

   Met het Perform request at any time scope kan Named Credentials uw toegangstoken verversen wanneer een sessie afloopt.

10. Blader naar de onderkant van de pagina en klik op Opslaan en vervolgens op Doorgaan.
11. Blader op de volgende pagina naar API (OAuth-instellingen inschakelen) en klik op Consumentengegevens beheren.

    

    Mogelijk moet u zich opnieuw authenticeren bij Salesforce.

12. Noteer de consumentensleutel en het consumentengeheim.

    

Maak een Auth-provider aan

Creëer vervolgens een authenticatieprovider, die de authenticatie bij uw Salesforce-organisatie vergemakkelijkt.

1. Zoek in Setup naar Auth en selecteer Auth. Aanbieders. Klik op Nieuw.

   

2. Selecteer Salesforce als type provider.
3. Voer een naam in voor de Auth-provider, zoals ApexMDTAPI.
4. Plak de Consumer Key en het Consumer Secret in die u hebt opgeslagen toen u uw Connected App configureerde.
5. Voer de volledige waarde refresh_token offline_access in bij Default Scopes.
6. Laat al het andere leeg en klik op Opslaan.

   

7. Kopieer de callback-URL uit de sectie Salesforce-configuratie.

   

8. Bewerk uw Connected App en vervang de tijdelijke URL door de callback-URL die u uit de Salesforce-configuratie hierboven hebt gekopieerd.

   

9. Sla uw Connected App op.

   Het kan tot 10 minuten duren voordat de instellingen zijn doorgevoerd en zich in de hele infrastructuur van Salesforce hebben verspreid.

Creëer een identificatienummer met een naam

1. Zoek in Setup naar Named en selecteer Named Credentials. Klik op New Legacy.

   

2. Voer ApexMDTAPI in bij Label.
3. Voer de instantie-URL van uw organisatie in URL in, zoals https://na1.salesforce.com; of, als u Mijn domein gebruikt, uw volledig gekwalificeerde Mijn domeinnaam, zoals https://mycompany.my.salesforce.com.
4. Voor Identity Type selecteert u Named Principal.
5. Voor Authentication Protocol selecteert u OAuth 2.0.
6. Selecteer bij Authentication Provider de authenticatieprovider die u eerder hebt aangemaakt.
7. Vul volledig refresh_token offline_access in bij Scope.
8. Vink het vakje aan naast Authenticatiestroom starten bij opslaan.

   

9. Vink in Callout-opties het vakje aan naast Samenvoegvelden toestaan in de HTTP-hoofdtekst en klik vervolgens op Opslaan.

   

10. Meld u aan bij uw organisatie. Nadat u zich hebt aangemeld, klikt u op Toestaan in Toegang toestaan.
11. Op het scherm Named Credential geeft Authenticated Status aan dat geverifieerd is als your-email@domain.com.

Maak uw website in het beheerscherm van Webex

Ga verder met het aanmaken van een website om te bellen in de sectie Bellen.

Voor Webex for Salesforce-integraties versie 1.19 en hoger volgt u de instructies in dit artikel om bestaande Webex Connected-apps voor autorisaties, benoemde inloggegevens en verificatieproviders te verwijderen en vervolgens een nieuwe Webex Connected-app voor Salesforce-autorisatie te maken.

Verwijder alle bestaande Webex Connected-apps, benoemde inloggegevens en verificatieproviders

Als u eerder autorisaties voor de Webex Connected App hebt aangemaakt, met de naam credential of auth-provider, moet u deze verwijderen voordat u doorgaat. Anders gaat u hieronder verder met Een nieuwe Webex Connected-app maken.

Verwijder uw bestaande Webex Connected-app:

1. Klik in de rechterbovenhoek van uw Salesforce-landingspagina op en selecteer vervolgens Instellingen.
2. Voer App Manager in het tekstvak Snel zoeken in en selecteer het in de lijst.
3. Blader naar uw Webex Connected-app in de lijst, klik op het pictogram met de pijl omlaag aan de rechterkant van het item en selecteer vervolgens Bekijken.
4. Selecteer Verwijderen en selecteer vervolgens opnieuw Verwijderen wanneer u om bevestiging wordt gevraagd.

Verwijder alle bestaande Webex Named Credentials:

1. Voer Named Credentials in het tekstvak Quick Find in en selecteer het in de lijst.
2. Klik op de pijl-omlaag aan de rechterkant van het item met de naam Webex en klik vervolgens op Verwijderen.
3. Klik opnieuw op Verwijderen wanneer u om bevestiging wordt gevraagd.

Verwijder eventuele bestaande Webex Auth Providers:

1. Voer Auth in het tekstvak Snel zoeken in. Providers, selecteer het dan in de lijst.
2. Selecteer de Del-link aan het begin van de invoer van de Webex-verificatieprovider .
3. Klik op OK wanneer u om bevestiging wordt gevraagd.

Ga verder met de volgende sectie om een nieuwe Webex Connected-app te maken voor Salesforce-autorisatie .

Maak een nieuwe Webex Connected-app voor Salesforce-autorisatie

Om een nieuwe Webex Connected-app voor Salesforce-autorisatie te maken:

1. Klik in de rechterbovenhoek van uw Salesforce-landingspagina op en selecteer vervolgens Instellingen.
2. De URL van uw domein ophalen: zoek en selecteer in Snel zoeken naar domeinen en sla de URL op in Mijn domein.
3. Zoek in Setup naar de External Client-app.

   

4. Selecteer Instellingen onder Externe client-apps.
5. Schakel het aanmaken van verbonden apps toestaan in. Als de knop Nieuwe verbonden app al is ingeschakeld, kunt u doorgaan en een nieuwe verbonden app maken.

   

6. Om een nieuwe verbonden app te maken, klikt u op Nieuwe verbonden app en voert u de vereiste gegevens in.

   

7. Voer App Manager in het tekstvak Snel zoeken in en selecteer het in de lijst.
8. Voer een naam voor een verbonden app in, bijvoorbeeld Webex Salesforce Authorization .
9. Voer een e-mailadres in voor het e-mailadres voor contact.
10. Vink het vakje aan voor OAuth-instellingen inschakelen.
11. Voer twee terugbel-URL's in met de URL die u eerder hebt opgehaald, één per regel, en met toevoeging /apex/ webexsfdcauthen /apex/ cisco_webex__webexsfdcauthals achtervoegsels. Bijvoorbeeld:

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

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

12. Kies de volgende scopes uit de lijst Beschikbare OAuth-scopes in Geselecteerde OAuth-scopes:
    • Volledige toegang (volledig)
    • Verzoeken op elk gewenst moment uitvoeren (refresh_token,offline_access)
13. Verwijder het vinkje bij de Extension Proof Key for Code Exchange (PKCE) vereist voor ondersteunde autorisatiestromen.
14. Klik op Opslaan.
15. Kopieer de Consumer Key en Consumer Secret en bewaar ze veilig. U hebt deze waarden nodig wanneer u de Salesforce-autorisatie configureert in Control Hub.

Voor Webex for Salesforce-integratie versie 1.22 en hoger moet u de Salesforce-autorisatie configureren met een externe client-app. Als u al een Connected App voor Webex Salesforce-autorisatie hebt, kunt u deze migreren naar een externe client-app en de Consumer Key behouden.

Voordat u begint

• U hebt toegang tot Salesforce System Administrator nodig.
• Mijn domein moet ingeschakeld zijn in uw Salesforce-organisatie.

De URL van uw Mijn domein ophalen

1. Klik in de rechterbovenhoek van uw Salesforce-landingspagina op en klik vervolgens op Instellingen.
2. Zoek in het vak Snel zoeken naar domeinen en selecteer dat.
3. Noteer de URL van uw Mijn domein. U zult het gebruiken om de terugbel-URL's te configureren. Uw URL kan bijvoorbeeld zijn https://my-company.my.salesforce.com.

Maak een nieuwe externe client-app

1. Zoek in Setup naar App Manager in het vak Snel zoeken en selecteer dat.
2. Klik op Nieuwe externe client-app.

   Voer de volgende gegevens in:

   • Naam van de externe client-app — Webex Salesforce-autorisatie
   • API-naam — Webex_Salesforce_Authorization(automatisch ingevuld)
   • E-mailadres voor contact — Het e-mailadres van uw beheerder
   • Distributiestatus — Lokaal

3. Klik op Aanmaken.

OAuth-instellingen configureren

1. Klik onder API (OAuth-instellingen inschakelen) op OAuth inschakelen.
2. Configureer de terugbel-URL's. [your-domain]Vervang dit door uw Salesforce My Domain-waarde en voer elke URL op een aparte regel in:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Voeg deze OAuth-scopes toe aan geselecteerde OAuth-scopes:
   • Volledige toegang (full)
   • Verzoeken op elk gewenst moment uitvoeren (refresh_token, offline_access)
4. Houd onder Beveiliging de optie Required Proof Key for Code Exchange (PKCE) aangevinkt.
5. Klik op Aanmaken.

De consumentensleutel en het consumentengeheim ophalen

1. Selecteer in Setup App Manager > App Manager voor externe clients.
2. Klik op Webex Salesforce-autorisatie.
3. Klik op het tabblad Instellingen en open vervolgens OAuth-instellingen.
4. Klik op Consumer Key en Secret.
5. Controleer uw e-mail voor de verificatiecode van Salesforce.
6. Voer op de pagina Uw identiteit verifiëren de code in en klik op Verifiëren.
7. Kopieer de Consumer Key en Consumer Secret en bewaar ze veilig. U hebt deze waarden nodig wanneer u de Salesforce-autorisatie configureert in Control Hub.

Migreer een bestaande Connected App

Als u al een Connected App voor Webex Salesforce-autorisatie hebt, migreer die dan naar een externe client-app. Hierdoor blijft de consumentensleutel behouden, blijven bestaande tokens geldig en worden de OAuth-instellingen overgedragen. De originele Connected App blijft bestaan na de migratie.

1. Zoek in Setup naar App Manager en kies die.
2. Zoek de bestaande Connected App, klik op de pijl-omlaag aan de rechterkant van de rij en kies Bekijken.
3. Klik op de gegevenspagina van de Connected App op Migreren naar externe client-app.
4. Bekijk het migratieoverzicht en klik vervolgens op Migreren.
5. Wanneer de migratie is voltooid, opent Salesforce de nieuwe pagina met gegevens van de External Client-app.

Verifieer de migratie

1. Kies App Manager > Externe Client App Manager in Setup.
2. Bevestig dat Webex Salesforce-autorisatie in de lijst voorkomt.
3. Klik op de app en controleer of op het tabblad Instellingen de juiste terugbel-URL's en OAuth-scopes staan:
   • Volledige toegang (full)
   • Verzoeken op elk gewenst moment uitvoeren (refresh_token, offline_access)
4. (Optioneel) Haal de Consumer Key en Consumer Secret op en bevestig dat ze overeenkomen met de oorspronkelijke waarden.

Deactiveer de originele Connected App (optioneel)

Nadat u hebt geverifieerd dat de External Client-app werkt, doet u het volgende:

1. Selecteer App Manager in Setup.
2. Zoek de originele Connected App en klik op de pijl-omlaag rechts van de rij.
3. Kies Beheren.
4. Stel onder het OAuth-beleid Toegestane gebruikers in om nieuwe autorisaties te blokkeren of om de Connected App actief te laten tijdens een overgangsperiode.

We raden aan om de originele Connected App gedurende een korte overgangsperiode actief te houden, zodat de integraties blijven werken voordat u deze deactiveert.

Als er een nieuw pakket beschikbaar is, volg dan de stappen in De Webex-app installeren in Salesforce hierboven. U hoeft niet eerst de oude versie te verwijderen en u zult uw geconfigureerde instellingen niet verliezen.

Zie de releaseopmerkingen over de integratie van Webex Salesforce voor informatie over de nieuwe installatiepakketten en waar u ze kunt downloaden.

Om de oproepgeschiedenis in of uit te schakelen:

1. Ga naar Webex Admin.
2. Blader omlaag naar Webex Call History.
3. Zet de schakelaar op de gewenste instelling, in- of uitgeschakeld.

   Indien ingeschakeld, is de oproepgeschiedenis beschikbaar voor alle gebruikers en profielen.

Voor gebruikers van CUCM en Broadworks wordt de volgende functionaliteit niet ondersteund:

• Inkomende gesprekken ontvangen in de wereldwijde Salesforce-dialer (de Webex-app ontvangt nog steeds inkomende oproepen)
• De gespreksduur bekijken in het Salesforce-gesprekslogvenster na het succesvol plaatsen van een uitgaand gesprek
• Oproepen beëindigen via de knop in het Salesforce-gesprekslogvenster nadat een uitgaand gesprek met succes is geplaatst
• De gespreksduur automatisch invullen in het Salesforce-gesprekslogvenster na het beëindigen van een uitgaand gesprek

Houd bij alle Salesforce-integraties rekening met de volgende beperking:

• Salesforce hanteert een beperking van het aantal gebeurtenissen (25.000), wat ertoe kan leiden dat integraties mislukken bij intensief gebruik. Er zijn Salesforce-pakketten beschikbaar om die limiet te verhogen. Voor meer informatie, zie https://developer.salesforce.com/docs/atlas.en-us. platform_eventsplatform_eventsplatform_event_limits.meta/.htm.

• Onderdelen van Webex Calling Utility zijn niet beschikbaar in de mobiele Salesforce-app.