Salesforce Integration

Das Salesforce-Tool ermöglicht die direkte Integration mit Deinem Salesforce CRM. Frage Leads, Opportunities, Accounts und andere Objekte ab, erstelle oder aktualisiere Datensätze und greife auf angehängte Dateien zu – alles über natürliche Sprache in Deinem Assistenten.

Wann nutzen

Ideal für:

Abfragen von Leads, Opportunities, Accounts und Kontakten
Erstellen und Aktualisieren einzelner CRM-Datensätze
Suchen nach bestimmten Datensätzen mit SOQL oder SOSL
Einsehen von Dateianhängen an Salesforce-Datensätzen
Schnelle Statusübersichten zu Pipeline oder Vertriebsaktivitäten

Nicht geeignet für:

Bulk-Datenexporte oder Massenupdates (verwende Salesforce Data Loader)
Komplexe Reporting-Aufgaben (verwende Salesforce Reports & Dashboards)
Automatisierte Workflows (verwende Salesforce Flow oder Process Builder)

Voraussetzungen

Salesforce-Account mit API-Zugang (Professional, Enterprise oder Unlimited Edition)
API-Berechtigungen für den verbundenen Benutzer
OAuth-Verbindung in meinGPT eingerichtet

Einrichtung

Öffne den Assistenten-Editor und navigiere zu den Tool-Einstellungen

Wähle "Salesforce" aus der Tool-Liste

Klicke auf "Verbinden" und melde Dich mit Deinem Salesforce-Account an

Bestätige die angeforderten Berechtigungen (API-Zugriff)

Hauptfunktionen

Schema-Erkennung

salesforce_list_objects: Listet alle verfügbaren Salesforce-Objekte auf
salesforce_describe_object: Zeigt Felder und Metadaten eines Objekts

Abfragen

salesforce_run_soql_query: Führt SOQL-Abfragen aus (z.B. SELECT Name FROM Lead WHERE Status = 'Open')
salesforce_run_sosl_search: Führt Volltextsuche über mehrere Objekte aus
salesforce_query_more: Ruft weitere Ergebnisse bei paginierten Abfragen ab

Datensatzverwaltung

salesforce_get_record: Liest einen einzelnen Datensatz
salesforce_create_record: Erstellt einen neuen Datensatz
salesforce_update_record: Aktualisiert einen bestehenden Datensatz
salesforce_delete_record: Löscht einen Datensatz (erfordert Bestätigung)

Dateizugriff

salesforce_list_record_files: Listet Dateien und Anhänge eines Datensatzes
salesforce_ingest_record_files: Lädt Dateien in den Chat-Kontext

Erweiterte Operationen

salesforce_tooling_execute: Tooling-API-Aufrufe (für Entwickler)
salesforce_apex_execute: Apex-REST-Aufrufe
salesforce_rest_execute: Generische REST-Aufrufe

Verwendungsbeispiele

Offene Leads abfragen

Zeige mir alle offenen Leads aus den letzten 30 Tagen mit Unternehmen und Kontaktdaten

Opportunity-Pipeline prüfen

Wie viele Opportunities sind diesen Monat im Stage "Negotiation" und was ist deren Gesamtwert?

Neuen Kontakt erstellen

Erstelle einen neuen Kontakt in Salesforce:
- Vorname: Anna
- Nachname: Müller
- E-Mail: anna.mueller@beispiel.de
- Account: Beispiel GmbH

Datensatzdetails abrufen

Zeige mir alle Details zum Account "Acme Corporation" inklusive verknüpfter Kontakte

Berechtigungen und Scope

Lesezugriff (Standard)

Folgende Aktionen benötigen nur Leseberechtigung:

Objekte auflisten und beschreiben
SOQL/SOSL-Abfragen ausführen
Datensätze und Dateien lesen

Schreibzugriff

Diese Aktionen ändern Daten in Salesforce:

salesforce_create_record – Neue Datensätze erstellen
salesforce_update_record – Bestehende Datensätze aktualisieren
salesforce_delete_record – Datensätze löschen (als "dangerous" markiert)

Zugängliche Objekte

Das Tool greift auf alle Objekte zu, für die der verbundene Benutzer Berechtigung hat:

Standard-Objekte: Account, Contact, Lead, Opportunity, Case, Task, Event
Custom-Objekte: Alle benutzerdefinierten Objekte (erkennbar am __c Suffix)
Setup-Objekte: Über die Tooling-API (für Administratoren)

Sicherheitsempfehlungen

Minimale Rechte: Verwende einen Salesforce-Benutzer mit eingeschränkten Profil-Berechtigungen
Schreibaktionen bestätigen: Bei kritischen Operationen fragt das System nach Bestätigung
Audit-Trail: Alle Änderungen werden im Salesforce-Audit-Log erfasst

Fehlerbehebung

Häufige Fehler

INVALID_FIELD oder INVALID_TYPE

Das angegebene Feld oder Objekt existiert nicht oder ist falsch geschrieben
Lösung: Nutze salesforce_describe_object, um korrekte Feldnamen zu ermitteln

INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY

Der Benutzer hat keine Berechtigung für das referenzierte Objekt
Lösung: Prüfe die Profil- und Freigabeberechtigungen in Salesforce

REQUEST_LIMIT_EXCEEDED

API-Limit erreicht (täglich oder gleichzeitige Requests)
Lösung: Warte oder kontaktiere Deinen Salesforce-Administrator
Tipp: Verwende LIMIT in SOQL-Abfragen, um Ressourcen zu schonen