Salesforce CRM-Integration

Einführung

3CX bietet Integration mit Salesforce über die 3CX-API für CRM mit den folgenden Funktionen:

• Anrufer-ID zu Kontakttitel – Eingehende Anrufe lösen eine Salesforce-Kontaktsuche aus.
• Kontaktsuche in Salesforce basierend auf Name, Nummer oder E-Mail, wenn Sie im 3CX-Webclient nach einem Namen suchen
• Anruf- & Chat-Journalisierung – Anrufe und Chats werden in der Salesforce-Kontaktkarte als CRM-Anrufeinträge protokolliert.
• Erstellen Sie einen neuen Salesforce-Kontakt aus dem 3CX-Client für Anrufe von neuen Nummern.
• Click-to-Call – Starten Sie Anrufe direkt aus Salesforce heraus über 3CX mithilfe der 3CX Click2Call Browser-Erweiterungen für Google Chrome und Microsoft Edge.

Anforderungen:

• Ihr Salesforce-Konto muss die REST-API aktiviert haben. Prüfen Sie hier, um zu sehen, in welchen Salesforce-Editionen die API verfügbar ist.
• Salesforce-Konten mit aktivierten Personenkonten werden nicht unterstützt.

Schritt 1: Salesforce konfigurieren

1. Melden Sie sich bei Ihrem Salesforce-Konto an https://login.salesforce.com/ oder erstellen Sie von hier aus ein Entwicklerkonto https://developer.salesforce.com/signup.
2. Klicken Sie auf das „Zahnrad-Symbol“ > „Setup“.
3. Wählen Sie in der Seitenleiste unter dem Abschnitt PLATFORM TOOLS „Apps > App Manager“.
4. Klicken Sie oben rechts auf der Webseite auf die Schaltfläche „New External Client App“.
5. Das Formular „External Client App Manager“ wird angezeigt.

6. Geben Sie im Bereich Basic Information einen Namen für die External Client App, eine Kontakt-E-Mail und den Distribution State ein.

7. Scrollen Sie nach unten zu API (Enable OAuth Settings) und aktivieren Sie das Kontrollkästchen „Enable OAuth“.
8. Geben Sie im Feld Callback URL die URL ein, über die Sie auf Ihre 3CX-Verwaltungskonsole zugreifen, und fügen Sie am Ende “/api/oauth2crm” hinzu, z. B.: „https://my-pbx.example.com/api/oauth2crm“. Erteilen Sie dann die Berechtigungen wie im obigen Bild gezeigt. Die Berechtigungen lauten:

• Zugriff auf den Identitäts-URL-Dienst (id, profile, email, address, phone)
• Zugriff auf eindeutige Nutzeridentifikatoren (openid)
• Vollzugriff (full)
• Nutzerdaten über APIs verwalten (api)
• Nutzerdaten über Webbrowser verwalten (web)
• Anfragen jederzeit ausführen (refresh_token, offline_access)

9. Scrollen Sie nach unten zum Abschnitt Security und stellen Sie sicher, dass die Optionen "Require Secret for Web Server Flow" und "Require Secret for Refresh Token Flow" ausgewählt sind.
10. Beachten Sie außerdem, dass PKCE (Proof Key for Code Exchange) jetzt ab 3CX Version 20, Update 6 unterstützt wird. Sie können den PKCE-Authentifizierungsablauf nutzen, indem Sie die Option "Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows" aktivieren. Wenn die Option deaktiviert ist, wird PKCE ignoriert und die Autorisierung wird erfolgreich durchgeführt.
11. Drücken Sie auf Create.
12. Klicken Sie in der Liste auf „Apps > External Client App Manager > Suchen Sie Ihre App“ und klicken Sie auf „Edit Policies“.

13. Gehen Sie unter Policies zum Abschnitt OAuth policies und setzen Sie Permitted users auf „All users can self-authorize“.
14. Klicken Sie auf Save.

15. Gehen Sie unter Settings zum Abschnitt OAuth Settings und klicken Sie auf die Schaltfläche “Consumer Key and Secret”. Kopieren Sie dann die Werte für „Consumer Key“ und „Consumer Secret“ - diese müssen später im 3CX CRM-Integrationsbereich hinzugefügt werden.

Schritt 2: 3CX konfigurieren

1. Gehen Sie zu 3CX Admin-Konsole > Integrationen > CRM.
2. Wählen Sie „SalesforceV2“ aus der Dropdown-Liste.
3. Tragen Sie die Details ein, die Sie im vorherigen Schritt für Consumer Key und Consumer Secret erhalten haben, drücken Sie die Schaltfläche „Speichern“ und dann die Schaltfläche „Autorisieren“, um den Autorisierungsprozess zu starten. Gewähren Sie 3CX Zugriff, und das Refresh Token wird unter der Schaltfläche Autorisieren angezeigt.

Schritt 3: Konfiguration des Anruf- und Chat-Journals

1. Um externe Anrufe und Chats an Salesforce zu melden, muss die für die 3CX-Nebenstelle konfigurierte E-Mail-Adresse mit der E-Mail-Adresse eines Salesforce-Nutzers übereinstimmen. Auf diese Weise kann 3CX die 3CX-Nebenstelle, die den Anruf oder Chat empfängt, dem Salesforce-Nutzer zuordnen.
2. Aktivieren Sie die Option „Anruf-Journalisierung aktivieren“, um externe Anrufe an das CRM zu melden, und konfigurieren Sie diese Parameter für die „Anruf-Journalisierung“:

