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

# Salesforce

> Verbinde Salesforce mit telli, um Kontakte und Leads mit deinem Workspace zu synchronisieren und CRM-Felder auf telli-Kontakteigenschaften zuzuordnen.

<img src="https://mintcdn.com/telli/w9OJDoc0147LxawI/images/integrations/telli-salesforce-light.svg?fit=max&auto=format&n=w9OJDoc0147LxawI&q=85&s=758a8dbf316b5d6ca58594d797b5e82d" className="block dark:hidden" alt="telli + Salesforce integration" width="1200" height="360" data-path="images/integrations/telli-salesforce-light.svg" />

<img src="https://mintcdn.com/telli/w9OJDoc0147LxawI/images/integrations/telli-salesforce-dark.svg?fit=max&auto=format&n=w9OJDoc0147LxawI&q=85&s=09c424205bb63b139f06cafe4704b130" className="hidden dark:block" alt="telli + Salesforce integration" width="1200" height="360" data-path="images/integrations/telli-salesforce-dark.svg" />

## Überblick

Mit der Salesforce-Integration von telli kannst du CRM-Daten in telli übernehmen, ohne eine eigene Synchronisation aufzubauen.

Die aktuelle Version konzentriert sich auf die eingehende Synchronisation von Salesforce nach telli:

* Salesforce per OAuth direkt in der telli App verbinden
* Salesforce-`Contact`- und `Lead`-Datensätze nach telli synchronisieren
* Salesforce-Felder auf telli-Kontakteigenschaften abbilden
* Filtern, welche Salesforce-Datensätze synchronisiert werden sollen
* Agenten während Anrufen mit aktuellem CRM-Kontext versorgen

<Note>
  Die Salesforce-Integration befindet sich aktuell in der Beta-Phase. Die aktuelle Version konzentriert sich auf eingehende Synchronisation und Mapping-Verwaltung. Aktivitätsprotokolle und Write-back von telli nach Salesforce folgen in einer späteren Version.
</Note>

## Bevor du beginnst

