Salesforce CRM-Integration

Einführung

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

• Anrufer-ID zum Kontaktnamen – 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- und Chat-Journal – Anrufe und Chats werden in der Salesforce-Kontaktkarte als CRM-Anrufdatensätze protokolliert.
• Erstellen Sie im 3CX-Client einen neuen Salesforce-Kontakt für Anrufe von neuen Nummern.
• Click-to-Call – Starten Sie Anrufe direkt aus Salesforce über 3CX mit den 3CX Click2Call-Browsererweiterungen für Google Chrome und Microsoft Edge.

Anforderungen:

• Für Ihr Salesforce-Konto muss die REST-API aktiviert sein. Hier finden Sie die Salesforce-Editionen, in denen 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 hier ein Entwicklerkonto https://www.salesforce.com/products/free-trial/developer/.
2. Klicken Sie auf „Zahnradsymbol“ > „Setup“.
3. Wählen Sie in der Seitenleiste im Abschnitt PLATTFORM-TOOLS „Apps > App Manager“ aus.
4. Klicken Sie oben rechts auf der Webseite auf die Schaltfläche „Neue verbundene App“.
5. Das Formular „Externer Client-App-Manager“ wird angezeigt.

6. Geben Sie im Bereich „Grundlegende Informationen“ einen App-Namen und eine Kontakt-E-Mail-Adresse ein.

7. Scrollen Sie nach unten zu „API (OAuth-Einstellungen aktivieren)“ und aktivieren Sie das Kontrollkästchen „OAuth aktivieren“.
8. Geben Sie im Feld „Rückruf-URL“ die URL ein, über die Sie auf Ihre 3CX-Administrationskonsole zugreifen, und fügen Sie am Ende „/api/oauth2crm“ hinzu, z. B.: „https://my-pbx.example.com/api/oauth2crm“. Erteilen Sie anschließend die Berechtigungen wie im obigen Bild gezeigt. Die Berechtigungen sind:

• Zugriff auf den Identitäts-URL-Dienst (ID, Profil, E-Mail, Adresse, Telefonnummer)
• Zugriff auf eindeutige Benutzerkennungen (OpenID)
• Vollzugriff (Vollzugriff)
• Verwaltung von Benutzerdaten über APIs (API)
• Verwaltung von Benutzerdaten über Webbrowser (Web)
• Anfragen jederzeit ausführen (Refresh-Token, Offline-Zugriff)

9. Scrollen Sie nach unten zum Abschnitt „Sicherheit“. Stellen Sie sicher, dass die Optionen „Geheimnis für Webserver-Flow erforderlich“ und „Geheimnis für Refresh-Token-Flow erforderlich“ aktiviert sind.
10. Beachten Sie außerdem, dass PKCE (Proof Key for Code Exchange) jetzt von 3CX Version 20, Update 6, unterstützt wird. Sie können den PKCE-Authentifizierungsablauf nutzen, indem Sie die Option „Proof Key for Code Exchange (PKCE)-Erweiterung für unterstützte Autorisierungsabläufe erforderlich“ aktivieren. Ist die Option deaktiviert, wird PKCE ignoriert und die Autorisierung erfolgreich durchgeführt.
11. Klicken Sie auf „Erstellen“.
12. Klicken Sie in der Liste auf „Apps > Externer Client-App-Manager > App suchen“ und anschließend auf „Richtlinien bearbeiten“.

13. Gehen Sie unter „Richtlinien“ zum Abschnitt „OAuth-Richtlinien“ und legen Sie „Zugelassene Benutzer“ auf „Alle Nutzer können sich selbst autorisieren“ fest.
14. Klicken Sie auf „Speichern“.

15. Gehen Sie unter „Einstellungen“ zum Bereich „OAuth-Einstellungen“ und klicken Sie auf „Consumer Key und Secret“. Kopieren Sie anschließend die Werte für „Consumer Key“ und „Consumer Secret“ – wir benötigen diese später im Bereich „3CX CRM-Integration“.

Schritt 2: 3CX konfigurieren

1. Melden Sie sich bei der 3CX-Verwaltungskonsole an und gehen Sie zur Registerkarte „Einstellungen“ > „CRM-Integration“.
2. Wählen Sie „SalesforceV2“ aus der Dropdown-Liste aus.
3. Geben Sie die Details ein, die Sie im vorherigen Schritt für den Consumer Key und das Consumer Secret erhalten haben, und klicken Sie auf die Schaltfläche „Autorisieren“, um den Autorisierungsprozess zu starten. Gewähren Sie Zugriff auf 3CX und das Aktualisierungstoken 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 erhält, dem Salesforce-Nutzer zuordnen.
2. Aktivieren Sie die Option „Anrufjournal aktivieren“, um externe Anrufe an das CRM zu melden, und konfigurieren Sie diese „Anrufjournal“-Parameter:

• “Call Subject” - der Betreff des Anrufs.
• “Answered Inbound Call” - Beschreibung für beantwortete 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 „Call Journaling“-Parametern Variablen verwenden können, die als
   [variable_name]
   bezeichnet werden, z. B. Die externe Nummer wird als [Code][Number][/Code] angegeben. Die verfügbaren Variablen sind hier aufgelistet.

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

• Chat Subject: Der Betreff der Chat-Sitzung.

5. Bitte beachten Sie, dass Sie in den „Chat Journaling“-Parametern Variablen verwenden können, die als
   [variable_name]
   bezeichnet werden, z. B. Die externe Nummer wird als [Code][Number][/Code] angegeben. Die verfügbaren Variablen sind hier aufgelistet.

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

1. Um eine Übereinstimmung mit Salesforce zu erhalten, 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 also auch im E164-Format bereitstellt, wird eine genaue Übereinstimmung bevorzugt. Sie können die Anrufer-ID-Neuformatierung auch verwenden, um die Nummer des Anrufers anzupassen, bevor sie an das CRM weitergeleitet wird.
3. ⚠ Wichtig: Öffnen Sie in der 3CX-Verwaltungskonsole „Erweitert“ > „Kontakte“ > „Optionen“. Stellen Sie die Abgleichsstrategie nach Möglichkeit auf „Genau übereinstimmen“ ein (E164-Format in Salesforce und dem SIP-Trunk erforderlich) oder auf „Mindestens X Zeichenanzahl abgleichen“ und legen Sie den Wert auf 7 fest.
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 und 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 (die sowohl in 3CX als auch im CRM nicht gefunden wird), aktivieren Sie das Kontrollkästchen „Kontakterstellung direkt in Ihrem CRM mithilfe des 3CX-Webclients zulassen“ und konfigurieren Sie die folgenden Parameter .
2. Die Parameter für die Kontakterstellung sind:

• Lead oder Kontakt erstellen – Die zu erstellende Entität (Lead/Kontakt).
• Neues Lead-Unternehmen – 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, beispielsweise wird die externe Nummer als [Nummer] angegeben. Die verfügbaren Variablen sind hier aufgelistet.
4. Wenn die Nummer des Anrufers keinem Kontakt zugeordnet werden kann, lässt der 3CX-Client den Nutzer den Kontakt erstellen, indem er die Details in einem Dialog ausfüllt.

📄 Hinweis: Beim Erstellen von Kontakten in Salesforce wird der im Webclient angegebene Firmenname ignoriert. Dies liegt an den Einschränkungen der Salesforce-API. Dies gilt nur für Kontakte. Der Firmenname wird beim Erstellen von Leads festgelegt.

Siehe auch

• Integrate your CRM with the 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 17. Juli 2025 aktualisiert.

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