# Salesforce-Agent
Titelbild
Übersicht
  • Salesforce-Datensätze suchen und abrufen — Leads, Kontakte, Konten und Opportunities — über Blockbrain
  • Datensätze in jedem Standard- oder benutzerdefinierten Salesforce-Objekt erstellen, aktualisieren und verwalten
  • Mehrdeutige oder benutzerdefinierte Objektnamen automatisch mithilfe der Describe-API von Salesforce auflösen
  • CRM-Daten lesen und analysieren, wichtige Details extrahieren und Datensatz-Zusammenfassungen direkt in Gesprächen erhalten
  • Vertriebs-Workflows und Berichte mithilfe von Live-Salesforce-Daten automatisieren
/files/8e2d91078527b6e8c217ab72731c4498aed2fe68
Voraussetzungen
  • Führen Sie die allgemeinen Einrichtungsschritte auf der Hauptseite für KI-Agenten aus
  • Stellen Sie sicher, dass Benutzer aktive Salesforce-Konten mit den entsprechenden Objekt- und Feldberechtigungen haben
  • Prüfen Sie, ob Ihre Salesforce-Edition den API-Zugriff unterstützt (API-Zugriff ist in den Editionen Enterprise, Unlimited, Developer und Performance verfügbar)
/files/b5ff00db78231f60f0f1b0350c82cec5fdf80032
### Übersicht * Salesforce-Objekte, -Datensätze und -Felder über Blockbrain suchen und durchsuchen * Datensätze in jedem abfragbaren oder beschreibbaren Salesforce-Objekt erstellen und aktualisieren * Standard- und benutzerdefinierte Objekt-API-Namen automatisch anhand von sprachlichen Beschreibungen auflösen * CRM-Datensätze nach Status, Besitzer, Datum oder einem anderen verfügbaren Feld auflisten, filtern und analysieren * Unterstützung für sowohl Standard-Salesforce-Objekte als auch organisationsspezifische benutzerdefinierte Objekte ### Voraussetzungen * Führen Sie die allgemeinen Einrichtungsschritte auf der Hauptseite für KI-Agenten aus * Stellen Sie sicher, dass Benutzer aktive Salesforce-Konten mit API-Zugriff und den relevanten Objektberechtigungen haben * Prüfen Sie, ob Ihre Salesforce-Edition API-Zugriff umfasst (Editionen Enterprise, Unlimited, Developer oder Performance) ### Salesforce Connected App-Registrierung #### Erforderliche OAuth-Berechtigungen Fügen Sie beim Erstellen Ihrer Salesforce Connected App oder External Client App die folgenden OAuth-Berechtigungen hinzu: | Berechtigung | Typ | Beschreibung | | ---------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `offline_access` | Delegiert | Anfragen jederzeit ausführen - erforderlich, um einen dauerhaften Zugriff ohne erneute Authentifizierung aufrechtzuerhalten | | `api` | Delegiert | Benutzerdaten über Salesforce-APIs verwalten - erforderlich für alle Lese- und Schreiboperationen für Datensätze | | `id` | Delegiert | Auf den Identity-URL-Dienst zugreifen - erforderlich für Benutzerauthentifizierung und Identitätsprüfung | | `refresh_token` | Delegiert | Anfragen jederzeit ausführen - ermöglicht die Token-Aktualisierung, um Sitzungen ohne wiederholte Anmeldungen aufrechtzuerhalten | | `openid` | Delegiert | Auf eindeutige Benutzerkennungen zugreifen - erforderlich für die OpenID-Connect-Authentifizierung | | `full` | Delegiert | Voller Zugriff auf alle Daten, auf die der authentifizierte Benutzer zugreifen kann - umfasst Lese- und Schreibzugriff auf alle Objekte und Felder, die durch das Salesforce-Profil des Benutzers erlaubt sind | > **Klärung des Umfangs:** Der `api` scope bietet umfassenden Zugriff auf alle Salesforce-Objekte und -Datensätze, auf die der authentifizierte Benutzer zugreifen kann. Nur lesbare Felder werden automatisch von Schreiboperationen ausgeschlossen — der Salesforce Agent von Blockbrain prüft die Feldberechtigungen anhand der Describe-Metadaten jedes Objekts vor jedem Create- oder Update-Aufruf. **Wichtig:** Diese Scopes werden auf der Blockbrain-Seite während des Aktivierungsschritts konfiguriert. Bestätigen Sie die genaue Scopes-Liste vor der Bereitstellung mit Ihrem technischen Projektmanager von Blockbrain. #### Erstellen der **Salesforce Connected App** 1. Melden Sie sich bei **Salesforce** 2. Klicken Sie auf die **Zahnradsymbol** oben rechts in der Ecke (neben Ihrem Benutzernamen) an und wählen Sie **Setup** 3. Navigieren Sie in der linken Seitenleiste zu **Platform Tools** > **Apps** > **App Manager** 4. Klicken Sie auf **New External Client App** oben rechts in der Ecke > **Hinweis zu App-Typen:** Diese Anleitung verwendet das neuere **„External Client App“** -Framework von Salesforce. Wenn diese Schaltfläche in Ihrer Instanz nicht sichtbar ist, klicken Sie stattdessen auf **New Connected App** . Alle Parameter — Callback-URL, Scopes und Schlüssel — sind für beide Optionen identisch. 5. Füllen Sie die Basisinformationen aus: * **App-Name:** `Blockbrain` * **Kontakt-E-Mail:** Ihre E-Mail-Adresse (für Systembenachrichtigungen) 6. Aktivieren Sie das **Enable OAuth Settings** Kontrollkästchen 7. In den **Callback-URL** Feld ein, geben Sie Folgendes ein: ``` https://nango.theblockbrain.ai/oauth/callback ``` 8. Unter **Ausgewählte OAuth-Berechtigungen**, fügen Sie die folgenden Berechtigungen hinzu (wählen Sie jede links aus und klicken Sie auf **Hinzufügen**): * Auf den Identity-URL-Dienst zugreifen *(id, profile, email, address, phone)* * Benutzerdaten über APIs verwalten *(api)* * Anfragen jederzeit ausführen *(refresh\_token, offline\_access)* * Auf eindeutige Benutzerkennungen zugreifen *(openid)* * Auf die Salesforce API Platform zugreifen *(sfap\_api)* 9. Klicken Sie auf **Speichern** #### Umleitungs-URL Hinzufügen `https://nango.theblockbrain.ai/oauth/callback` als **Callback-URL** in Ihrer Salesforce Connected App- oder External Client App-Registrierung. #### Abrufen Ihrer Anmeldedaten Je nachdem, welchen App-Typ Sie erstellt haben, befinden sich die Anmeldedaten an unterschiedlichen Stellen. *(In jedem Fall wird sich ein neues Fenster oder Popup öffnen.)* **Für „External Client Apps“:** 1. Klicken Sie auf **External Client App Manager** in der linken Navigationsleiste 2. Wählen Sie die **Blockbrain** App aus der Tabelle 3. Klicken Sie auf die **Einstellungen** Registerkarte 4. Öffnen Sie die **OAuth Settings** Dropdown-Liste 5. Klicken Sie auf **Consumer Key und Secret** **Für „Connected Apps“:** 1. Klicken Sie auf der Seite des App Managers auf **Anzeigen** neben der Blockbrain-App 2. Klicken Sie auf **Consumer-Daten verwalten** oben Dann: 1. Geben Sie den **Bestätigungscode** ein, der an Ihre E-Mail-Adresse gesendet wurde 2. Kopieren Sie den **Consumer Key** und **Consumer Secret** — bewahren Sie sie sicher für den nächsten Schritt auf > **Wichtig:** Nach dem Erstellen einer neuen App in Salesforce kann es **2 bis 10 Minuten** dauern, bis sich die Änderungen über die Salesforce-Server hinweg verbreitet haben. Wenn die Verbindung während der Aktivierung fehlschlägt, warten Sie einen Moment und versuchen Sie es erneut. ### Salesforce-Agent-Konfiguration in Blockbrain
#### Details zur App-Registrierung * **Weiterleitungs-URL:** `https://nango.theblockbrain.ai/oauth/callback` * **Scopes:** * `offline_access` * `api` * `id` * `refresh_token` * `openid` * `full` #### Konfigurationsschritte 1. **Agenteneinstellungen aufrufen:** * Navigieren Sie zu Ihrem Blockbrain-Admin-Panel * Gehen Sie zu **Admin** > **Agents** > **Tools** * Suchen Sie **Salesforce-Tools** und aktivieren Sie den Schalter * Klicken Sie auf **Installieren** (oder das Zahnradsymbol für die Konfiguration) 2. **Salesforce-OAuth-Anmeldedaten eingeben:** * **Client-ID:** Fügen Sie den Consumer Key aus Salesforce ein * **Client Secret:** Fügen Sie das Consumer Secret aus Salesforce ein (verwenden Sie das Augensymbol zum Ein- und Ausblenden) 3. **OAuth-Berechtigungen konfigurieren:** * Kopieren und fügen Sie die **Scopes** aus den [#required-oauth-scopes](#required-oauth-scopes "mention") 4. **Zusätzliche Konfiguration (optional):** * Konfigurieren Sie benutzerdefinierte Schlüssel-Wert-Paare für spezifische organisatorische Anforderungen * Richten Sie bei Bedarf organisationsspezifische Einschränkungen ein 5. **Konfiguration speichern:** * Klicken Sie auf **Speichern** um alle Einstellungen zu übernehmen * Warten Sie auf die Bestätigungsmeldung ### Testen des Salesforce-Agenten #### Überprüfungsschritte **Verbindungstest:** * Verwenden Sie das integrierte Verbindungstest-Tool von Blockbrain * Überprüfen Sie den erfolgreichen OAuth-Ablauf mit Salesforce **Datensatzzugriff:** * Lassen Sie einen Testbenutzer sein Salesforce-Konto verbinden * Versuchen Sie, Datensätze für ein bekanntes Objekt aufzulisten (z. B. Konten oder Kontakte) * Überprüfen Sie den Abruf von Datensatzinhalten (z. B. das Lesen der Felder eines bestimmten Leads) **Erstellen-Funktionalität:** * Testen Sie das Erstellen eines neuen Datensatzes in einem sicheren/Testobjekt * Überprüfen Sie, dass nur lesbare Felder automatisch aus der Nutzlast ausgeschlossen werden * Bestätigen Sie, dass der neue Datensatz in Salesforce erscheint **Aktualisieren-Funktionalität:** * Testen Sie die Aktualisierung eines vorhandenen Datensatzfelds (z. B. Lead-Status oder Telefonnummer eines Kontakts) * Bestätigen Sie, dass die Änderung direkt in Salesforce übernommen wird **Objekterkennung:** * Bitten Sie Blockbrain, ein Objekt anhand eines Bezeichners zu identifizieren (z. B. „Mitgliederkonten“) * Überprüfen Sie, dass der Agent es korrekt in den Salesforce-API-Namen auflöst * Bestätigen Sie, dass der aufgelöste Name in einer nachfolgenden Operation verwendet wird ### Häufige Integrationsanwendungsfälle #### **Lead- und Kontaktverwaltung** * **Lead-Suche**: Leads nach Name, Status, Unternehmen oder Erstellungsdatum finden und filtern * **Kontakt-Suche**: Kontaktdetails für ein beliebiges Konto oder eine Person abrufen * **Datenerstellung**: Neue Leads oder Kontakte direkt aus einer Blockbrain-Konversation hinzufügen #### **Konten- und Opportunity-Verwaltung** * **Kontenrecherche**: Vollständige Kontodetails, zugehörige Kontakte und offene Opportunities abrufen * **Pipeline-Verfolgung**: Opportunities nach Phase, Abschlussdatum oder Besitzer auflisten * **Deal-Updates**: Opportunity-Phasen, Beträge oder Abschlussdaten aktualisieren, ohne den Chat zu verlassen #### **CRM-Datenanalyse** * **Datensatz-Zusammenfassungen**: Strukturierte Zusammenfassungen jedes Salesforce-Datensatzes erhalten * **Feldextraktion**: Bestimmte Feldwerte über mehrere Datensätze hinweg extrahieren * **Unterstützung für benutzerdefinierte Objekte**: organisationsspezifische benutzerdefinierte Objekte mithilfe von sprachlichen Beschreibungen abfragen und verwalten ### Fehlerbehebung #### Authentifizierungsprobleme | Symptom | Ursache | Lösung | | -------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------ | | OAuth-Authentifizierungsfehler oder „invalid\_client“ | Falsche Anmeldedaten | Überprüfen Sie, ob Consumer Key und Consumer Secret in Blockbrain korrekt eingegeben wurden | | OAuth-Ablauf wird nicht abgeschlossen | Falsche Callback-URL | Stellen Sie sicher, dass die Callback-URL exakt lautet `https://nango.theblockbrain.ai/oauth/callback` | | Token funktioniert nicht mehr | App gelöscht oder Secret rotiert | Erzeugen Sie die Anmeldedaten in Salesforce neu und aktualisieren Sie die Blockbrain-Konfiguration | | Verbindung schlägt unmittelbar nach dem Erstellen der App fehl | Verzögerung bei der Verbreitung | Warten Sie 2–10 Minuten nach dem Erstellen der Salesforce-App und versuchen Sie es dann erneut | #### **Datensatzzugriff** Fehler | Symptom | Ursache | Lösung | | ---------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | „NOT\_FOUND“ beim Zugriff auf Datensätze | Benutzer hat keinen Zugriff auf den Datensatz | Bestätigen Sie, dass der Benutzer den Datensatz direkt in Salesforce anzeigen kann | | Objekt nicht sichtbar | API-Zugriff nicht aktiviert | Verifizieren Sie, dass das Salesforce-Profil des Benutzers über die Berechtigung „API Enabled“ verfügt | | Unregelmäßige Zugriffsprobleme | Konto-Mismatch | Verifizieren Sie, dass der Benutzer mit dem richtigen Salesforce-Konto verbunden ist | #### **Feld & Schreiben** Fehler | Symptom | Ursache | Lösung | | --------------------------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | Datensatz wird mit fehlenden Feldern erstellt | Felder sind nur lesbar | Blockbrain überspringt schreibgeschützte Felder automatisch — prüfen Sie die Bearbeitbarkeit der Felder direkt in Salesforce | | Fehler „No creatable fields provided“ | Alle angegebenen Felder sind nur lesbar | Stellen Sie mindestens ein beschreibbares Feld bereit; prüfen Sie die Feldsicherheit in den Salesforce-Einstellungen | | Aktualisierung schlägt stillschweigend fehl | Einschränkung durch Feldsicherheit | Bestätigen Sie, dass das Profil des Benutzers Bearbeitungszugriff auf das Ziel-Feld hat | #### Probleme bei der Scopes-Konfiguration | Symptom | Ursache | Lösung | | ---------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Scopes werden nicht gespeichert | Eingabefehler | Fügen Sie die vollständige Scopes-Zeichenfolge exakt so ein, wie in den Konfigurationsschritten angegeben | | Fehlende Funktionen nach der Einrichtung | Unvollständige Scopes | Stellen Sie sicher, dass alle erforderlichen Scopes vorhanden sind: [#required-oauth-scopes](#required-oauth-scopes "mention") | | API-Aufrufe abgelehnt | Falsches Scopes-Format | Scopes müssen durch Kommas getrennt sein; prüfen Sie auf Tippfehler oder zusätzliche Zeichen | ### Sicherheit und Compliance #### Datenschutz * **Datensatzsicherheit**: Alle Salesforce-Daten werden gemäß den Sicherheitsrichtlinien von Blockbrain behandelt * **Feldvertraulichkeit**: Der Zugriff auf Feldebene berücksichtigt die Profilberechtigungen und Feldsicherheitsregeln von Salesforce * **Tokensicherheit**: OAuth-Tokens werden sicher gespeichert und verschlüsselt — Anmeldedaten werden Endnutzern niemals offengelegt #### Compliance-Aspekte * **DSGVO-Konformität**: Der Zugriff auf CRM-Datensätze und deren Verarbeitung erfolgt gemäß den GDPR-Anforderungen * **Datenaufbewahrung**: Keine Salesforce-Datensatzinhalte werden von Blockbrain dauerhaft gespeichert — die Daten werden in Echtzeit verarbeitet * **Audit-Logging**: Alle Aktivitäten des Salesforce-Agenten werden für Compliance-Berichte protokolliert #### Zugriffskontrolle * **Benutzerberechtigungen**: Der Agent übernimmt die Salesforce-Berechtigungen des authentifizierten Benutzers — eine Rechteausweitung ist nicht möglich * **Sicherheit auf Objektebene**: Beachtet die Objektsicherheits- und Datensatzfreigaberegeln von Salesforce * **Sicherheit auf Feldebene**: Schreibgeschützte Felder werden automatisch erkannt und von Schreiboperationen ausgeschlossen ### Nächste Schritte Nach erfolgreicher Konfiguration des Salesforce-Agenten: 1. **Benutzerschulung**: Teilen Sie den Benutzerleitfaden des Salesforce-Agenten mit den Endnutzern 2. **Berechtigungsprüfung**: Überprüfen Sie regelmäßig die Salesforce-Profile der Benutzer, um angemessene Objekt- und Feldberechtigungen sicherzustellen 3. **Integrationsüberwachung**: Überwachen Sie die OAuth-Verbindung auf fortlaufende Funktionsfähigkeit 4. **Funktionseinführung**: Ermutigen Sie Teams, Lead-Management, Pipeline-Verfolgung und benutzerdefinierte Objektfunktionen zu nutzen ### Support und Ressourcen Für Unterstützung bei der Konfiguration des Salesforce-Agenten: * **Blockbrain Support**: Wenden Sie sich für Hilfe zu bestimmten Funktionen an Ihren Customer Success Manager * **Salesforce-Dokumentation**: Verweisen Sie auf [Dokumentation zu Salesforce Connected Apps](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm) für detaillierte Informationen zu Berechtigungen * **Salesforce-Admins**: Für OAuth-App-Richtlinien auf Organisationsebene und API-Zugriff wenden Sie sich an Ihren Salesforce-Administrator --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.en.theblockbrain.ai/de/fur-administratoren/agenten/salesforce-agent.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.