Voordat u de configuratiestappen volgt, moet u eerst naar de release-opmerkingen gaan en de nieuwste versie van het Salesforce-pakket voor de Webex-app downloaden.

Vereisten

Salesforce Enterprise Edition

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

Mijn domein in de Salesforce-organisatie

U moet Mijn domein in uw organisatie implementeren als u Lightning-componenten wilt gebruiken. Raadpleeg de documentatie bij Mijn domein Salesforce voor meer informatie.

Gebruikerstoegang in Control Hub

U moet gebruikerstoegang tot integraties in uw organisatie configureren.

• Zonder Pro-pakket: wanneer u de basis Control Hub hebt, kunt u ervoor kiezen om alle integraties voor al uw gebruikers toe te staan of te weigeren.

• Met het Pro-pakket—Met het Pro-pakket beschikt u over geavanceerde functionaliteit om de toegang tot integraties voor gebruikers te beheren.

Zie Gebruikerstoegang tot integraties configureren voor meer informatie.

Oproepen

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

• Bellen in Webex (Unified CM) wordt gedeeltelijk ondersteund. Alleen uitgaande gesprekken openen een logboekpop-up in Salesforce. Voor inkomende gesprekken gaat de Webex-app over, maar kan Salesforce het gesprek niet onderscheppen. De pop-upmelding voor logboekregistratie wordt dus niet weergegeven.

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

Deze procedures zijn van toepassing op klanten die versie 1.18 en eerder van de Webex Salesforce-integratie gebruiken. Zie de bijgewerkte instructies voor versie 1.19 en later: Configureer een Salesforce-autorisatie (1.19 en hoger) op het tabblad Installeren en beheren

1. Een verbonden app maken

Een nieuwe verbonden app maken:

1. Zoek in Setup naar App Manager en kies vervolgens New Connected App.

   

2. Voer een naam voor de verbonden app in, bijvoorbeeld MyExampleApp.
3. Voer een e-mailadres voor de contactpersoon in.
4. Schakel OAuth-instellingen inschakelen in.
5. Geef een terugbel-URL voor de tijdelijke aanduiding op (we werken deze later bij), bijvoorbeeld https://localhost/placeholder.

   

6. Scrol omlaag en kies de volgende OAuth-scopes:
   • Volledige toegang (volledig)
   • Aanvragen op elk moment uitvoeren (refresh_token, offline_access)

   

   Met de scope Perform requests at any time kan Named Credentials uw toegangstoken vernieuwen wanneer een sessie verloopt.

7. Scrol naar de onderkant van de pagina en klik op Opslaan en klik vervolgens op Doorgaan.
8. Blader op de volgende pagina naar API (Enable OAuth Settings) en klik op Manage Consumer Details.

   

   Mogelijk moet u zich opnieuw verifiëren bij Salesforce.

9. Noteer de Consumentensleutel en het Consumentengeheim.

   

2. Een verificatieprovider maken

Vervolgens moet u een verificatieprovider maken die de verificatie met uw Salesforce-organisatie faciliteert.

Een verificatieprovider maken:

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

   

2. Selecteer Salesforce als het providertype.
3. Voer een naam in voor de verificatieprovider, bijvoorbeeld ApexMDTAPI.
4. Plak in de Consumer Key en Consumer Secret die u hebt opgeslagen bij het configureren van uw Connected-app.
5. Voer de volgende scopes in Standaardscopes, volledige refresh_token offline_access in.
6. Laat alles leeg en klik op Opslaan.

   

7. Kopieer de terugbel-URL vanuit het gedeelte Salesforce-configuratie.

   

8. Bewerk uw verbonden app en vervang de placeholder-URL door de terugbel-URL die u hebt gekopieerd uit de Salesforce-configuratie hierboven.

   

9. Sla uw verbonden app op.

   Mogelijk moet u tot 10 minuten wachten om de instellingen van kracht te laten worden en deze door de infrastructuur van Salesforce te verspreiden.

3. Een benoemde referentie maken

U moet vervolgens een benoemde referentie maken.

Een benoemde referentie 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 exemplaar-URL van uw organisatie in, bijvoorbeeld https://na1.salesforce.com, of, als u Mijn domein gebruikt, uw volledig gekwalificeerde domeinnaam Mijn domein, bijvoorbeeld https://mycompany.my.salesforce.com.
4. Kies voor Identity TypeNamed Principal.
5. Kies voor Authentication ProtocolOAuth 2.0.
6. Voor verificatieprovider kiest u de verificatieprovider die u eerder hebt gemaakt.
7. Voer voor Scopevolledige refresh_token offline_access in.
8. Schakel Verificatiestroom starten op Opslaan in.

   

