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, waaronder berichten, vergaderen 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 op het tabblad 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 de My Domain Salesforce-documentatie voor meer informatie.

• U moet gebruikerstoegang tot integraties in uw organisatie configureren.

  • Zonder Pro Pack — Als u over de standaard Control Hub beschikt, kunt u ervoor kiezen om al uw gebruikers de toegang tot alle integraties toe te staan of te weigeren.

  • Met Pro Pack — Met Pro Pack beschikt u over geavanceerde functionaliteit om de toegang tot integraties voor gebruikers 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 via Salesforce Exchange te installeren:

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 over de standaard Control Hub beschikt, kunt u ervoor kiezen om al uw gebruikers de toegang tot alle integraties toe te staan of te weigeren.

• Met Pro Pack — Met Pro Pack beschikt u over geavanceerde functionaliteit om de toegang tot integraties voor gebruikers 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 onderbreken, zodat de pop-up voor logboekregistratie niet verschijnt.

Als u met Webex voor Salesforce versie 1.18 of eerder werkt, moet u, voordat u Webex Calling binnen Salesforce kunt werken , een Salesforce-autorisatie configureren. Volg de secties in dit artikel om aan de slag te gaan.

1. Maak een verbonden app

Om een nieuwe Connected App te maken:

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

   

2. Kies Instellingen onder Externe client-app.
3. Schakel de schakelknop in om het aanmaken van verbonden apps toe te staan. Als de knop voor de nieuwe verbonden app al is ingeschakeld, is er geen nieuwe actie nodig. U kunt een nieuwe verbonden app maken.

   

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

   

5. Voer een naam voor een verbonden app in, bijvoorbeeld MyExampleApp.
6. Voer een e-mailadres voor contactpersonen in.
7. Vink OAuth-instellingen inschakelen aan.
8. Geef een tijdelijke terugbel-URL op (we updaten dit later), bijvoorbeeld 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.

    

2. Maak een Auth-provider aan

Vervolgens moet u een authenticatieprovider aanmaken, die de authenticatie bij uw Salesforce-organisatie mogelijk maakt.

Om een authenticatieprovider aan te maken:

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, bijvoorbeeld ApexMDTAPI.
4. Plak de Consumer Key en het Consumer Secret in die u hebt opgeslagen toen u uw Connected-app configureerde.
5. Voer de volgende scopes in bij Default Scopes, full refresh_token offline_access.
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 zijn dat u tot 10 minuten moet wachten voordat de instellingen van kracht worden en zich kunnen verspreiden in de infrastructuur van Salesforce.

3. Creëer een identificatienummer met een naam

Dan moet u een naamnummer aanmaken.

Om een naamsbewijs aan te maken:

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

   

2. Voer de volgende waarde in voor Label, ApexMDTAPI.
3. Voer voor de URL de instantie-URL van uw organisatie in, bijvoorbeeld https://na1.salesforce.com, of, als u Mijn domein gebruikt, uw volledig gekwalificeerde My Domain-domeinnaam, bijvoorbeeld https://mycompany.my.salesforce.com.
4. Kies Named Principal voor Identity Type.
5. Kies voor Authentication Protocol OAuth 2.0.
6. Kies bij Authentication Provider de authenticatieprovider die u eerder hebt aangemaakt.
7. Voer voor Scope de volledige refresh_token offline_access in.
8. Activeer Start Authentication Flow bij Opslaan.

   

9. Schakel in Callout-opties de optie Samenvoegvelden toestaan in de HTTP-hoofdtekst in en klik vervolgens op Opslaan.

   

10. U wordt gevraagd in te loggen bij uw organisatie. Nadat u bent ingelogd, ziet u het dialoogvenster Toegang toestaan. Klik op Toestaan.
11. U wordt dan doorgestuurd naar het scherm met benoemde inloggegevens en de geverifieerde status geeft aan dat u geverifieerd bent als your-email@domain.com.

4. Maak uw website in het beheerscherm van Webex

Ga tot slot verder met het volgende onderwerp op het tabblad Bellen, Site aanmaken om te bellen, hieronder.

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. Selecteer in de rechterbovenhoek van uw Salesforce-landingspagina het tandwielpictogram en kies 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 kies 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. 2. Klik op de pijl-omlaag aan de rechterkant van het item met de naam Webex en kies Verwijderen.
3. 3. Kies opnieuw Verwijderen wanneer u om bevestiging wordt gevraagd.

Verwijder eventuele bestaande Webex Auth Providers:

