Danke für Ihr Feedback.

Bevor Sie fortfahren, stellen Sie bitte sicher, dass Sie die folgenden Voraussetzungen erfüllen:

• Der Benutzer, der die Einrichtung durchführt, muss Administrator der Salesforce-Organisation sein, in der die Integration installiert werden soll.
• Diese Integration erfordert ein Minimum an Salesforce-Unternehmens-Ausgabe. Weitere Informationen finden Sie unter Salesforce-Ausgaben .
• Die Organisation muss Webex mit den richtigen Lizenzen für die erforderlichen Funktionen konfiguriert haben, einschließlich Nachrichten, Besprechungen und Telefonieren.
• Alle Benutzer, die die Integration nutzen, müssen über Salesforce-Zugriff und die erforderlichen Salesforce-Lizenzen verfügen.
• Alle Benutzer müssen über die erforderlichen Webex-Lizenzen verfügen, um bestimmte Webex-Funktionen wie Webex Meetings und innerhalb Webex Calling von Salesforce nutzen zu können.

  CUCM und Broadworks werden mit eingeschränkter Funktionalität unterstützt. Weitere Informationen finden Sie unter Anrufbeschränkungen im Abschnitt Anrufe.

• Diese Integration ist für Salesforce Lightning verfügbar.

  Sie müssen Meine Domain in Ihrer Organisation bereitstellen, wenn Sie Lightning-Komponenten verwenden möchten. Weitere Informationen finden Sie unter Meine Salesforce-Domain.

• Sie müssen den Benutzerzugriff auf Integrationen in Ihrer Organisation konfigurieren.
  • Ohne Pro Pack — Wenn Sie Basic Control Hub haben, können Sie all Ihren Benutzern den Zugriff auf alle Integrationen gewähren oder verweigern.
  • Mit Pro Pack — Mit Pro Pack verfügen Sie über erweiterte Funktionen zur Verwaltung des Benutzerzugriffs auf Integrationen.

  Weitere Informationen finden Sie unter Benutzerzugriff auf Integrationen konfigurieren.

Bei Versionen der Webex Salesforce-Integration, die später als 1.14 erscheinen, können Sie jetzt über Salesforce Exchange ein Upgrade durchführen.

Um die Webex-Integration mit Salesforce Exchange zu installieren:

1. Navigieren Sie zur Webex App für Salesforce im AppExchange.
2. Wählen Sie Jetzt herunterladen.
3. Wählen Sie die verbundene Organisation aus, in der Sie die Integration installieren möchten.
4. Installieren Sie die App nur für Administratoren.
5. Fahren Sie mit fort und autorisieren Sie die Webex-Integration auf der Registerkarte Installieren und Verwalten.

Bevor Sie die Konfigurationsschritte befolgen, müssen Sie zuerst zur Software-Dokumentation gehen und die neueste Version des Webex App Salesforce-Pakets herunterladen.

Voraussetzungen

Salesforce Unternehmens-Ausgabe

Diese Integration erfordert ein Minimum an Salesforce-Unternehmens-Ausgabe. Weitere Informationen finden Sie unter Salesforce-Ausgaben .

Meine Domäne in Salesforce-Organisation

Sie müssen Meine Domain in Ihrer Organisation bereitstellen, wenn Sie Lightning-Komponenten verwenden möchten. Weitere Informationen finden Sie in der Dokumentation "Meine Domäne Salesforce ".

Benutzerzugriff im Control Hub

Sie müssen den Benutzerzugriff auf Integrationen in Ihrer Organisation konfigurieren.

• Ohne Pro Pack — Wenn Sie Basic Control Hub haben, können Sie all Ihren Benutzern den Zugriff auf alle Integrationen gewähren oder verweigern.

• Mit Pro Pack — Mit Pro Pack verfügen Sie über erweiterte Funktionen zur Verwaltung des Benutzerzugriffs auf Integrationen.

Weitere Informationen finden Sie unter Benutzerzugriff auf Integrationen konfigurieren.

Calling

• Webex Calling eingehende und ausgehende Anrufe für die Anrufsteuerung in Salesforce werden vollständig unterstützt.

• Anrufe in Webex (Unified CM) werden teilweise unterstützt. Nur ausgehende Anrufe eröffnen ein Anmelde-Pop-up bei Salesforce. Bei eingehenden Anrufen klingelt die Webex-App, aber Salesforce kann den Anruf nicht abfangen, sodass das Logging-Popup nicht angezeigt wird.

