> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.deepmask.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Übersicht

## Überblick

DeepMask stellt **8 Salesforce-Aktionen** bereit: 7 zusammengesetzte Aktionen, die Schema, Suche, Auswertungen und Schreibvorgänge serverseitig bündeln, plus eine SOQL-Abfrage als letzte Option. Jede Aktion läuft als der angemeldete Salesforce-Benutzer.

| Kategorie | Aktionen | Zweck |
| - | - | - |
| **Schema** | 1 | Objekte, Felder, Auswahllisten und Beziehungen prüfen |
| **Datensätze** | 2 | Listen von Datensätzen finden oder alles zu einem Datensatz abrufen |
| **Einblicke** | 2 | Anzahlen/Summen und ein tägliches Briefing |
| **Schreibvorgänge** | 2 | Datensätze erstellen/aktualisieren und Aktivitäten protokollieren (**kein Löschen**) |
| **Rückfallebene** | 1 | Reines Lesen per SOQL, wenn die zusammengesetzten Aktionen die Frage nicht abbilden können |

<Info>
  Eine Verbindung entspricht einer Organisation. Von DeepMask zurückgegebene Datensatz-Links (`web_url`) sind Lightning-URLs — öffnen Sie sie unverändert und bauen Sie Salesforce-URLs nicht selbst zusammen.
</Info>

<Warning>
  Schreibaktionen können Datensätze erstellen oder ändern. DeepMask zeigt Änderungen zuerst als Vorschau (`dry_run`) und verlangt `confirm` für Aktualisierungen, Upserts und das Erstellen mehrerer Datensätze. Es gibt **kein Löschen**.
</Warning>

### Schema

| Aktion | Beschreibung |
| - | - |
| [`salesforce_explore_schema`](/de/connectors/Salesforce/explore-schema) | Objekte auflisten oder Felder, Auswahllistenwerte und Beziehungen eines Objekts prüfen. Vor Schreibvorgängen verwenden. |

### Datensätze

| Aktion | Beschreibung |
| - | - |
| [`salesforce_find_records_smart`](/de/connectors/Salesforce/find-records-smart) | Primäres Finden/Auflisten — Suche, Filter, Eigentümer, Listenansichten, kürzlich angesehen. |
| [`salesforce_get_record_overview`](/de/connectors/Salesforce/get-record-overview) | Alles zu **einem** Datensatz: Schlüsselfelder, übergeordnete Datensätze, zugehörige Listen, Aktivitäten. |

### Einblicke

| Aktion | Beschreibung |
| - | - |
| [`salesforce_summarize_records`](/de/connectors/Salesforce/summarize-records) | Anzahlen und Summen, gruppiert nach einem Feld und/oder einem Zeitraum. |
| [`salesforce_my_day`](/de/connectors/Salesforce/my-day) | Offene Aufgaben des angemeldeten Benutzers, heutige Termine, bald abschließende Opportunitys, kürzlich angesehen. |

### Schreibvorgänge

| Aktion | Beschreibung |
| - | - |
| [`salesforce_save_records`](/de/connectors/Salesforce/save-records) | 1–25 Datensätze eines Objekts erstellen, aktualisieren oder upserten, mit Vorher→Nachher-Vorschau. |
| [`salesforce_log_activity`](/de/connectors/Salesforce/log-activity) | Einen Anruf, eine E-Mail, eine Aufgabe oder ein Meeting zu einem Datensatz und/oder einer Person protokollieren. |

### Rückfallebene

| Aktion | Beschreibung |
| - | - |
| [`salesforce_query`](/de/connectors/Salesforce/query) | Letzte Option. Führt ein reines `SELECT` genau wie geschrieben aus. Bevorzugen Sie zuerst die zusammengesetzten Aktionen. |

***

## Voraussetzungen

* Eine verbundene Salesforce-Organisation — siehe [Salesforce-Integration einrichten](/de/salesforce).
* Der angemeldete Salesforce-Benutzer muss **API aktiviert** haben und Zugriff auf die abgefragten Objekte besitzen.