1. Voer Auth in het tekstvak Snel zoeken in. Providers en selecteer het in de lijst.
2. Selecteer de Del-link aan het begin van de invoer van de Webex-verificatieprovider .
3. Selecteer 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. Selecteer in de rechterbovenhoek van uw Salesforce-landingspagina het tandwielpictogram en kies 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. Kies Instellingen onder Externe client-app.
5. Schakel de schakelknop in om het aanmaken van verbonden apps toe te staan. Als de knop voor de nieuwe verbonden app al is ingeschakeld, is er geen nieuwe actie nodig. U kunt een nieuwe verbonden app maken.

   

6. Om een nieuwe verbonden app te maken, klikt u op de knop 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 OAuth-instellingen inschakelen aan.
11. Voer twee terugbel-URL's in met de URL die u eerder hebt opgehaald, één per regel, en voeg /apex/webexsfdcauth en /apex/cisco_webex__webexsfdcauth toe als 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. Schakel de Extension Proof Key for Code Exchange (PKCE) vereisen voor ondersteunde autorisatiestromen uit.
14. Sla de Connected App op en noteer de gegenereerde Consumer Key en Consumer Secret voor later gebruik.

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

Voor informatie over de nieuwe installatiepakketten en waar u ze kunt downloaden, zie de releaseopmerkingen over de Webex Salesforce-integratie.

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_events.meta/platform_events/platform_event_limits.htm.

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

Met behulp van het configuratiescherm Webinargegevens Webex Webinars importeren kunnen geautoriseerde Salesforce-gebruikers genodigden, registranten en deelnemers van Webex-webinars rechtstreeks importeren in Salesforce-objecten, zoals leads en contactpersonen.

De configuratie-interface voor het importeren van webinargegevens is beschikbaar op de beheerderspagina van Webex:

Zodra het importeren van webinars is ingeschakeld, kunnen geautoriseerde gebruikers Webex-webinargegevens importeren met behulp van de Webex Webinarswidget:

Wijs Webex-webinarmachtigingen toe aan Salesforce-gebruikers

Voordat uw gebruikers toegang hebben tot de importfunctionaliteit voor Webex-webinars, moet u aan elk van hen de Webex Import Admin-machtiging toewijzen.

Om machtigingen toe te kennen aan een gebruiker:

1. Navigeer naar de integratie van Salesforce met de Webex-app.
2. Kies het tabblad Beheren onderaan het artikel en vouw vervolgens Toegang verlenen uit:

   

3. Volg de instructies om de Webex Import Admin-machtiging toe te voegen aan uw Salesforce-gebruikersaccounts.

Configureer de tijdbereikweergave van het Webex-webinar

Om het tijdbereik van de weergegeven Webex-webinars te configureren:

1. Klik op de knop Salesforce Apps, voer Webex in het zoekveld in en kies vervolgens Webex Admin:

   

2. Zoek het Webex Webinarspaneel en voer het aantal dagen in waarvoor u eerdere en komende webinars wilt weergeven in de Webex webinars-widget op de startpagina:

   

Ga door met het configureren van de Webex-webinar voor het importeren van veldtoewijzingen.

Webex-webinars configureren voor het importeren van veldtoewijzingen

Met behulp van de importinstellingen voor Webex-webinars definieert u toewijzingen tussen Salesforce-objecten en Webinar-objectvelden. U kunt bijvoorbeeld de voor- en achternaam van een Salesforce Contact-object koppelen aan de parallelle veldnamen voor genodigden, registranten en deelnemers van een webinar: voornaam en achternaam.

Om de importinstellingen voor Webex-webinars te configureren:

1. Blader op de pagina Webex Admin omlaag naar het paneel Webinargegevens importeren:

   

2. Kies een Salesforce-object in de keuzelijst Object:

   

   Voor het Object kunt u kiezen uit de volgende standaard Salesforce-objecten, naast alle beschikbare geconfigureerde aangepaste objecten:

   • Contacten
   • Leads

   Kies de schakelaar Nieuwe records invoegen voor elk webinar als u wilt dat alle geïmporteerde webinardeelnemers als nieuwe objectrecords worden aangemaakt, tenzij ze al voor hetzelfde webinar zijn geïmporteerd (op basis van de geselecteerde primaire sleutel). Bestaande records worden niet bijgewerkt, zelfs niet als de primaire sleutel overeenkomt, tenzij ze worden geïmporteerd voor hetzelfde Webex-webinar.

   Voor die standaardobjecten kunt u ervoor kiezen om ze aan uw Salesforce-campagnes te koppelen, zoals:

   • Campagneleden: Geïmporteerde leads en contactpersonen zijn beschikbaar in de sectie Campagneleden van een doelcampagne van Salesforce, een standaardfunctie van Salesforce. (Beschikbaar in versie 1.16 en hoger)
   • Leden van de Webex-webinarcampagne: Geïmporteerde leads en contactpersonen zijn beschikbaar in de sectie Webex Webinar Campaign van een doelcampagne van Salesforce Campaign , een aangepaste Webex-functie.
   • Zowel campagneleden als Webex-webinarcampagneleden: Geïmporteerde leads en contactpersonen zijn op beide locaties binnen een Salesforce-campagne beschikbaar. (Beschikbaar in versie 1.16 en hoger)
   Elk ander aangepast object dat u uit de lijst kiest, wordt geïmporteerd in de sectie Webex Webinar Campaign van de doelcampagne voor Salesforce Campaign .