Wenn Sie mit Webex for Salesforce Version 1.18 oder früher arbeiten, müssen Sie eine Salesforce-Autorisierung konfigurieren, bevor Sie Webex Calling innerhalb von Salesforce damit arbeiten können.

Erstellen Sie eine verbundene App

1. Suchen Sie in Setup nach External Client App.

   

2. Wählen Sie unter Apps für externe Clients die Option Einstellungen aus.
3. Aktivieren Sie „Erstellung verbundener Apps zulassen“. Wenn die Schaltfläche „Neue verbundene App“ bereits aktiviert ist, können Sie fortfahren und eine neue verbundene App erstellen.

   

4. Um eine neue verbundene App zu erstellen, klicken Sie auf Neue verbundene App und geben Sie die erforderlichen Details ein.

   

5. Geben Sie einen Namen für die verbundene App ein, z. B. myExampleApp.
6. Geben Sie eine Kontakt-E-Mail-Adresse ein.
7. Markieren Sie das Kästchen für OAuth-Einstellungen aktivieren.
8. Geben Sie eine Platzhalter-Rückruf-URL an (wir werden das später aktualisieren), z. B. https://localhost/placeholder

   

9. Scrollen Sie nach unten und wählen Sie die folgenden OAuth-Bereiche aus:
   • Vollständiger Zugriff (vollständig)
   • Führe jederzeit Anfragen aus (refresh_token, offline_access)

   

   Der Bereich„ Anfragen jederzeit ausführen “ ermöglicht es Named Credentials, Ihr Zugriffstoken zu aktualisieren, wenn eine Sitzung abläuft.

10. Scrollen Sie zum Ende der Seite und klicken Sie auf Speichern und dann auf Weiter.
11. Scrollen Sie auf der nächsten Seite zu API (OAuth-Einstellungen aktivieren) und klicken Sie auf Verbraucherdetails verwalten.

    

    Möglicherweise müssen Sie sich erneut bei Salesforce authentifizieren.

12. Notieren Sie sich den Consumer Key und das Consumer Secret.

    

Erstellen Sie einen Authentifizierungsanbieter

Als Nächstes erstellen Sie einen Authentifizierungsanbieter, der die Authentifizierung mit Ihrer Salesforce-Organisation erleichtert.

1. Suchen Sie in Setupnach Auth und wählen Sie Auth aus. Anbieter. Klicken Sie auf Neu.

   

2. Wählen Sie Salesforce als Anbietertypaus.
3. Geben Sie einen Namen für den Auth-Anbieter ein, z. B. ApexMDTAPI.
4. Fügen Sie den Consumer Key und das Consumer Secret ein, die Sie bei der Konfiguration Ihrer Connected App gespeichert haben.
5. Geben Sie refresh_token offline_access in Standardbereiche den vollen Wert ein.
6. Lassen Sie alle anderen Felder leer und klicken Sie auf Speichern.

   

7. Kopieren Sie die Callback-URL aus dem Abschnitt Salesforce-Konfiguration.

   

8. Bearbeiten Sie Ihre verbundene App und ersetzen Sie die Platzhalter-URL durch die Callback-URL, die Sie oben aus der Salesforce-Konfiguration kopiert haben.

   

9. Speichern Sie Ihre verbundene App.

   Es kann bis zu 10 Minuten dauern, bis die Einstellungen wirksam werden und sich in der gesamten Infrastruktur von Salesforce verbreiten.

Erstellen Sie eine benannte Anmeldeinformation

1. Suchen Sie in Setupnach Benannt und wählen Sie Benannte Anmeldeinformationenaus. Klicken Sie auf New Legacy.

   

2. Geben Sie ApexMDTAPI in Label ein.
3. Geben Sie die Instanz-URL Ihrer Organisation in URL ein, z. B. https://na1.salesforce.com; oder, falls Sie Meine Domain verwenden, Ihren vollqualifizierten Namen für Meine Domain, z. B. https://mycompany.my.salesforce.com.
4. Wählen Sie für Identitätstyp Named Principal aus.
5. Wählen Sie für Authentication Protocol OAuth 2.0 aus.
6. Wählen Sie für Authentication Provider den Authentifizierungsanbieter aus, den Sie zuvor erstellt haben.
7. Geben Sie Full refresh_token offline_access in Scope ein.
8. Markieren Sie das Kästchen neben Authentifizierungsablauf beim Speichern starten.

   

