3CX App
Mit der 3CX App kannst Du eine direkte Anbindung zwischen Deiner VARIO Cloud und Deiner 3CX-Telefonanlage herstellen. Durch diese Integration können eingehende Anrufe automatisch mit den in VARIO Cloud hinterlegten Adressen abgeglichen werden. Stimmen die Kontaktdaten eines Anrufs, beispielsweise die Telefonnummer, mit einer in den Kontaktinformationen eines Ansprechpartners oder einer Adresse gespeicherten Nummer überein, wird automatisch die entsprechende Adresse oder Ansprechpartner in VARIO Cloud geöffnet. Dabei werden die Ansprechpartner vor den Adressen bzw. Zusatzadressen priorisiert. Dadurch kannst Du während eines Anrufs sofort auf die relevanten Stammdaten zugreifen und die Kommunikation effizienter gestalten.
Eine Anleitung zur Installation und Deinstallation von Apps, sowie Informationen zu Integrationen und Berechtigungen erhältst Du auf unserer Handbuchseite zum Bereich System/Apps.
Benötigte Daten für die Anbindung
Nachdem Du die 3CX-App installiert hast, stehen Dir unter dem Menüpunkt System/Apps im Bereich “URL” die Daten zur Verfügung, die für die Verbindung mit der 3CX-Anwendung benötigt werden:
Lookup-URLs
Die Lookup-URLs werden automatisch bei der Installation der 3CX-App erstellt. Diese URLs werden von der 3CX-Anwendung verwendet, um Informationen aus VARIO Cloud abzurufen. Eine manuelle Bearbeitung dieser URLs ist nicht möglich.
API Keys
Die API Keys werden für die Authentifizierung der Schnittstelle in 3CX benötigt. Sie stellen sicher, dass nur autorisierte Anwendungen auf die Schnittstelle zugreifen können und laufen nach einem Jahr ab. Über den Reiter “Öffentliche Zugänge” kannst Du den API Key für einen bestimmten Zeitraum freigeben. Nach der Erstellung kann der Key nicht erneut angezeigt oder kopiert werden. Es empfiehlt sich daher, den API Key direkt nach der Erstellung an einem sicheren zweiten Ort zu speichern.
Einrichtung der 3CX-Anbindung
Voraussetzungen für die 3CX-Anbindung
Installierte 3CX-Telefonanlage
Installierte 3CX-App in VARIO Cloud über das Admin-Center
Administrator-Rechte innerhalb der 3CX-Anwendung
Die eigentliche Anbindung zwischen VARIO Cloud und 3CX erfolgt über den CRM Integration Wizard in der 3CX-Anwendung. Folge dabei den Schritten der offiziellen 3CX-Anleitung. Während des Einrichtungsprozesses werden die in VARIO Cloud bereitgestellten Zugangsdaten benötigt.
Im dritten Schritt des CRM Integration Wizard wird die Authentifizierungsmethode festgelegt. Wähle hier die Authentifizierungsmethode “Basic” aus und trage den zuvor erzeugten API Key aus VARIO Cloud ein. Dieser dient zur Authentifizierung der Verbindung zwischen 3CX und VARIO Cloud.
Im vierten Schritt der Einrichtung werden die Lookup-URLs verwendet, um 3CX mit Deiner VARIO Cloud zu verbinden. Über diese URLs kann 3CX bei eingehenden Anrufen automatisch nach passenden Datensätzen suchen. Du kannst dabei entscheiden, nach welchen Informationen gesucht werden soll: ob nach Telefonnummern und/oder E-Mails. Je nach gewünschter Suche trägst Du die entsprechende Lookup-URL in die dafür vorgesehenen Felder ein. Die Endung der jeweiligen URL zeigt an, für welche Art der Suche sie vorgesehen ist.
Nachdem die Integration im CRM Integration Wizard eingerichtet wurde, musst Du zusätzlich eine XML-Datei in 3CX hochladen. Diese enthält die Konfiguration, die 3CX benötigt, um mit VARIO Cloud zu kommunizieren. Genauere Informationen zum Inhalt der XML-Datei findest ebenfalls auf der offiziellen Webseite von 3CX.
Öffne dazu als Administrator in der 3CX-Anwendung den Menüpunkt Adminbereich/Integrationen/CRM und klicke anschließend auf den Button “Vorlage hinzufügen” um die folgende XML-Datei hochzuladen.
Nachdem Du die XML-Datei in 3CX hochgeladen hast, werden drei Felder angezeigt, die für die Verbindung mit VARIO Cloud konfiguriert werden müssen. Trage dort die folgenden Angaben ein:
Bearer Token – Trage hier eine der Lookup-URLs ein, die in VARIO Cloud unter System/Apps/Stammdaten generiert wurden.
Frontend Tenant URL – Trage hier die URL Deiner VARIO Cloud ein, z. B. https://qs-team.vario.cloud. In diesem Beispiel gilt qs-team als Subdomain.
API Base URL – Trage hier den Link https://app-3cx-{subdomain}.vario.cloud ein. Auch hier wird die Subdomain Deiner Installation eingesetzt.
Verbindung testen
In 3CX hast Du auch die Möglichkeit die erstellte Anbindung zu VARIO Cloud zu testen. Um den Test durchzuführen, gehe folgendermaßen vor:
Wechsle in der 3CX-Weboberfläche in den Reiter “Testen”.
Gib eine Telefonnummer zu einer in VARIO Cloud hinterlegte Adresse ein.
Bei einem erfolgreichen Test werden die zugehörigen Kontaktdaten automatisch aus der VARIO Cloud ermittelt und angezeigt.
CRM-Protokoll
Im Reiter “CRM Protokoll” von 3CX findest Du:
Zeitpunkt der Authentifizierung
Austausch der Tokens (Refresh und Access Token)
Ergebnis der Anfrage mit dem entsprechenden JSON-Datensatz
Das Protokoll ist besonders hilfreich zur Vorfallanalyse bei nicht erfolgreichen Anfragen.
Zuletzt aktualisiert
War das hilfreich?