9. Schakel in de afroepopties Samenvoegingsvelden toestaan in HTTP Body in en klik vervolgens op Opslaan.

   

10. U wordt gevraagd u aan te melden bij uw organisatie. Nadat u zich hebt aangemeld, ziet u een dialoogvenster Toegang toestaan. Klik op Toestaan.
11. Vervolgens wordt het Named Credential-scherm omgeleid en de Authenticated Status geeft aan Authenticated as your-email@domain.com.

4. Uw site maken in het Webex-beheerscherm

Ga ten slotte naar het volgende onderwerp op het tabblad Bellen, Site maken voor bellen, hieronder.

Volg de bovenstaande naamgevingsconventies tijdens de siteconfiguratie.

Volg voor Webex voor Salesforce-integraties versie 1.19 en hoger de instructies in dit artikel om bestaande Webex Connected-app voor autorisaties, benoemde referenties en verificatieproviders te verwijderen en maak vervolgens een nieuwe Webex Connected-app voor Salesforce-autorisatie.

Deze procedures zijn van toepassing op klanten die versie 1.19 en hoger van de Webex Salesforce-integratie gebruiken. Voor instructies voor versie 1.18 en eerder, zie Een Salesforce-autorisatie configureren (1.18 en hoger) op het tabblad Installeren en beheren

Alle bestaande Webex Connected-apps, benoemde referenties en verificatieproviders verwijderen

Als u eerder een Webex Connected-app-autorisaties, benoemde gebruikersgegevens of verificatieprovider hebt gemaakt, moet u deze verwijderen voordat u doorgaat. Anders gaat u hieronder verder met Een nieuwe verbonden Webex-app maken.

Uw bestaande Webex Connected-app verwijderen:

1. Selecteer het tandwielpictogram in de rechterbovenhoek van uw Salesforce-landingspagina en kies Setup.
2. Voer in het tekstvak Snel zoekenApp Manager in en selecteer deze in de lijst.
3. Blader naar uw Webex Connected-app in de lijst, klik op het pictogram met de pijl omlaag rechts van de invoer en kies Weergave.
4. Selecteer Verwijderen en selecteer vervolgens Verwijderen opnieuw wanneer u wordt gevraagd om te bevestigen.

Verwijder alle bestaande aanmeldgegevens met naam Webex:

1. Voer in het tekstvak Snel zoekenBenoemde aanmeldgegevens in en selecteer deze in de lijst.
2. 2. Klik op de pijl omlaag rechts van de Webex benoemde aanmeldgegevens en kies Verwijderen.
3. 3. Kies Verwijderen opnieuw wanneer u wordt gevraagd om te bevestigen.

Alle bestaande Webex-verificatieproviders verwijderen:

1. Voer in het tekstvak Snel zoekenVerificatie in. Providers en selecteer deze in de lijst.
2. Selecteer de koppeling Del aan het begin van de invoer voor de Webex-provider.
3. Selecteer OK wanneer u wordt gevraagd om te bevestigen.

Ga naar het volgende gedeelte om een nieuwe Webex Connected-app voor Salesforce-autorisatie te maken.

Een nieuwe Webex Connected-app maken voor Salesforce-autorisatie

Een nieuwe Webex Connected-app voor Salesforce-autorisatie maken:

1. Selecteer het tandwielpictogram in de rechterbovenhoek van uw Salesforce-landingspagina en kies Setup.
2. Uw domein-URL ophalen: in Snel zoeken, zoek en selecteer Domeinen en sla de URL op vanuit Mijn domein.

1. Voer in het tekstvak Snel zoekenApp Manager in en selecteer deze in de lijst.
2. Voer een naam voor de verbonden app in, bijvoorbeeld Webex Salesforce-autorisatie.
3. Voer een e-mailadres in voor Contact Email.
4. Schakel OAuth-instellingen inschakelen in.
5. Voer twee terugbel-URL's in met de URL die u eerder hebt opgehaald, één per lijn, 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

6. Kies de volgende scopes uit de lijst Beschikbare OAuth-scopes in Geselecteerde OAuth-scopes:
   • Volledige toegang (volledig)
   • Aanvragen op elk moment uitvoeren (refresh_token, offline_access)