9. Markieren Sie in den Callout-Optionen das Kästchen neben Zusammenführen von Feldern im HTTP-Text zulassen, und klicken Sie dann auf Speichern.

   

10. Loggen Sie sich in Ihre Organisation ein. Nachdem Sie sich angemeldet haben, klicken Sie auf Allow in Allow Access.
11. Auf dem Bildschirm „Anmeldeinformationen mit Namen“ steht „Authentifiziert“ für „Authentifiziert“ als your-email@domain.com.

Erstellen Sie Ihre Website im Webex-Adminbereich

Fahren Sie mit Website für Anrufe erstellen im Abschnitt Anrufen fort.

Für Webex für Salesforce-Integrationen ab Version 1.19 befolgen Sie die Anweisungen in diesem Artikel, um alle vorhandenen Webex Connected App für Autorisierungen, benannte Anmeldeinformationen und Authentifizierungsanbieter zu entfernen und anschließend eine neue Webex Connected App für die Salesforce-Autorisierung zu erstellen.

Entfernen Sie alle vorhandenen Webex Connected-Apps, benannten Anmeldeinformationen und Authentifizierungsanbieter.

Falls Sie zuvor Webex Connected App-Autorisierungen, benannte Anmeldeinformationen oder Authentifizierungsanbieter erstellt haben, müssen Sie diese vor dem Fortfahren entfernen. Andernfalls fahren Sie mit Erstellen einer neuen Webex Connected App unten fort.

Entfernen Sie Ihre bestehende Webex Connected-App:

1. Klicken Sie in der oberen rechten Ecke Ihrer Salesforce-Landingpage auf , dann wählen Sie Setup.
2. Geben Sie im Textfeld Schnellsuche App Manager ein und wählen Sie ihn dann aus der Liste aus.
3. Scrollen Sie in der Liste zu Ihrer Webex Connected App, klicken Sie auf den Abwärtspfeil rechts neben dem Eintrag und wählen Sie dann Anzeigen aus.
4. Wählen Sie Löschen und dann erneut Löschen, wenn Sie zur Bestätigung aufgefordert werden.

Entfernen Sie alle vorhandenen benannten Webex-Anmeldeinformationen:

1. Geben Sie im Textfeld Schnellsuche Named Credentials ein und wählen Sie es dann aus der Liste aus.
2. Klicken Sie auf den Abwärtspfeil rechts neben dem Eintrag für benannte Webex-Anmeldeinformationen und dann auf Löschen.
3. Klicken Sie erneut auf Löschen, wenn Sie zur Bestätigung aufgefordert werden.

Entfernen Sie alle vorhandenen Webex-Authentifizierungsanbieter:

1. Geben Sie in das Textfeld Schnellsuche Auth ein. Anbieter, wählen Sie ihn dann aus der Liste aus.
2. Wählen Sie den Link Del am Anfang des Eintrags für den Webex-Authentifizierungsanbieter.
3. Klicken Sie auf OK, wenn Sie zur Bestätigung aufgefordert werden.

Fahren Sie mit dem nächsten Abschnitt fort, um eine neue Webex Connected App für die Salesforce-Autorisierung zu erstellen.

Erstellen Sie eine neue Webex Connected App für die Salesforce-Autorisierung

So erstellen Sie eine neue Webex Connected App für die Salesforce-Autorisierung:

1. Klicken Sie in der oberen rechten Ecke Ihrer Salesforce-Landingpage auf , dann wählen Sie Setup.
2. Rufen Sie Ihre Domain-URL ab: In Quick Findsuchen und wählen Sie Domainsaus und speichern Sie die URL aus My Domain.
3. Suchen Sie in Setup nach External Client App.

   

4. Wählen Sie unter Apps für externe Clients die Option Einstellungen aus.
5. Aktivieren Sie „Erstellung verbundener Apps zulassen“. Wenn die Schaltfläche „Neue verbundene App“ bereits aktiviert ist, können Sie fortfahren und eine neue verbundene App erstellen.

   

6. Um eine neue verbundene App zu erstellen, klicken Sie auf Neue verbundene App und geben Sie die erforderlichen Details ein.

   

7. Geben Sie im Textfeld Schnellsuche App Manager ein und wählen Sie ihn aus der Liste aus.
8. Geben Sie einen Namen der verbundenen Appein, zum Beispiel Webex Salesforce Authorization.
9. Geben Sie eine E-Mail-Adresse für Kontakt-E-Mailein.
10. Markieren Sie das Kästchen für OAuth-Einstellungen aktivieren.
11. Geben Sie zwei Callback-URLs ein, indem Sie die zuvor abgerufene URL verwenden, eine pro Zeile, und fügen Sie /apex/ webexsfdcauth und /apex/ cisco_webex__webexsfdcauth als Suffixe hinzu. Beispiel:

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

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

