3CX Salesforce Integration

3CX bindet Salesforce über Open CTI (Connector „SalesforceV2") an — eingehende Anrufe lösen ein Screen-Pop im Browser aus, Anrufaktivitäten landen automatisch am Account bzw. Kontakt.

Wofür ist das und wann brauche ich das?

Relevant für Vertriebs- und Serviceteams, die Salesforce als CRM nutzen und Anrufkontext (wer ruft an, letzte Aktivitäten, Deal-Status) direkt beim Klingeln sehen wollen, statt manuell nachzuschlagen.

Voraussetzungen

• 3CX PRO oder AI Edition
• Salesforce-Plan mit Open-CTI-Unterstützung und Admin-Zugriff für die Connected-App-Einrichtung
• 3CX Web Client auf Agenten-PCs — die CTI-Funktionen (Screen-Pop, Click-to-Dial) laufen über den Web Client, nicht über Desktop-Softphones allein
• Rufnummern in Salesforce und im SIP-Trunk konsistent im E.164-Format

Schritt-für-Schritt-Einrichtung

1. Salesforce Connected App vorbereiten: Unter Setup → App Manager eine Connected App mit OAuth-Einstellungen anlegen, Consumer Key und Consumer Secret erzeugen.
2. Permitted Users auf „All users can self-authorize" setzen, damit einzelne Agenten sich später selbst autorisieren können.
3. 3CX Admin Console → Integrations → CRM → „SalesforceV2" auswählen.
4. Consumer Key und Secret aus Salesforce eintragen, speichern.
5. „Authorize" klicken, bei Salesforce anmelden, Zugriff erlauben — der Refresh Token wird danach in 3CX angezeigt.
6. Rufnummernabgleich konfigurieren: System → Phonebook → Options → Matching-Strategie auf „Match exactly" stellen, sofern Rufnummern durchgängig im E.164-Format gepflegt sind.
7. Testanruf von einer in Salesforce hinterlegten Nummer durchführen und Screen-Pop im Web Client prüfen.

Funktionsumfang

• Screen-Pop mit Kontakt-/Account-Informationen bei eingehendem Anruf
• Click-to-Dial direkt aus Salesforce-Datensätzen
• Automatische Anrufaktivität am Account/Contact über die Salesforce-REST-API
• Anrufaufzeichnungs-Link in der Aktivität, sofern Aufzeichnung aktiviert ist

Salesforce vs. andere CRM-Integrationen

Anders als bei Pipedrive ist die Salesforce-Anbindung als klassische Open-CTI-Integration mit eigener Connected App aufgebaut — mehr Einrichtungsaufwand, dafür feingranulare Steuerung über OAuth-Scopes und die Möglichkeit, das Matching-Verhalten (exakt vs. unscharf) selbst zu bestimmen. Für Vertriebsorganisationen mit vielen ähnlichen Rufnummern (Zentralen, Durchwahlblöcke) lohnt sich die zusätzliche Konfigurationszeit, weil Fehlzuordnungen so gezielter vermieden werden können.

Rollout in mehreren Teams

Bei grösseren Vertriebsorganisationen empfiehlt sich ein gestaffelter Rollout: zunächst ein einzelnes Team mit dem Web Client und der CTI-Integration ausstatten, das Matching-Verhalten anhand echter Anrufdaten eine bis zwei Wochen beobachten, danach erst unternehmensweit ausrollen. So lassen sich Formatprobleme bei Rufnummern früh erkennen, bevor sie sich auf den gesamten Datenbestand auswirken.

Häufige Fehler und Lösungen

Screen-Pop erscheint nicht

Häufigste Ursachen: (1) Agent nutzt ein Desktop-Softphone statt des Web Clients, (2) Rufnummernformat in Salesforce weicht vom E.164-Format des SIP-Trunks ab, (3) Browser-Popup-Blocker verhindert das Öffnen des Screen-Pop-Fensters.

Autorisierung schlägt fehl

Consumer Key/Secret falsch übertragen, oder „Permitted Users" in der Connected App noch nicht auf Self-Authorize gestellt — dann kann sich der einzelne Agent nicht autorisieren.

Anrufaktivität landet am falschen Datensatz

Bei mehreren Kontakten mit ähnlichen Rufnummern (z. B. gleiche Durchwahl-Zentrale) kann das automatische Matching fehlgreifen. Matching-Strategie auf „Match exactly" mit vollständigem E.164-Format reduziert Fehlzuordnungen.

Refresh Token läuft ab / Verbindung bricht ab

OAuth-Tokens können durch Salesforce-seitige Sicherheitsrichtlinien (Session-Timeout, IP-Einschränkungen) invalidiert werden. In diesem Fall in der 3CX Admin Console erneut autorisieren.

Best Practices

• Rufnummernformat unternehmensweit auf E.164 standardisieren — reduziert Matching-Fehler in allen CRM-Integrationen, nicht nur Salesforce
• Agenten konsequent auf den Web Client für CTI-Funktionen einweisen
• Connected-App-Berechtigungen regelmässig prüfen (Security Review), besonders nach Salesforce-Admin-Wechseln

Häufig gestellte Fragen

Brauche ich für jeden Agenten einen eigenen Consumer Key?

Nein, Consumer Key und Secret gehören zur Connected App und gelten für die gesamte Organisation. Jeder Agent autorisiert sich individuell über den OAuth-Dialog, nutzt dabei aber dieselbe Connected-App-Konfiguration.

Funktioniert die Integration auch mit Salesforce Essentials?

Open-CTI-Integrationen setzen in der Regel einen Plan voraus, der API-Zugriff und Connected Apps unterstützt — das ist nicht in jedem Einstiegsplan enthalten. Vor der Einrichtung im eigenen Salesforce-Plan prüfen, ob Open CTI und API-Zugriff freigeschaltet sind.

Kann ich Screen-Pop auch für ausgehende Anrufe nutzen?

Ja, Click-to-Dial aus Salesforce-Datensätzen heraus zeigt ebenfalls den zugehörigen Kontext im Web Client, sobald der Anruf aufgebaut ist.

Weiterführend

• HubSpot CRM Integration
• Pipedrive Integration
• 3CX Web Client Anleitung