7. Schakel het selectievakje Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows (PKCE-toestelnummer vereisen voor ondersteunde autorisatiestromen) uit.
8. Sla de verbonden app op en noteer de gegenereerde consumentensleutel en consumentengeheim voor later gebruik.

Wanneer er een nieuw pakket beschikbaar is, volgt u de stappen in De Webex-app installeren in Salesforce. U hoeft de oude versie niet eerst te verwijderen en uw geconfigureerde instellingen gaan niet verloren.

Zie de release-opmerkingen voor de Webex Salesforce-integratie voor informatie over de nieuwe installatiepakketten en waar u deze kunt downloaden.

Gespreksgeschiedenis in- of uitschakelen:

1. Ga naar Webex-beheerder.
2. Scrol omlaag naar Webex-gespreksgeschiedenis.
3. Schakel de schakelaar in op de gewenste instelling, in- of uitgeschakeld.

   Indien ingeschakeld, is gespreksgeschiedenis beschikbaar voor alle gebruikers en profielen.

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

• Inkomende gesprekken ontvangen in de algemene kiezer van Salesforce (de Webex-app ontvangt nog steeds inkomende gesprekken)
• Gespreksduur weergeven in het gesprekslogvenster van Salesforce nadat een uitgaand gesprek is geplaatst
• Gesprekken beëindigen via de knop in het gesprekslogvenster van Salesforce nadat een uitgaand gesprek is geplaatst
• Automatisch invullen van gespreksduur in het Salesforce-gesprekslogvenster na het beëindigen van een uitgaand gesprek

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

• Salesforce handhaaft een beperking van het aantal evenementen (25.000), waardoor integraties kunnen mislukken bij zwaar gebruik. Salesforce-pakketten zijn beschikbaar om die limiet te verhogen. Zie https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_events_limits.htm voor meer informatie.

Met het configuratievenster Webex-webinars webinargegevens importeren kunnen geautoriseerde Salesforce-gebruikers Webex-webinargenodigden, -geregistreerden en -deelnemers rechtstreeks importeren in Salesforce-objecten zoals leads en contactpersonen.

De configuratieinterface Webinargegevens importeren is beschikbaar op de Webex-beheerpagina:

Zodra importeren van webinars is ingeschakeld, kunnen geautoriseerde gebruikers Webex-webinargegevens importeren met de widget Webex Webinars:

Webex-webinarmachtigingen toewijzen aan Salesforce-gebruikers

Voordat uw gebruikers toegang hebben tot de importfunctionaliteit van de Webex-webinar, moet u aan elke gebruiker de machtiging Webex-importbeheerder toewijzen.

Machtigingen toewijzen aan een gebruiker:

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

   

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

Het tijdbereik van de Webex-webinar configureren

Het tijdbereik van weergegeven Webex-webinars configureren:

1. Klik op de knop Salesforce-apps, voer Webex in het zoekveld in en kies Webex-beheerder:

   

2. Zoek het deelvenster Webex Webinars en voer het aantal dagen in waarvoor u afgelopen en komende webinars wilt weergeven in de widget Webex Webinars op de startpagina:

   

Ga verder met het configureren van de toewijzingen van importvelden voor Webex-webinars.

Toewijzingen van importvelden voor Webex-webinars configureren

Met de instellingen voor het importeren van Webex-webinars definieert u toewijzingen tussen Salesforce-objecten en velden van webinarobjecten. U kunt bijvoorbeeld voor- en achternamen van een Salesforce-contactobject toewijzen aan de parallelle veldnamen voor genodigden, geregistreerden en deelnemers van de webinar: voornaam en achternaam.

Importeerinstellingen voor Webex-webinar configureren:

1. Blader op de pagina Webex-beheerder omlaag naar het deelvenster Webinargegevens importeren:

   

