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

# Salesforce

> Wave-Kontakte als Leads oder Contacts in Salesforce synchronisieren

<Info>
  Verfügbar in den Tarifen **Pro**, **Teams** und **Enterprise**.
</Info>

Die Salesforce-Integration synchronisiert Wave-Kontakte als Leads oder Contacts in Salesforce – Ihre Wahl bei der Einrichtung. Wave verwendet ein benutzerdefiniertes externes ID-Feld für Upserts, sodass keine Duplikate entstehen, auch wenn ein Datensatz bereits vorhanden ist. Sowohl Produktions- als auch Sandbox-Salesforce-Umgebungen werden unterstützt.

## Verbindung herstellen

<Steps>
  <Step title="Integration öffnen">
    Gehen Sie zu **Integrationen → Salesforce**.
  </Step>

  <Step title="Datensatztyp wählen">
    Wählen Sie, ob Kontakte als **Leads** oder **Contacts** synchronisiert werden sollen.
  </Step>

  <Step title="Auto-Sync aktivieren (optional)">
    Aktivieren Sie **Auto-Sync**, um alle vorhandenen Wave-Kontakte sofort zu importieren.
  </Step>

  <Step title="Salesforce verbinden">
    Klicken Sie auf **Verbinden** und melden Sie sich bei Ihrem Salesforce-Konto an.
  </Step>
</Steps>

Wave fordert Offline-Zugriff (um die Verbindung ohne wiederholte Anmeldungen aktiv zu halten) sowie Lese-/Schreibzugriff an, um Datensätze in Salesforce zu erstellen und zu aktualisieren.

## Was synchronisiert wird

| Wave-Feld                 | Salesforce-Feld                    |       Leads      | Contacts |
| ------------------------- | ---------------------------------- | :--------------: | :------: |
| Vorname                   | `FirstName`                        |        Ja        |    Ja    |
| Nachname                  | `LastName`                         |        Ja        |    Ja    |
| Primäre E-Mail            | `Email`                            |        Ja        |    Ja    |
| Primäres Telefon          | `Phone`                            |        Ja        |    Ja    |
| Berufsbezeichnung         | `Title`                            |        Ja        |    Ja    |
| Unternehmen               | `Company`                          | Ja (Pflichtfeld) |     -    |
| Kontaktnotiz              | `Description`                      |        Ja        |    Ja    |
| Lead-Quelle               | `LeadSource` = "Wave Connect"      |        Ja        |     -    |
| Zugewiesenes Teammitglied | `OwnerId` (per E-Mail abgeglichen) |        Ja        |    Ja    |

**Synchronisierungsrichtung**: Wave → Salesforce (nur ausgehend)

**Wann synchronisiert**: In Echtzeit bei Erstellung, Aktualisierung oder Löschung von Kontakten

## Funktionen

* **Leads oder Contacts**: Wählen Sie den Salesforce-Datensatztyp, der zu Ihrem Workflow passt.
* **Sandbox-Unterstützung**: Verbindung mit einer Salesforce-Sandbox-Umgebung zum Testen.
* **Auto-Sync bei Verbindung**: Alle vorhandenen Wave-Kontakte beim ersten Verbinden importieren.
* **Deduplizierung**: Ein benutzerdefiniertes externes ID-Feld (`WaveConnectId__c`) wird automatisch erstellt und für Upserts verwendet, sodass eine erneute Synchronisierung keine Duplikate erstellt.
* **Inhaberzuweisung**: Kontakte werden dem Salesforce-Benutzer zugewiesen, dessen E-Mail dem Wave-Teammitglied entspricht.

## Manuelles Hinzufügen des externen ID-Felds

Wave erstellt das externe ID-Feld `WaveConnectId__c` normalerweise automatisch bei der Verbindung. Dieser Schritt ist nur erforderlich, wenn Sie die Verbindung **ohne ein Salesforce-Administratorkonto** herstellen, da die Erstellung eines benutzerdefinierten Felds Administratorrechte erfordert. Lassen Sie in diesem Fall Ihren Salesforce-Administrator das Feld manuell als Sicherungslösung hinzufügen.

<Steps>
  <Step title="Lead-Objekt öffnen">
    Öffnen Sie in der Salesforce-**Einrichtung** den **Objekt-Manager** und wählen Sie das **Lead**-Objekt.
  </Step>

  <Step title="Feld prüfen">
    Überprüfen Sie unter **Felder & Beziehungen**, ob `WaveConnectId__c` bereits vorhanden ist.
  </Step>

  <Step title="Feld erstellen">
    Falls es nicht vorhanden ist, klicken Sie auf **Neu**, wählen Sie **Text** als Feldtyp und benennen Sie es so, dass der API-Name `WaveConnectId__c` lautet.
  </Step>

  <Step title="Feldebenensicherheit festlegen">
    Bestätigen Sie, dass **Standard-Benutzer** Lese-/Schreibzugriff auf das Feld hat.
  </Step>

  <Step title="Zu Seitenlayouts hinzufügen und speichern">
    Fügen Sie das Feld den relevanten Seitenlayouts hinzu und speichern Sie.
  </Step>
</Steps>

<Note>
  Wenn das Feld bereits vorhanden ist, öffnen Sie es und wählen Sie **Feldebenensicherheit festlegen**, um zu bestätigen, dass **Standard-Benutzer** Lese-/Schreibzugriff hat. Ausführliche Informationen finden Sie im [Salesforce-Einrichtungsleitfaden](https://support.wavecnct.com/en/articles/10492839-salesforce).
</Note>

## Einschränkungen & Anforderungen

* Das benutzerdefinierte Feld `WaveConnectId__c` wird automatisch in Ihrem Salesforce-Konto erstellt. Löschen oder umbenennen Sie es nicht. Es wird zur Deduplizierung verwendet.
* Bei Leads ist das Feld `Company` von Salesforce Pflichtfeld. Wenn ein Wave-Kontakt kein Unternehmen hat, wird standardmäßig `N/A` verwendet.
* Wenn Salesforce über seine Duplikatregeln ein Duplikat erkennt, überschreibt Wave die Regel und speichert den Datensatz.
* Der Inhaberabgleich erfolgt per E-Mail. Wird kein passender Salesforce-Benutzer gefunden, wird der Kontakt ohne Inhaber gespeichert.

## Verbindung trennen

Gehen Sie zu **Integrationen → Salesforce** und klicken Sie auf **Trennen**. Dies entfernt die Integration und widerruft den Zugriff von Wave. Bereits mit Salesforce synchronisierte Datensätze werden nicht gelöscht.