* Zugriff auf die telli App
* Ein Salesforce-Admin, der ein Managed Package in der zu verbindenden Organisation installieren kann
* Zugriff auf die Salesforce-Organisation, die du verbinden möchtest (Produktion oder Sandbox)
* Ein Salesforce-Benutzer mit der Berechtigung **API Enabled**. Wenn deine Organisation [API Access Control](https://help.salesforce.com/articleView?id=sf.security_api_access_control_all_users.htm\&type=5) nutzt, muss der Benutzer zusätzlich für die telli Connected App autorisiert sein oder die breite Berechtigung **Use Any API Client** haben.
* Eine klare Vorstellung davon, welche telli-Kontakteigenschaften Salesforce-Daten erhalten sollen

## Salesforce in telli einrichten

<Steps>
  <Step title="Salesforce-Integration öffnen">
    Gehe in telli zu **Einstellungen** -> **Integrationen** -> **Salesforce** und wähle **Enable**, um den Einrichtungsdialog zu öffnen.
  </Step>

  <Step title="telli-Paket in Salesforce installieren">
    Wähle im Schritt **Install** die Schaltfläche **Install**, um die Salesforce-Paketinstallation in einem neuen Tab zu öffnen. Ein Salesforce-Admin muss die Installation in der Zielorganisation abschließen, bevor OAuth funktioniert. Wenn das Paket bereits installiert ist, wähle **Continue with existing installation**, um diesen Schritt zu überspringen.

    <Note>
      Das telli-Paket muss zuerst in der Zielorganisation installiert sein. Andernfalls schlägt OAuth mit dem Fehler "Cross-org OAuth flows are not supported for this external client app" fehl.
    </Note>
  </Step>

  <Step title="Salesforce-Verbindung autorisieren">
    Wähle im Schritt **Authorize** je nach Zielorganisation **Connect production** oder **Connect sandbox** und schließe den Salesforce-OAuth-Flow ab.
  </Step>

  <Step title="Zu synchronisierende Objekte auswählen">
    Wähle aus, auf welche Salesforce-Objekte telli hören soll. Aktuell unterstützt die Integration **Contact** und **Lead**.
  </Step>

  <Step title="Feldzuordnungen konfigurieren">
    Klappe jedes synchronisierte Objekt auf und ordne Salesforce-Felder den telli-Kontakteigenschaften zu, die dein Team verwendet.
  </Step>

  <Step title="Optionale Sync-Filter hinzufügen">
    Begrenze die Datensätze, die synchronisiert werden sollen, wenn nur ein Teil deiner Salesforce Contacts oder Leads in telli landen soll.
  </Step>

  <Step title="Speichern und Deployment prüfen">
    Speichere die Konfiguration und stelle sicher, dass der Integrationsstatus als verbunden und erfolgreich bereitgestellt angezeigt wird.
  </Step>
</Steps>

## So funktioniert die Synchronisation

Nachdem das telli-Paket installiert und OAuth abgeschlossen ist, liest telli das Salesforce-Schema der unterstützten Objekte ein, damit du Zuordnungen direkt in der App konfigurieren kannst.

Wenn du diese Zuordnungen speicherst, stellt telli die für die Integration erforderlichen Salesforce-Sync-Komponenten bereit. Nach der Bereitstellung werden Salesforce-`Contact`- und `Lead`-Erstellungen sowie -Aktualisierungen in Echtzeit mit telli synchronisiert und anhand deiner Mapping-Konfiguration verarbeitet. Löschungen werden ebenfalls in einem regelmäßigen täglichen Abgleich synchronisiert.

## Authentifizierung

telli verbindet sich mit Salesforce über den OAuth 2.0 Web-Server-Flow mit PKCE. Wenn du die Verbindung autorisierst, meldest du dich auf der Salesforce-Anmeldeseite an und gewährst telli Zugriff für den verbindenden Benutzer. telli hält die Sitzung automatisch aktiv — dein Salesforce-Benutzername und -Passwort werden niemals an telli übermittelt oder dort gespeichert.

## Feldzuordnungen

Mit Feldzuordnungen legst du fest, wie Salesforce-Daten telli-Kontakte befüllen sollen.

* Ordne Salesforce-Felder den telli-Eigenschaften zu, die deine Workflows bereits verwenden
* Konfiguriere Zuordnungen getrennt für `Contact` und `Lead`
* Die Salesforce-Record-ID und die Record-URL werden automatisch synchronisiert

So erhalten deine Agenten vor und während Anrufen aktuellen CRM-Kontext, ohne dass Daten manuell zwischen Systemen übertragen werden müssen.

## Sync-Filter

Du kannst zusätzliche Bedingungen definieren, um zu steuern, welche Salesforce-Datensätze an telli gesendet werden.

Standardmäßig müssen Salesforce-Kontakte einen Vornamen, Nachnamen und eine Telefonnummer haben, um nach telli synchronisiert zu werden. Danach kannst du in den Integrationseinstellungen weitere Filter hinzufügen, um die passenden Datensätze weiter einzugrenzen.

## Verbindung verwalten

Auf der Salesforce-Integrationsseite in telli kannst du:

* eine bestehende Salesforce-Organisation erneut verbinden
* die OAuth-Verbindung trennen und die Mappings für eine spätere Wiederverbindung behalten
* die Integration vollständig entfernen
* die Sync-Konfiguration erneut deployen, wenn das Deployment fehlgeschlagen oder nicht mehr synchron ist

## Fehlerbehebung

* **Sitzung abgelaufen oder Token widerrufen**: Verbinde die Integration auf der Salesforce-Seite in telli erneut.
* **REST-API-Zugriff blockiert**: Wenn telli meldet, dass Salesforce den REST-API-Zugriff blockiert, stelle sicher, dass der verbindende Salesforce-Benutzer **API Enabled** hat. Wenn deine Organisation [API Access Control](https://help.salesforce.com/articleView?id=sf.security_api_access_control_all_users.htm\&type=5) nutzt, autorisiere die telli Connected App für diesen Benutzer oder gewähre **Use Any API Client**, und verbinde die Integration anschließend erneut.
* **Fehlerhaft-konfiguriert-Badge**: Bewege den Mauszeiger über das orangefarbene **Fehlerhaft konfiguriert**-Badge, um Details zu sehen. Stelle in Salesforce-Produktionsorganisationen sicher, dass [Deploy Processes and Flows as Active](https://help.salesforce.com/s/articleView?id=platform.flow_distribute_deploy_active.htm\&type=5) aktiviert ist. Wenn diese Einstellung nicht aktiviert ist, müssen neue Flow-Deployments manuell von Admins in Salesforce aktiviert werden.
* **Deployment fehlgeschlagen oder nicht synchron**: Nutze **Redeploy** auf der Integrationsseite.
* **Datensätze werden nicht synchronisiert**: Prüfe die ausgewählten Sync-Objekte, Feldzuordnungen und Sync-Filter, nachdem Verbindung und Deployment-Status fehlerfrei sind.