In dieser Anleitung erfahren Sie, wie Sie mithilfe der Erweiterung eine Starface-Telefonanlage oder eine Sipgate-Telefonanlage mit 1CRM verbinden.
CRM CTI-Erweiterung installieren
Die 1CRM CTI-Erweiterung ist eine Erweiterung, die direkt über die Administrationsoberfläche von 1CRM installiert werden kann. Die Erweiterung verbindet das CRM-System mit einer Starface- oder Sipgate-Telefonanlage und integriert Anzeige und Tracking für eingehende und ausgehende Anrufe in das CRM-System. Da der CRM-Server direkt mit der Telefonanlage kommuniziert, ist auf dem Endgerät (PC/ Mac/ Tablet) keine Dritt-Software erforderlich.
Voraussetzungen
Zielgruppen:
Admin
Produkte: CRM CTI-Integration
Anleitungen: CRM-Erweiterungen installieren und aktivieren
Produkte: CRM CTI-Integration
Anleitungen: CRM-Erweiterungen installieren und aktivieren
Achtung
- Funktioniert erst ab der 1CRM 7.7 Version
- php5-mycrypt-Modul muss auf dem CRM-Server aktiviert sein. Das wird leider aktuell noch nicht bei der Installation überprüft. Sollte dieses Modul nicht aktiviert sein, erhalten Sie bei der Konfiguration der Benutzerdaten einen PHP-Fehler 500.
- Zwischen dem 1CRM-Server und der Starface-Anlage muss eine Netzwerkverbindung bestehen. Beide Server müssen sich gegenseitig erreichen können.
- Die Integration funktioniert aktuell nicht mit aktivierter AD/LDAP Authentifizierung in der Starface Anlage.
Inhaltsverzeichnis
1CRM mit Starface verbinden
Achtung:
- Funktioniert erst ab der 1CRM 7.7 Version
- php5-mycrypt-Modul muss auf dem CRM-Server aktiviert sein. Das wird leider aktuell noch nicht bei der Installation überprüft. Sollte dieses Modul nicht aktiviert sein, erhalten Sie bei der Konfiguration der Benutzerdaten einen PHP-Fehler 500.
- Zwischen dem 1CRM-Server und der Starface-Anlage muss eine Netzwerkverbindung bestehen. Beide Server müssen sich gegenseitig erreichen können.
- Die Integration funktioniert aktuell nicht mit aktivierter AD/LDAP Authentifizierung in der Starface-Anlage.
Benutzerübergreifende CTI-Einstellungen für Starface
Administration > System Einstellungen:
CTI Settings
1 CTI-Einstellungen öffnen
Wechseln Sie zu den CTI Settings unter Administration > System Einstellungen.
2 Verbindungsdaten eingeben
Tragen Sie hier jeweils die Hostnamen (oder IP-Adressen) des CRM-Systems und der Starface-Anlage ein (ohne https:// oder Pfad). Soll die Kommunikation untereinander per SSL erfolgen, müssen Sie CTI HTTPS und/oder CRM HTTPS aktivieren und den jeweiligen Port anpassen. Der Standard-Port für SSL ist 443.
3 CTI Dial Out einstellen
In den regionalen Systemeinstellungen muss unter Telefonie noch der Punkt Telefonieintegration auf CTI Dial Out gestellt werden, um ausgehendes Wählen beim Klick auf eine Telefonnummer über die Starface Anlage zu ermöglichen.
CTI-Einstellungen auf Benutzerseite für Starface
In den Benutzereinstellungen gibt es ebenso einen neuen Bereich um die Zugangsdaten der einzelnen Benutzer zur Starface-Anlage zu hinterlegen:
Sollten Sie beim Speichern der Daten einen Fehler erhalten, prüfen Sie bitte zuerst, ob das MCrypt-PHP Modul geladen ist (siehe Voraussetzungen). Dieses wird verwendet, um die Passwörter symmetrisch verschlüsselt in der Datenbank abzulegen.
Troubleshooting
1 CRM-Anfragen im Browser überprüfen
Überprüfen Sie, ob Ihr Browser im aktiven CRM-Tab regelmäßig Anfragen an das CRM-System schickt. Dazu machen Sie z. B. in Chrome einen Rechtsklick und dann Element untersuchen > Netzwerk.
Sie sehen hier regelmäßige Aufrufe von checkForNewState.php und minütliche Re-Logins über starfaceLoginProbe.php.
2 starfaceLoginprobe = OK ?
Überprüfen Sie mit einem Klick, ob der Aufruf von starfaceLoginprobe OK oder OK New Login zurückgibt.
Tipp: Browser Cache löschen
Sollten die Aufrufe auf die beiden Scripte nicht erfolgen, leeren Sie bitte Ihren Browser Cache, oder erzwingen einen vollständigen Reload der Seite durch Drücken von „Strg + Shift + R“
checkforNewStates gibt normalerweise einen leeren JSON-Array zurück ([ ]), bei einem Anruf Informationen darüber.
3 Einstellungen überprüfen
Überprüfen Sie alle Einstellungen sowie die eingetragenen Hosts, Ports und Pfade mit Curl in der Konsole des CRM-Servers und der Starface-Anlage.
Tipp: Unterstützung kostenpflichtig anfordern
Natürlich unterstützen wir Sie gerne bei der Fehlersuche nach Aufwand. Da die Fehlerursache in 99 % der Fälle nicht im Plugin selbst, sondern in der Netzwerk-Konfiguration liegt, ist in den Lizenzgebühren der CTI-Erweiterung kein kostenloser Installationssupport enthalten.
1CRM mit Sipgate verbinden
Benutzerübergreifende CTI-Einstellungen für Sipgate
Administration > System Einstellungen:
CTI Settings
1 CTI-Adapter wählen und Sipgate-Kundennummer eintragen
Gehen Sie unter Administration auf System Einstellungen > CTI Settings. Wählen Sie im Feld CTI Adapter die Option sipgate.io. Im Feld Sipgate Kundennummer tragen Sie Ihre Kundennummer ein:
2 Weitere Einstellungen treffen
Über das Feld Internal Digits steuern Sie die Anzahl der Ziffern für die interne Durchwahl. Wenn Sie die Option Anruf Anzeigetest aktivieren, wird nach dem Speichern der Einstellungen das CTI-Popup für eingehende Anrufe angezeigt. Wenn Sie die Option CTI Debugmodus aktivieren, werden mehr Informationen in die Logdatei geschrieben.
3 Speichern
CTI-Einstellungen auf Benutzerseite für Sipgate
Benutzer > [Benutzer wählen] > Registerkarte: Allgemeines:
CTI Settings
Für die Benutzereinstellungen in 1CRM brauchen Sie ein Token aus Sipgate. Für jeden Benutzer müssen Sie ein individuelles Token in Sipgate erzeugen.
1 Token in Sipgate erzeugen
Öffnen Sie Sipgate und erzeugen Sie unter Meine Telefonie > Benutzereinstellungen> Personal-Access-Token > Verwalten ein persönliches Token mit den folgenden Scopes:
devices:read
Sessions:calls:write
authorization:oauth:clients:read
Mehr zu Tokens erfahren Sie in der offiziellen Sipgate-API-Dokumentation unter Personal Access Token (Anleitung ist nur auf Englisch verfügbar).
2 Token in 1CRM hinterlegen
Öffnen Sie den betreffenden Benutzer in 1CRM. Unter Allgemeines > CTI Settings tragen Sie die Token-ID ins Feld Sipgate Login-Name ein. Als CTI Password fügen Sie das Token ein. Die CTI User ID lassen Sie zunächst leer:
3 Speichern
Klicken Sie auf Sichern. Wenn der Login-Name und das Passwort korrekt sind, wird die CTI User ID nach dem Speichern automatisch abgerufen und befüllt. Außerdem erhalten Sie unter Sipgate Device eine Liste mit allen aktiven Sipgate-Telefonen und Sie können das Standardgerät für die ausgehenden Anrufe wählen.
Einstellungen in Sipgate treffen
In Sipgate müssen Sie in den sipgate.io-Einstellungen die URL für ausgehende und eingehende Calls angeben. Die korrekte Adresse lautet:
https://{1CRM-Adresse}/cti/lookup.php.
© visual4 GmbH