3. Kies in de interface voor het selecteren van primaire sleutels een uniek veld als primaire sleutel en gebruik de rechterpijl om het naar de geselecteerde lijst te verplaatsen:

   

   Kies voor de primaire sleutel een beschikbaar veld dat uniek is voor elk record. U kunt bijvoorbeeld veel contactpersonen hebben met de voornaam Mark, maar elk contact heeft een uniek e-mailadres.

4. Kies in de interface voor het in kaart brengen van gegevensvelden een veld uit het Salesforce-object dat u hebt geselecteerd en wijs dat toe aan een overeenkomstig veld voor het webinarobject. Gebruik de knop + Nieuw veld om zo nodig extra velden toe te voegen.
   Alle Salesforce-objectvelden moeten worden toegewezen aan de corresponderende webinarvelden, zoals hierboven weergegeven.
   Alleen standaardvragen van Webex-webinarregistratieformulieren kunnen worden toegewezen aan Salesforce-velden. Aangepaste Webex-webinarvragen worden niet ondersteund.
5. Velden die u hebt toegevoegd, kunt u verwijderen met het prullenbakpictogram naast het veld aan de rechterkant.
6. Klik op Opslaan als u klaar bent, en als u eenmaal uw primaire sleutel hebt geverifieerd, klikt u op Opslaan in het bevestigingsvenster:

   

   De kaarten worden weergegeven in het bijgewerkte paneel:

   

   U kunt objecttoewijzingen verwijderen met behulp van het prullenbakpictogram, dat een extra bevestigingsvenster zal weergeven, of bestaande toewijzingen wijzigen met het potloodpictogram.
   U kunt hier altijd terugkomen en de primaire sleutel wijzigen, maar dan wordt de primaire sleutel niet bijgewerkt voor records die al in het systeem zijn geïmporteerd. Als gevolg hiervan kan dit leiden tot duplicaten, dus pas de primaire sleutels voorzichtig aan.

Nadat u de veldtoewijzingen voor het webinar hebt geconfigureerd, kiest u wie toegang heeft tot de functionaliteit voor het importeren van webinargegevens.

Importeer webinargegevens voor uw Salesforce-gebruikers

Als de veldtoewijzingen voor het webinar zijn gemaakt, kunt u vervolgens kiezen wie toegang heeft tot de functie voor het importeren van webinargegevens. De opties omvatten wereldwijde toegang voor elk gebruikersaccount met de juiste machtigingen, individuele gebruikersaccounts en gebruikers die lid zijn van bepaalde Salesforce-profielen.

Importeren van webinargegevens voor alle gebruikers inschakelen

Om het importeren van webinargegevens voor iedereen in uw Salesforce-organisatie mogelijk te maken, schakelt u Webinarimport voor alle profielen/gebruikers inschakelen in op Ingeschakeld:

Importeren van webinargegevens inschakelen voor geselecteerde gebruikers of profielen

U kunt de import van webinargegevens inschakelen voor geselecteerde individuele gebruikers of voor specifieke groepen gebruikers die voldoen aan een bepaald Salesforce-gebruikersprofiel.

Om het importeren van webinargegevens voor geselecteerde gebruikers of profielen mogelijk te maken:

1. Zorg ervoor dat het importeren van webinars inschakelen voor alle profielen/gebruikers is uitgeschakeld:

   

2. Selecteer in de keuzelijst Webinarimport alleen voor deze profielen/gebruikers inschakelen de optie Profiel of Gebruiker:

   

   • Om een profiel toe te voegen, selecteert u Profiel, klikt u in het zoektekstvak en kiest u een Salesforce-rol in de keuzelijst. Klik op Toevoegen om de rol toe te voegen:

     

   • Om een individuele gebruiker toe te voegen, selecteert u Gebruiker en voert u een gebruikersnaam in het tekstvak in. Klik op Toevoegen om de gebruiker toe te voegen:

     

   Om een gebruiker of profiel te verwijderen, klikt u op het prullenbakpictogram naast het item.