2. Kies een Salesforce-object in de vervolgkeuzelijst 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 elke webinar als u wilt dat alle geïmporteerde webinardeelnemers worden gemaakt als nieuwe objectrecords, tenzij ze al zijn geïmporteerd voor dezelfde webinar (op basis van de geselecteerde primaire sleutel). Bestaande records worden niet bijgewerkt, zelfs niet als de primaire sleutel overeenkomt, tenzij ze voor hetzelfde Webex-webinar worden geïmporteerd.

   Voor deze standaardobjecten kunt u ervoor kiezen ze als volgt aan uw Salesforce-campagnes te koppelen:

   • Leden van de campagne: Geïmporteerde leads en contactpersonen zijn beschikbaar in het gedeelte Campagneleden van een gerichte Salesforce-campagne. Dit is een standaard Salesforce-functie. (Beschikbaar in versie 1.16 en hoger)
   • Leden van Webex Webinar-campagne: Geïmporteerde leads en contactpersonen zijn beschikbaar in het gedeelte Webex Webinar-campagneleden van een gerichte Salesforce-campagne. Dit is een aangepaste Webex-functie.
   • Zowel campagneleden als leden van de Webex Webinar-campagne: Geïmporteerde leads en contactpersonen zijn beschikbaar op beide locaties binnen een Salesforce-campagne. (Beschikbaar in versie 1.16 en hoger)

   Elk ander aangepast object dat u uit de lijst kiest, wordt geïmporteerd in het gedeelte Webex Webinar-campagneleden van de beoogde Salesforce-campagne.

3. Kies in de selectieinterface Primaire sleutel een uniek veld als primaire sleutel en gebruik de pijl naar rechts om het naar de Geselecteerde lijst te verplaatsen:

   

   Voor de primaire sleutel kiest u een beschikbaar veld dat uniek is voor elke record. U kunt bijvoorbeeld veel contacten hebben met de voornaam Merk, maar elk contact heeft een uniek e-mailadres.

4. Kies in de interface Gegevensveldtoewijzing een veld uit het Salesforce-object dat u hebt geselecteerd en wijs het toe aan een overeenkomstig veld voor het webinarobject. Gebruik de knop + Nieuw veld om indien nodig extra velden toe te voegen.

   Alle velden van Salesforce-objecten moeten worden toegewezen aan overeenkomstige webinarvelden, zoals hierboven wordt weergegeven.

   Alleen standaardvragen van registratieformulieren voor Webex-webinars kunnen worden toegewezen aan Salesforce-velden. Aangepaste Webex-webinarvragen worden niet ondersteund.

5. U kunt velden verwijderen die u hebt toegevoegd met het prullenbakpictogram naast het veld aan de rechterkant.
6. Klik op Opslaan wanneer u klaar bent en zodra u uw primaire sleutel hebt geverifieerd, klikt u op Opslaan in het bevestigingsdialoogvenster:

   

   De toewijzingen worden weergegeven in het bijgewerkte deelvenster:

   

   U kunt objecttoewijzingen verwijderen met het pictogram Prullenbak, waarin een extra bevestigingsdialoogvenster wordt weergegeven, of bestaande toewijzingen wijzigen met het potloodpictogram.

   U kunt hier altijd terugkeren en de primaire sleutel wijzigen, maar de primaire sleutel wordt niet bijgewerkt voor records die al in het systeem zijn geïmporteerd. Hierdoor kan dit leiden tot duplicaten, dus pas de primaire sleutels voorzichtig aan.

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

Webinargegevensimport inschakelen voor uw Salesforce-gebruikers

Wanneer de toewijzingen voor webinarvelden zijn ingesteld, kunt u vervolgens kiezen wie toegang heeft tot de functie voor het importeren van webinargegevens. Opties omvatten algemene 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

Als u het importeren van webinargegevens voor iedereen in uw Salesforce-organisatie wilt inschakelen, schakelt u Webinarimport voor alle profielen/gebruikers inschakelen in op Ingeschakeld:

Webinargegevens importeren inschakelen voor geselecteerde gebruikers of profielen

U kunt het importeren van webinargegevens inschakelen voor geselecteerde individuele gebruikers of voor specifieke sets gebruikers die overeenkomen met een bepaald Salesforce-gebruikersprofiel.

Webinargegevens importeren voor geselecteerde gebruikers of profielen inschakelen:

1. Zorg ervoor dat Webinarimport inschakelen voor alle profielen/gebruikers is uitgeschakeld:

   

2. Selecteer in de vervolgkeuzelijst Webinar importeren alleen voor deze profielen/gebruikers Profiel of Gebruiker:

   

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

     

   • Als u een afzonderlijke gebruiker wilt toevoegen, selecteert u Gebruiker en voert u een gebruikersnaam in het tekstvak in. Klik op Toevoegen om de gebruiker toe te voegen:

     

   Als u een gebruiker of profiel wilt verwijderen, klikt u op het pictogram van de prullenbak naast de invoer.