• „Call Subject“ - der Betreff des Anrufs.
• „Answered Inbound Call“ - Beschreibung für angenommene eingehende Anrufe.
• „Missed Call“ - Beschreibung für verpasste Anrufe.
• „Answered Outbound Call“ - Beschreibung für angenommene ausgehende Anrufe.
• „Unanswered Outbound Call“ - Beschreibung für unbeantwortete ausgehende Anrufe.

3. Bitte beachten Sie, dass Sie in den Parametern für die „Anruf-Journalisierung“ Variablen verwenden können, die als
   [variable_name]
   angegeben werden, z. B. wird die externe Nummer als
   [Number]
   angegeben. Die verfügbaren Variablen sind hier aufgeführt.
   

4. Wenn Sie Chats an das CRM melden möchten, aktivieren Sie das Kontrollkästchen Chat-Journalisierung aktivieren und konfigurieren Sie die folgenden Parameter:

• Chat Subject: Der Betreff der Chat-Sitzung.

5. Bitte beachten Sie, dass Sie in den Parametern für die „Chat-Journalisierung“ Variablen verwenden können, die als
   [variable_name]
   angegeben werden, z. B. wird die externe Nummer als
   [Number]
   angegeben. Die verfügbaren Variablen sind hier aufgeführt.

Schritt 4: Konfigurieren Sie e164-Kontakte und Anrufer-ID

1. Um eine Übereinstimmung mit Salesforce zu erzielen, müssen die letzten 7 Ziffern der eingehenden Anrufer-ID mit den letzten 7 Ziffern eines Telefonfelds in einem CRM-Eintrag übereinstimmen, oder die vom SIP-Trunk empfangene vollständige Nummer muss vollständig mit der Telefonnummer im CRM übereinstimmen.
2. Salesforce kann die Nummern im E164-Format speichern. Wenn Ihr SIP-Trunk die Nummer des Anrufers ebenfalls im E164-Format bereitstellt, wird eine exakte Übereinstimmung bevorzugt. Sie können auch die Neuformatierung der Anrufer-ID verwenden, um die Nummer des Anrufers anzupassen, bevor sie an das CRM weitergegeben wird.
3. ⚠ Wichtig: Stellen Sie in der 3CX Admin-Konsole > System > Telefonbuch > Optionen die Abgleichsstrategie wenn möglich auf „Exakt vergleichen“ (E164-Format in Salesforce und im SIP-Trunk erforderlich) oder auf „Mindestens X Zeichen vergleichen“ und setzen Sie den Wert auf 7.
4. ⚠ Wichtig: Stellen Sie in Salesforce sicher, dass alle Nummern Ihrer Kontakte im E164-Format gespeichert sind, einschließlich des Pluszeichens (+). Dieses Pluszeichen (+) verhindert, dass Salesforce die Nummer automatisch neu formatiert, wenn Sie sich in den USA oder Kanada befinden, was dazu führen würde, dass die Kontaktsuche fehlschlägt.

Schritt 5: Konfiguration der Kontakterstellung

1. Wenn Sie neue Kontakte im CRM erstellen möchten, wenn ein Anruf von einer unbekannten Nummer eingeht (weder in 3CX noch im CRM gefunden), aktivieren Sie das Kontrollkästchen „Erstellung von Kontakten direkt in Ihrem CRM über den 3CX Web Client zulassen“ und konfigurieren Sie die unten stehenden Parameter.
2. Parameter für die Kontakterstellung sind:

• Create Lead or Contact - Die zu erstellende Entität (Lead/Kontakt).
• New Lead Company - Der Name des Unternehmens, wenn ein Lead erstellt wird.

3. Bitte beachten Sie, dass Sie in den Parametern Variablen verwenden können. Variablen werden zwischen [] angegeben, zum Beispiel wird die externe Nummer als [Number] angegeben. Die verfügbaren Variablen sind hier aufgeführt.
4. Wenn die Nummer des Anrufers keinem Kontakt zugeordnet werden kann, ermöglicht der 3CX-Client dem Nutzer, den Kontakt zu erstellen, indem er die Details in einem Dialogfeld ausfüllt.

📄 Hinweis: Beim Erstellen von Kontakten in Salesforce wird der im Webclient angegebene Firmenname ignoriert. Dies ist auf Einschränkungen der Salesforce-API zurückzuführen. Dies gilt nur für Kontakte; der Firmenname wird beim Erstellen von Leads festgelegt.

Siehe auch

• Integrieren Sie Ihr CRM mit der 3CX-API  
• Bitrix24-integration 
• ConnectWise-Integration
• Microsoft 365 Integration
• Zendesk-Integration
• Zoho-Integration
• Microsoft SQL Server, MySQL and PostgreSQL Datenbanken-Integration

Letztes Update

Dieses Dokument wurde zuletzt am 29. September 2026 aktualisiert.

https://www.3cx.de/docs/salesforce-crm-integration/