<Info>
  DeepMask setzt kein eigenes Freigabemodell um. Ist ein Datensatz in Salesforce verborgen, ist er auch hier verborgen.
</Info>

***

## Gemeinsame Parameter

Diese erscheinen bei den meisten Aktionen.

| Parameter | Typ | Beschreibung |
| - | - | - |
| `object` | string | Objekt**bezeichnung** (`Opportunity`, `Invoices`) oder **API-Name** (`Invoice__c`). Wird in der Organisation aufgelöst. |
| `response_format` | `"markdown"` \| `"json"` | `"markdown"` (Standard) sehen Sie im Chat; `"json"` sind strukturierte Daten. |
| `limit` | Zahl | Seitengröße. Finden/Schema Standard **20** (max. 100). Query Standard **50** (max. 200). |
| `owner` | string | `"me"`, der Name eines Benutzers oder eine Benutzer-ID (`005…`). |
| `dry_run` | boolean | Nur Schreibaktionen. Prüfen und Vorschau anzeigen; nichts schreiben. |
| `confirm` | `true` | Erforderlich für Aktualisierung, Upsert und das Erstellen mehrerer Datensätze, nachdem Sie die Vorschau geprüft haben. |

***

## Typische Abläufe

### Einen Datensatz finden und dann lesen

<Steps>
  <Step title="Suchen">
    Bitten Sie DeepMask, den Account, die Opportunity oder den Fall zu finden. Dafür wird `salesforce_find_records_smart` genutzt.
  </Step>

  <Step title="Übersicht öffnen">
    Fragen Sie nach allen Details zu einem der Ergebnisse. Dafür wird `salesforce_get_record_overview` genutzt.
  </Step>

  <Step title="In Salesforce öffnen">
    Verwenden Sie den zurückgegebenen Lightning-Link (`web_url`) — bauen Sie die URL nicht selbst zusammen.
  </Step>
</Steps>

### Ein Feld sicher ändern

<Steps>
  <Step title="Schema prüfen">
    Bestätigen Sie, dass das Feld existiert und welche Auswahllistenwerte gültig sind (`salesforce_explore_schema`).
  </Step>

  <Step title="Vorschau">
    Bitten Sie DeepMask, die Änderung zuerst zu zeigen. Der Schreibvorgang läuft mit `dry_run: true` und liefert eine Vorher→Nachher-Differenz.
  </Step>

  <Step title="Bestätigen">
    Genehmigen Sie die Änderung. Aktualisierungen und Mehrfach-Erstellungen erfordern `confirm: true`.
  </Step>
</Steps>

### Tägliches Standup

Fragen Sie „Was steht heute in Salesforce für mich an?" — das ist `salesforce_my_day`. Ergänzen Sie mit „Wie viele offene Opportunitys nach Phase?" für `salesforce_summarize_records`.

***

## Paginierung

`salesforce_find_records_smart` blättert mit einem opaken `cursor` (`next_cursor` im Ergebnis). Die Schema-Auflistung nutzt `start` + `limit`. `salesforce_query` gibt nur **eine Seite** zurück — fügen Sie ein `LIMIT` oder engere Filter im SOQL hinzu; DeepMask folgt der `nextRecordsUrl` von Salesforce nicht.

***

## Sicherheit & Datenschutz

* Delegiertes OAuth — jeder Benutzer ist er selbst in Salesforce.
* Keine Löschfunktion.
* Schreibaktionen werden vom KI-Wrapper nie stillschweigend wiederholt (eine Wiederholung könnte Erstellungen duplizieren).
* Trennen Sie in DeepMask → **Konnektoren** → **Salesforce**, oder widerrufen Sie die External Client App in den Salesforce-Einstellungen.

Siehe [Salesforce-Integration einrichten](/de/salesforce) für die External Client App, Berechtigungen und Widerrufsschritte.

<Info>
  Fragen zu Datenresidenz, Compliance oder Sicherheit? Kontaktieren Sie den DeepMask-Support unter [support@deepmask.io](mailto:support@deepmask.io).
</Info>