Salesforce-Agent

Ü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

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)

Ü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:

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.

1. Füllen Sie die Basisinformationen aus:

   • App-Name: Blockbrain

   • Kontakt-E-Mail: Ihre E-Mail-Adresse (für Systembenachrichtigungen)

2. Aktivieren Sie das Enable OAuth Settings Kontrollkästchen

3. In den Callback-URL Feld ein, geben Sie Folgendes ein:

4. 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)

5. 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 Salesforce-Agent

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

Datensatzzugriff Fehler

Feld & Schreiben Fehler

Probleme bei der Scopes-Konfiguration

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 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