Zoho CRM-Integration

Einführung

Zoho-Fenster

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

Anrufer-ID zu Kontaktname – Eingehende Anrufe lösen eine Zoho-Kontaktsuche aus.
Kontaktsuche in Zoho basierend auf Name, Nummer oder E-Mail, wenn Sie im 3CX-Webclient nach einem Namen suchen
Anruf- und Chat-Journalling – Anrufe und Chats werden in der Zoho-Kontaktkarte als CRM-Anrufdatensätze protokolliert.
Erstellen eines neuen Zoho-Kontakts über den 3CX-Client für Anrufe von neuen Nummern.
Click-to-Call – Starten Sie Anrufe direkt von Zoho über 3CX und nutzen Sie die 3CX Click2Call-Browsererweiterungen für Google Chrome und Microsoft Edge.

Melden Sie sich an und gehen Sie zu https://accounts.zoho.com/developerconsole
Klicken Sie auf „CLIENT HINZUFÜGEN“.
Wenn Sie aufgefordert werden, einen Clienttyp auszuwählen, wählen Sie „Serverbasierte Anwendungen“.
Geben Sie den Clientnamen ein, zum Beispiel: „3CX-Integration“.
Geben Sie die „Homepage-URL“ ein, die die URL Ihrer 3CX-Konsole ist, zum Beispiel: „https://my-pbx.example.com“.
Geben Sie im Feld „Autorisierte Redirect-URIs“ die URL ein, die Sie für den Zugriff auf Ihre 3CX-Verwaltungskonsole verwenden, und fügen Sie am Ende „/api/oauth2crm“ hinzu, z. B.: „https://my-pbx.example.com/api/oauth2crm“.
Wenn Sie auf die Schaltfläche „Erstellen“ klicken, generiert Zoho die Client-ID und das Client-Geheimnis.
Notieren Sie sich die Client-ID und das Client-Geheimnis, da Sie diese später benötigen werden.

Konfiguration

3CX-Konfiguration

Melden Sie sich bei der 3CX-Verwaltungskonsole an > Einstellungen > CRM-Integration > Registerkarte Serverseite.
Wählen Sie Zoho aus der Dropdown-Liste aus.
Geben Sie die Accounts-Server-URL und die Zoho CRM-URL ein. In vielen Fällen gilt der Standardwert, Sie können jedoch beispielsweise https://accounts.zoho.eu und https://www.zoho.com/crm/ verwenden, wenn Ihr Konto in Europa ist.
Geben Sie die Client-ID und das Client-Geheimnis aus dem vorherigen Schritt ein.
Klicken Sie auf die Schaltfläche „Autorisieren“. Ein neuer Browser-Tab wird geöffnet, in dem Sie aufgefordert werden, Berechtigungen für die soeben erstellte Client-ID zu erteilen.

Konfiguration

Sie werden aufgefordert, ein Konto auszuwählen. Wählen Sie Ihr normales Nutzerkonto (nicht das Entwicklerkonto). Klicken Sie auf die Schaltfläche „Akzeptieren“, um der zuvor erstellten Client-ID Zugriff auf die Daten Ihres Zoho-Kontos zu gewähren.

Call Journaling

Um externe Anrufe und Chats an Zoho zu melden, muss die für die 3CX-Erweiterung 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 empfängt, dem Zoho-Nutzer zuordnen.
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.

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.
Wenn Sie Chats an das CRM melden möchten, aktivieren Sie das Kontrollkästchen „Chat-Journaling aktivieren“ und konfigurieren Sie die folgenden Parameter:

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

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.

Um eine Übereinstimmung mit Zoho zu erhalten, muss die eingehende Anrufer-ID mit dem CRM-Eintrag identisch sein, einschließlich etwaiger Präfixe, da Zoho Ganzzahlsuchen durchführt. Die Abfrage von Zoho mithilfe einer Teilmenge der Ziffern gibt keine Daten zurück.
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 mithilfe der Neuformatierung der Anrufer-ID die Nummer des Anrufers vor der Weitergabe an das CRM anpassen.

Suchstrategie

Gehen Sie nun zu „Erweitert“ > „Kontakte“ > „Optionen“, stellen Sie die Matching-Strategie auf „Genau übereinstimmen“ und klicken Sie auf „OK“.

Kontakterstellung

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.
Die Parameter für die Kontakterstellung sind: