Einführung
Verbinden Sie Salesforce, damit der KI-Assistent und die Agenten ausgewählte Salesforce-Objekte durchsuchen können, sobald ein Benutzer eine Frage stellt.
Dies ist ein Live-Konnektor. Es werden keine Daten aus Salesforce in Docebo kopiert, indiziert oder gespeichert. Wenn ein Benutzer eine Frage stellt, durchsucht Docebo zu diesem Zeitpunkt die von Ihnen verfügbaren Salesforce-Objekte unter Verwendung des eigenen Salesforce-Kontos des Benutzers.
So funktionieren die Berechtigungen für Salesforce: Jeder Kollege verbindet sein eigenes Salesforce-Konto, wenn er zum ersten Mal eine Frage stellt. Jede Suche wird dann als dieser Benutzer ausgeführt, sodass Salesforce seine eigenen Zugriffsregeln anwendet und die Benutzer nur die Datensätze sehen, deren Anzeige Salesforce ihnen erlaubt. Für das Salesforce-Konto jedes Benutzers muss die Berechtigung API Enabled aktiviert sein (siehe Erforderliche Einstellungen).
1. Voraussetzungen im Quellsystem
Erforderliche Rolle
Sie benötigen einen Salesforce-Administrator, der eine externe Client-App erstellen kann.
Erforderliche Einstellungen
Jede Person, die Fragen zu Salesforce-Daten stellen möchte, benötigt einen Salesforce-Benutzer mit der Berechtigung API Enabled. Das Profil „System Administrator“ und die meisten Standardprofile verfügen über diese Berechtigung.
Öffnen Sie zur Überprüfung in Salesforce Profiles, klicken Sie auf das Profil des Benutzers und suchen Sie in den Berechtigungen nach API Enabled. Auch ein Berechtigungssatz kann diese Berechtigung gewähren.
2. Vorbereitung im Quellsystem
Sie erstellen eine externe Client-App in Salesforce und kopieren ihren Consumer Key und Consumer Secret in Docebo.
Sie haben bereits eine App? Verwenden Sie sie stattdessen erneut. Öffnen Sie sie im External Client App Manager und überprüfen Sie die Einstellungen aus Turn on OAuth and add the callback URL, Require the secret and create the app und Let your users connect: die Callback-URL, die vier Bereiche, Require secret for Web Server Flow und Relax IP restrictions. Fahren Sie anschließend mit Copy the Consumer Key and Consumer Secret fort.
Öffnen Sie die Seite New External Client App
- Klicken Sie in Docebo auf der Registerkarte Authorize auf Open the New External Client App page. Salesforce wird in einer neuen Registerkarte geöffnet.
- Melden Sie sich mit einem Salesforce-Administratorkonto an, wenn Salesforce Sie dazu auffordert.
- Das Formular New External Client App wird angezeigt. Lassen Sie dieses Fenster geöffnet.
Wenn der Link das Formular nicht öffnet: Klicken Sie in Salesforce oben rechts auf das Zahnradsymbol und anschließend auf Setup. Geben Sie unter Quick Find External Client App Manager ein, öffnen Sie ihn und klicken Sie auf New External Client App.
App benennen
Unter Basic Information:
- External Client App Name: Geben Sie einen Namen ein, zum Beispiel „Docebo AI knowledge“.
- API Name: Salesforce füllt dieses Feld automatisch aus.
- Contact Email: Geben Sie Ihre E-Mail-Adresse ein.
- Distribution State: Lassen Sie Local ausgewählt.
Klicken Sie noch nicht auf Create.
OAuth aktivieren und die Callback-URL hinzufügen
- Scrollen Sie nach unten und klicken Sie auf API (Enable OAuth Settings), um den Bereich zu öffnen.
- Aktivieren Sie Enable OAuth.
- Fügen Sie die Callback-URL in Callback URL ein. Sie muss exakt übereinstimmen. Sie folgt diesem Muster: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback, zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback.
- Wählen Sie unter OAuth Scopes jeden der vier folgenden Bereiche unter Available OAuth Scopes aus und verschieben Sie ihn mit der Pfeilschaltfläche nach Selected OAuth Scopes.
| Bereich | Code |
|---|---|
| Manage user data via APIs | api |
| Perform requests at any time | refresh_token, offline_access |
| Access unique user identifiers | openid |
| Access the identity URL service | id, profile, email, address, phone |
Das Secret anfordern und die App erstellen
- Scrollen Sie nach unten zu Security.
- Aktivieren Sie Require secret for Web Server Flow und Require secret for Refresh Token Flow.
- Lassen Sie alle anderen Einstellungen unverändert. Die ausgegrauten Optionen werden von Salesforce festgelegt und können nicht geändert werden.
- Klicken Sie unten auf der Seite auf Create.
Ihren Benutzern ermóglichen, eine Verbindung herzustellen
Salesforce zeigt nun die Seite Ihrer neuen App an.
- Klicken Sie auf der Registerkarte Policies auf Edit.
- Klicken Sie auf OAuth Policies, um den Bereich zu öffnen.
- Legen Sie unter App Authorization die Option IP Relaxation auf Relax IP restrictions fest.
- Lassen Sie Permitted Users auf All users can self-authorize und die Richtlinie für das Aktualisierungstoken auf 30 days eingestellt.
- Klicken Sie auf Save.
Consumer Key und Consumer Secret kopieren
- Öffnen Sie die Registerkarte Settings der App und klicken Sie auf OAuth Settings, um den Bereich zu öffnen.
- Klicken Sie auf Consumer Key and Secret. Salesforce öffnet eine neue Registerkarte.
- Salesforce sendet Ihnen einen Bestätigungscode per E-Mail. Geben Sie ihn ein und klicken Sie auf Verify.
- Klicken Sie neben Consumer Key auf Copy und fügen Sie ihn in Docebo unter Consumer key ein.
- Klicken Sie neben Consumer Secret auf Copy und fügen Sie ihn in Docebo unter Consumer secret ein.
3. Erforderliche Aktionen in Docebo
| Einzugebende Informationen | Wo Sie sie finden |
|---|---|
| Consumer Key | Salesforce → Ihre App → Settings → OAuth Settings → Consumer Key and Secret |
| Consumer Secret | Salesforce → Ihre App → Settings → OAuth Settings → Consumer Key and Secret |
Autorisieren des Konnektors
- Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → Salesforce. Dieses Menü ist nur für Superadmins sichtbar. Überprüfen Sie auf der Registerkarte Overview, was durchsucht wird, und wählen Sie Get started aus.
Geben Sie auf der Registerkarte Setup an, welche Salesforce-Organisation verwendet werden soll. Öffnen Sie Salesforce in einer anderen Browser-Registerkarte, melden Sie sich an, kopieren Sie die vollständige Adresse aus der Adressleiste und fügen Sie sie in Paste your Salesforce address (recommended) ein. Jede Salesforce-Seite funktioniert, zum Beispiel die Startseite. Dies funktioniert für jede Organisation, einschließlich solcher, die die standardmäßige Anmeldeseite blockieren. Docebo zeigt dann die Adresse an, unter der sich Ihre Benutzer anmelden. Alternativ können Sie Use the standard login page (login.salesforce.com, für die Production oder Developer Edition) oder Use the sandbox login page (test.salesforce.com) auswählen. Wählen Sie Continue aus.
Geben Sie auf der Registerkarte Authorize den Consumer Key und das Consumer Secret ein (siehe Tabelle oben) und wählen Sie Authenticate aus.
Melden Sie sich im geöffneten Fenster bei Salesforce an und klicken Sie auf Allow. Salesforce meldet, dass die App unbekannt oder nicht genehmigt ist? Es kann einige Minuten dauern, bis eine neue App bereit ist. Warten Sie einige Minuten und klicken Sie erneut auf Authenticate. Sie erneuern die Authentifizierung eines bereits funktionierenden Konnektors? Lassen Sie Consumer Key und Consumer Secret leer; die gespeicherten Werte werden verwendet.
Wählen Sie auf der Registerkarte Objects die Salesforce-Objekte aus, die relevante Wissensinhalte enthalten, zum Beispiel Cases, Accounts oder Knowledge-Artikel. Verwenden Sie das Suchfeld, um ein Objekt zu finden, und wählen Sie Clear selection, um von vorne zu beginnen. Wählen Sie anschließend Save aus. Es wird nichts kopiert oder indexiert. Dadurch wird lediglich festgelegt, welche Objekte zu Wissenssammlungen hinzugefügt werden können.