12. Wählen Sie die folgenden Bereiche aus der Liste Verfügbare OAuth-Bereiche unter Ausgewählte OAuth-Bereicheaus. :
    • Vollständiger Zugriff (vollständig)
    • Führe jederzeit Anfragen aus (refresh_token, offline_access)
13. Deaktivieren Sie das Kästchen für die Erweiterung „Proof Key for Code Exchange (PKCE) erforderlich“ für unterstützte Autorisierungsabläufe.
14. Klicken Sie auf Speichern.
15. Kopieren und speichern Sie den Consumer Key und das Consumer Secret. Sie benötigen diese Werte, wenn Sie die Salesforce-Autorisierung in Control Hub konfigurieren.

Für die Webex for Salesforce-Integration Version 1.22 und höher konfigurieren Sie die Salesforce-Autorisierung mit einer externen Client-Anwendung. Wenn Sie bereits eine Connected App for Webex Salesforce-Autorisierung haben, können Sie sie zu einer externen Client-Anwendung migrieren und ihren Consumer Key beibehalten.

Vorbereitungen

• Sie benötigen Salesforce-Systemadministrator-Zugriff.
• Meine Domain muss in Ihrer Salesforce-Organisation aktiviert sein.

Rufen Sie Ihre „Meine Domain“ -URL ab

1. Klicken Sie in der oberen rechten Ecke Ihrer Salesforce-Landingpage auf , dann klicken Sie auf Setup.
2. Suchen Sie im Feld Schnellsuche nach Domains und wählen Sie sie aus.
3. Notieren Sie sich Ihre „Meine Domain“ -URL. Sie werden es verwenden, um die Callback-URLs zu konfigurieren. Ihre URL könnte zum Beispiel sein https://my-company.my.salesforce.com.

Erstellen einer neuen externen Client-App

1. Suchen Sie in Setup im Feld Schnellsuche nach App Manager und wählen Sie ihn aus.
2. Klicken Sie auf Neue externe Client-App.

   Geben Sie die folgenden Details ein:

   • Name der externen Kunden-App — Webex Salesforce-Autorisierung
   • API-Name — Webex_Salesforce_Authorization(automatisch ausgefüllt)
   • Kontakt-E-Mail — Ihre Administrator-E-Mail-Adresse
   • Vertriebsstaat — Lokal

3. Klicken Sie auf Erstellen.

OAuth-Einstellungen konfigurieren

1. Klicken Sie unter API (OAuth-Einstellungen aktivieren) auf OAuth aktivieren.
2. Konfigurieren Sie die Rückruf-URLs. [your-domain]Ersetzen Sie durch Ihren Salesforce-Wert „Meine Domäne“ und geben Sie jede URL in einer separaten Zeile ein:
   • https://[your-domain].my.salesforce.com/apex/webexsfdcauth
   • https://[your-domain].my.salesforce.com/apex/cisco_webex__webexsfdcauth
3. Fügen Sie diese OAuth-Bereiche zu den ausgewählten OAuth-Bereichen hinzu:
   • Voller Zugriff (full)
   • Anfragen jederzeit ausführen (refresh_token, offline_access)
4. Lassen Sie unter Sicherheit die Option „Require Proof Key for Code Exchange“ (PKCE) aktiviert sein.
5. Klicken Sie auf Erstellen.

Rufen Sie den Verbraucherschlüssel und das Verbrauchergeheimnis ab

1. Wählen Sie im Setup App Manager > External Client App Manager aus.
2. Klicken Sie auf Webex Salesforce Authorization.
3. Klicken Sie auf den Tab Einstellungen und öffnen Sie dann die OAuth-Einstellungen.
4. Klicken Sie auf Consumer Key und Secret.
5. Überprüfen Sie Ihre E-Mail auf den Bestätigungscode von Salesforce.
6. Geben Sie auf der Seite „Ihre Identität überprüfen“ den Code ein und klicken Sie auf Bestätigen.
7. Kopieren und speichern Sie den Consumer Key und das Consumer Secret. Sie benötigen diese Werte, wenn Sie die Salesforce-Autorisierung in Control Hub konfigurieren.

Migrieren Sie eine bestehende verbundene App

