# 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**](https://help.vario-software.de/vario-cloud-handbuch/vario-cloud-handbuch/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.

<figure><img src="/files/alZrsGFzua38rc6MEJJW" alt=""><figcaption></figcaption></figure>

## Einrichtung der 3CX-Anbindung

{% hint style="info" %}
**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**
  {% endhint %}

{% stepper %}
{% step %}
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**](https://www.3cx.com/docs/crm-integration/). Während des Einrichtungsprozesses werden die **in VARIO Cloud** bereitgestellten Zugangsdaten benötigt.
{% endstep %}

{% step %}
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.
{% endstep %}

{% step %}
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.
{% endstep %}

{% step %}
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**](https://www.3cx.com/docs/crm-template-xml-description/).

Ö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.
{% endstep %}

{% step %}
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.
{% endstep %}
{% endstepper %}

## 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:

{% stepper %}
{% step %}
Wechsle in der 3CX-Weboberfläche in den **Reiter “Testen”**.
{% endstep %}

{% step %}
Gib eine **Telefonnummer** zu einer in VARIO Cloud hinterlegte **Adresse** ein.
{% endstep %}

{% step %}
Bei einem erfolgreichen Test werden die **zugehörigen Kontaktdaten** automatisch aus der VARIO Cloud ermittelt und angezeigt.
{% endstep %}
{% endstepper %}

<figure><img src="/files/9rKI6rsTMk8lgo3HJ5P5" alt=""><figcaption></figcaption></figure>

## 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

{% hint style="info" %}
Das Protokoll ist besonders hilfreich zur Vorfallanalyse bei nicht erfolgreichen Anfragen.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.vario-software.de/vario-cloud-handbuch/apps/apps-von-vario/3cx-app.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.