CRM-Integration in Zoho

Einführung

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

• Anrufer-ID zu Kontaktname – eingehende Anrufe lösen eine Kontaktsuche in Zoho aus.
• Kontaktsuche in Zoho 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 Zoho-Kontaktkarte als CRM-Anrufeinträge protokolliert.
• Einen neuen Zoho-Kontakt erstellen aus dem 3CX-Client für Anrufe von neuen Nummern.
• Click to Call – starten Sie Anrufe direkt aus Zoho über 3CX, unter Verwendung der 3CX Click2Call Browser-Erweiterungen für Google Chrome und Microsoft Edge.

Schritt 1: Konfiguration der Zoho-Integration

1. Melden Sie sich an und gehen Sie zur Zoho Developer Console
2. Klicken Sie auf „ADD CLIENT“.
3. Wenn Sie aufgefordert werden, einen Client-Typ auszuwählen, wählen Sie „Server-based Applications“
4. Geben Sie den Client Name ein, zum Beispiel: „3CX Integration“.
5. Geben Sie die „Homepage URL“ ein, welche die URL Ihrer 3CX Admin-Konsole ist, zum Beispiel: „https://my-pbx.example.com“.
6. Geben Sie im Feld „Authorized redirect URIs“ die URL ein, die Sie für den Zugriff auf Ihre 3CX Admin-Konsole verwenden, und fügen Sie am Ende „/api/oauth2crm“ hinzu, z. B.: „https://my-pbx.example.com/api/oauth2crm“.
7. Wenn Sie auf die Schaltfläche „Create“ klicken, generiert Zoho die Client ID und das Client Secret.
8. Notieren Sie sich die Client ID und das Client Secret, da Sie diese später benötigen.

Integrationshinweise und Voraussetzungen

• 3CX Version 20, Update 6 unterstützt jetzt PKCE (Proof Key for Code Exchange). Wenn die Telefonanlage auf die neueste Version aktualisiert wird, wird der PKCE-Authentifizierungsablauf angewendet und es ist kein weiteres Handeln Ihrerseits erforderlich.

• Für eine korrekte Integration zwischen 3CX und Zoho CRM stellen Sie sicher, dass Sie das Modul Projects in Ihrer Zoho CRM-Umgebung aktiviert haben und mindestens ein Projekt erstellt wurde.

Schritt 2: 3CX konfigurieren

1. Gehen Sie zu 3CX Admin-Konsole > Integrationen > CRM.
2. Wählen Sie Zoho aus der Dropdown-Liste.
3. Geben Sie die Server-URL für Konten und die Zoho CRM-URL ein. Der Standardwert gilt in vielen Fällen, aber Sie können beispielsweise https://accounts.zoho.eu und https://www.zoho.com/en-us/crm/ verwenden, wenn Ihr Konto in Europa ansässig ist.
4. Geben Sie die Client ID und das Client Secret aus dem vorherigen Schritt ein.
5. Drücken Sie die Schaltfläche „Speichern“ und dann die Schaltfläche „Autorisieren“. Ein neues Browser-Tab wird geöffnet, in dem Sie aufgefordert werden, dem soeben erstellten Client ID Berechtigungen zu erteilen.

6. Sie werden aufgefordert, ein Konto auszuwählen; wählen Sie Ihr normales Nutzerkonto (nicht das Entwicklerkonto). Drücken Sie die Schaltfläche „Akzeptieren“, um dem zuvor erstellten Client ID Zugriff auf die Daten Ihres Zoho-Kontos zu gewähren.

Schritt 3: Anruf- & Chat-Journalisierung konfigurieren

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

1. „Anrufbetreff“ - der Betreff des Anrufs.
2. „Angenommener eingehender Anruf“ - Beschreibung für angenommene eingehende Anrufe.
3. „Entgangener Anruf“ - Beschreibung für entgangene Anrufe.
4. „Angenommener ausgehender Anruf“ - Beschreibung für angenommene ausgehende Anrufe.
5. „Unbeantworteter ausgehender Anruf“ - Beschreibung für unbeantwortete ausgehende Anrufe.

3. Bitte beachten Sie, dass Sie Variablen in den Parametern der „Anrufjournalisierung“ verwenden können, gekennzeichnet als
   [variable_name]
   , z. B. wird die externe Nummer als
   [Number]
   angegeben. Die verfügbaren Variablen finden Sie hier.

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

1. Aufgabe oder Anruf erstellen: Mit diesem Parameter können Sie entscheiden, ob Chats im CRM als Aufgaben oder Anrufe gespeichert werden sollen.
2. Chatbetreff: Der Betreff der Chat-Sitzung.

5. Sie können Variablen in den Parametern der „Chatjournalisierung“ verwenden, gekennzeichnet als
   [variable_name]
   , z. B. wird die externe Nummer als
   [Number]
   angegeben. Die verfügbaren Variablen finden Sie hier.

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

1. Um eine Übereinstimmung mit Zoho zu erzielen, muss die eingehende Anrufer-ID identisch mit dem CRM-Eintrag sein, einschließlich aller Präfixe, da Zoho vollständige Nummernvergleiche durchführt. Die Abfrage von Zoho mit einer Teilmenge der Ziffern liefert keine Daten.
2. Damit die Zoho-Integration funktioniert, müssen Sie die Nummern in Zoho im E164-Format speichern, und Ihr SIP-Trunk muss die Nummer des Anrufers ebenfalls im E164-Format bereitstellen, damit beide übereinstimmen. Ist dies nicht der Fall, können Sie die Caller ID Neuformatierung verwenden, um die Anrufernummer anzupassen, bevor sie an das CRM übergeben wird.

3. Gehen Sie nun zu Admin > System > Telefonbuch > Optionen, stellen Sie die Abgleichsstrategie auf „Genau abgleichen“ und klicken Sie auf „OK“.

Schritt 5: Konfigurieren Sie die 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 „Kontakterstellung direkt in Ihrem CRM über den 3CX Webclient zulassen“ und konfigurieren Sie die unten stehenden Parameter.
2. Parameter für die Kontakterstellung sind:

• Lead oder Kontakt erstellen - Die zu erstellende Entität (Lead/Kontakt).

3. Wenn die Nummer des Anrufers keinem Kontakt zugeordnet werden kann, erlaubt der 3CX-Client dem Nutzer, die Details in einem Dialogfeld zu vervollständigen.

Siehe auch

• Integration Ihres CRM mit der 3CX API 
• ConnectWise-Integration
• HubSpot-Integration
• Jetpack CRM-Integration
• Microsoft 365 Integration
• Vtiger-Integration
• Microsoft SQL Server, MySQL and PostgreSQL-Datenbank-Integration

Letztes Update

Dieses Dokument wurde zuletzt am 29. September 2026 aktualisiert.

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