Wenn Sie bereits eine Connected App for Webex Salesforce-Autorisierung haben, migrieren Sie sie zu einer externen Kunden-App. Dadurch bleibt der Consumer Key erhalten, bestehende Tokens bleiben gültig und die OAuth-Einstellungen werden übertragen. Die ursprüngliche Connected App bleibt nach der Migration erhalten.

1. Suchen Sie in Setup nach App Manager und wählen Sie ihn aus.
2. Suchen Sie die bestehende Connected App, klicken Sie auf den Abwärtspfeil rechts in der Zeile und wählen Sie Anzeigen.
3. Klicken Sie auf der Detailseite der verbundenen App auf Zur externen Client-App migrieren.
4. Lesen Sie die Zusammenfassung der Migration und klicken Sie dann auf Migrieren.
5. Wenn die Migration abgeschlossen ist, öffnet Salesforce die neue Detailseite der externen Kunden-App.

Überprüfen Sie die Migration

1. Wählen Sie im Setup App Manager > External Client App Manager.
2. Bestätigen Sie, dass Webex Salesforce Authorization in der Liste erscheint.
3. Klicken Sie auf die App und stellen Sie sicher, dass auf der Registerkarte „Einstellungen“ die richtigen Rückruf-URLs und OAuth-Bereiche angezeigt werden:
   • Voller Zugriff (full)
   • Anfragen jederzeit ausführen (refresh_token, offline_access)
4. (Optional) Rufen Sie den Consumer Key und den Consumer Secret ab und bestätigen Sie, dass sie mit den Originalwerten übereinstimmen.

Deaktivieren Sie die ursprüngliche Connected App (optional)

Nachdem Sie überprüft haben, dass die externe Client-App funktioniert, gehen Sie wie folgt vor:

1. Wählen Sie unter Setup App Manager aus.
2. Suchen Sie die ursprüngliche Connected App und klicken Sie auf den Abwärtspfeil rechts neben der Zeile.
3. Wählen Sie Verwalten.
4. Stellen Sie unter OAuth-Richtlinien die Option Zugelassene Benutzer ein, um neue Autorisierungen zu blockieren, oder lassen Sie die Connected App während einer Übergangsphase aktiv.

Wir empfehlen, die ursprüngliche Connected App für eine kurze Übergangszeit aktiv zu lassen, damit Integrationen weiterhin funktionieren, bevor Sie sie deaktivieren.

Wenn ein neues Paket verfügbar ist, folgen Sie den oben unter Webex-App in Salesforce installieren beschriebenen Schritten. Sie müssen die alte Version nicht zuerst deinstallieren, und Sie werden Ihre konfigurierten Einstellungen nicht verlieren.

Informationen zu den neuen Installationspaketen und wo sie heruntergeladen werden können, finden Sie in den Versionshinweisen zur Webex Salesforce-Integration.

So aktivieren oder deaktivieren Sie den Anrufverlauf:

1. Gehen Sie zu Webex Admin.
2. Scrollen Sie nach unten zu Webex-Anrufverlauf.
3. Stellen Sie den Schalter auf die gewünschte Einstellung, entweder aktiviert oder deaktiviert.

   Wenn die Anrufliste aktiviert ist, steht sie allen Benutzern und Profilen zur Verfügung.

Für CUCM- und Broadworks-Benutzer wird die folgende Funktionalität nicht unterstützt:

• Empfang eingehender Anrufe im globalen Salesforce-Dialer (die Webex-App empfängt weiterhin eingehende Anrufe)
• Anzeigen der Anrufdauer im Salesforce-Anrufprotokollfenster nach erfolgreichem Tätigen eines ausgehenden Anrufs
• Beenden von Anrufen über die Schaltfläche im Salesforce-Anrufprotokollfenster nach erfolgreichem Tätigen eines ausgehenden Anrufs
• Automatische Anzeige der Anrufdauer im Salesforce-Anrufprotokollfenster nach Beendigung eines ausgehenden Anrufs

Beachten Sie für alle Salesforce-Integrationen die folgende Einschränkung:

• Salesforce setzt eine Begrenzung der Ereignisanzahl (25.000) durch, was bei starker Auslastung zum Ausfall von Integrationen führen kann. Es gibt Salesforce-Pakete, mit denen dieses Limit erhöht werden kann. Weitere Informationen finden Sie unter .https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm

• Die Webex-Anruffunktionen sind in der Salesforce-Mobil-App nicht verfügbar.