> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/vario-cloud-tapi-connector.md).

# VARIO Cloud TAPI Connector

Verbinde Deine TAPI-Telefonanlage mit VARIO Cloud. Richte den Windows-Connector ein, wähle per Telefonnummer und nutze Anrufbenachrichtigungen.

Der **VARIO Cloud TAPI Connector** verbindet Dein Telefon mit VARIO Cloud. Die Windows-Anwendung läuft im Infobereich der Taskleiste und zeigt bei Anrufen Informationen zu Deinem Gesprächspartner an, zum Beispiel Name, Firma und Bild. Über die Benachrichtigung kannst Du passende Seiten in VARIO Cloud öffnen und, sofern Deine Telefonanlage es unterstützt, Anrufe annehmen oder beenden. Ein Klick auf einen **Telefonnummern-Link (`tel:`)** im Browser oder in einer anderen Anwendung wählt die Nummer über Dein Telefon.

Für die Verbindung arbeiten zwei Komponenten zusammen: Der **Connector auf Deinem Windows-PC** erkennt und steuert Anrufe über den TAPI-Treiber. Die **zugehörige Cloud-App in Deinem VARIO-Cloud-Mandanten** liefert die Anruferdaten und die eingerichteten Schaltflächen. Diese Anleitung beschreibt die Einrichtung und Bedienung des Windows-Connectors.

## Voraussetzungen

* Windows 11 und der VARIO Cloud TAPI Connector auf Deinem PC.
* Ein **TAPI-Treiber (TSP)** Deiner Telefonanlage, der Deine Nebenstelle als TAPI-Leitung bereitstellt. Den Treiber erhältst Du vom Anbieter der Telefonanlage. Je nach Anlage muss auch deren Software gestartet und angemeldet sein.
* Ein VARIO-Cloud-Mandant (Tenant), in dem die zugehörige Telefonie-App installiert und eingerichtet ist. Installierte Apps findest Du unter **System → Apps**. Allgemeine Hinweise findest Du unter [Apps installieren und verwalten](https://help.vario-software.de/vario-cloud-handbuch/system/apps.md).
* Die **Cloud-Adresse** Deines Mandanten und ein **Zugangs-Schlüssel** für den Connector. Den Schlüssel erhältst Du von Deinem VARIO-Cloud-Administrator.

## Connector starten

Nach dem Start erscheint das Symbol des Connectors im Infobereich der Windows-Taskleiste, gegebenenfalls unter dem Pfeil für ausgeblendete Symbole. Ein eigenes Hauptfenster gibt es nicht. Beim ersten Start öffnen sich die Einstellungen automatisch.

Ein Rechtsklick auf das Symbol öffnet das Menü:

| Menüeintrag                        | Wirkung                                                                                                                                               |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Einstellungen…**                 | Öffnet die Einstellungen. Ein Doppelklick auf das Symbol bewirkt dasselbe.                                                                            |
| **Demo-Benachrichtigung anzeigen** | Zeigt eine Beispiel-Benachrichtigung mit „Erika Mustermann“. Damit prüfst Du ohne echten Anruf, ob Windows Benachrichtigungen des Connectors anzeigt. |
| **Beenden**                        | Beendet den Connector. Bis zum nächsten Start zeigt er keine Anrufe an und verarbeitet keine `tel:`-Links.                                            |

Der Connector läuft pro Windows-Benutzer nur einmal. Bei einem erneuten Start übernimmt die bereits laufende Instanz.

## Leitung und Cloud-Verbindung einrichten

Öffne die **Einstellungen** über das Taskleistensymbol. Die helle oder dunkle Darstellung folgt der Windows-Einstellung.

![Einstellungen des VARIO Cloud TAPI Connectors mit TAPI-Leitung, Mandanten, Telefon-Integration, Autostart und Diagnose](https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FeRbf86gbCSQuakBfegM3%2Ftapi-connector-einstellungen.png?alt=media)

### TAPI-Leitung auswählen

Wähle unter **„TAPI-Leitung“** die Leitung Deiner Nebenstelle aus. Die Bezeichnungen stammen vom TAPI-Treiber, im Beispiel „555 : Max Mustermann“. Über diese Leitung erkennt der Connector Anrufe und wählt Telefonnummern aus `tel:`-Links.

### VARIO-Cloud-Mandanten hinzufügen

1. Klicke unter **VARIO-Cloud-Tenants** auf **»Hinzufügen«**.
2. Trage im Dialog **Tenant** die **Cloud-Adresse** Deines Mandanten ein, zum Beispiel `https://<ihrtenant>.vario.cloud`.
3. Füge den vollständigen **Zugangs-Schlüssel (Bearer-Token)** ein. Mit **»Schlüssel anzeigen«** kannst Du ihn lesbar machen.
4. Bestätige den Dialog, markiere den Mandanten in der Liste und klicke auf **»Verbindung testen«**.

Ein Zugangs-Schlüssel besteht aus drei Teilen, die durch Punkte getrennt sind. Unter dem Eingabefeld siehst Du die Anzahl der Zeichen und Punkte. Bei **UNVOLLSTÄNDIG** wurde der Schlüssel meist nicht vollständig kopiert. Kopiere ihn erneut.

Meldet der Verbindungstest **401**, wurde der Schlüssel nicht akzeptiert. Er kann falsch oder abgelaufen sein oder zu einem anderen Mandanten gehören. Prüfe Cloud-Adresse und Schlüssel und trage den passenden Schlüssel erneut ein.

Mit **»Bearbeiten«** änderst Du den markierten Mandanten, mit **»Entfernen«** löschst Du dessen Verbindung aus dem Connector.

Du kannst mehrere Mandanten hinterlegen. Bei einem Anruf fragt der Connector sie gleichzeitig ab. Jeder Mandant, der eine Anzeige liefert, erzeugt eine eigene Benachrichtigung.

{% hint style="info" %}
Der Zugangs-Schlüssel wird in der **Windows-Anmeldeinformationsverwaltung Deines Benutzerkontos** gespeichert, nicht in der Einstellungsdatei des Connectors.
{% endhint %}

## Telefonnummern-Links und Autostart einrichten

### Connector für `tel:`-Links verwenden

Damit ein Klick auf eine Telefonnummer an den Connector übergeben wird, musst Du ihn registrieren und in Windows als Standardanwendung für `tel:`-Links festlegen:

1. Klicke unter **Telefon-Integration** auf **»Als Telefon-Handler registrieren (tel:)«**.
2. Öffne die vom Connector angebotenen Windows-Einstellungen oder gehe zu **Einstellungen → Apps → Standard-Apps**.
3. Wähle **Standardwerte nach Linktyp auswählen** und suche den Linktyp **tel**.
4. Wähle **VARIO Cloud TAPI Connector** als Standard aus.

Die Bezeichnung der Windows-Einstellung kann je nach Windows-Version abweichen.

Rechts neben der Schaltfläche zeigt der Connector den Registrierungszustand, zum Beispiel **für tel:-Links registriert**. Diese Registrierung ersetzt die Auswahl als Standardanwendung in Windows nicht. Mit **»tel:-Registrierung entfernen«** hebst Du die Registrierung wieder auf.

### Mit Windows starten

Klicke unter **Programmstart** auf **»Mit Windows automatisch starten«**, damit der Connector bei jeder Anmeldung an Windows startet. Die Einstellung gilt für Dein Benutzerkonto und benötigt keine Administratorrechte.

| Anzeige                     | Bedeutung                                                                                                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **startet mit Windows**     | Autostart ist eingerichtet. Mit **»Autostart mit Windows entfernen«** schaltest Du ihn aus.                                                                             |
| **kein Autostart**          | Der Connector startet nicht automatisch.                                                                                                                                |
| **in Windows abgeschaltet** | Der Autostart wurde im Task-Manager oder unter **Einstellungen → Apps → Autostart** deaktiviert. Mit **»Mit Windows automatisch starten«** schaltest Du ihn wieder ein. |

{% hint style="info" %}
Die Schaltflächen unter **Telefon-Integration** und **Programmstart** wirken sofort, auch wenn Du die Einstellungen anschließend mit **»Abbrechen«** schließt. Bei einer Installation als **Windows-App-Paket (MSIX)** verwaltet Windows Registrierung und Autostart; die Schaltflächen führen dann zu den passenden Windows-Einstellungen.
{% endhint %}

### Sprache und Einstellungen speichern

Unter **Sprache** übernimmt **Automatisch** die Windows-Sprache. Alternativ stehen Deutsch, Englisch, Französisch, Niederländisch, Polnisch, Tschechisch, Spanisch, Portugiesisch, Italienisch und Ukrainisch zur Auswahl.

Mit **OK** übernimmst Du die Einstellungen, mit **Abbrechen** verwirfst Du Änderungen. Ausgenommen sind die sofort wirksamen Aktionen für Telefon-Integration und Programmstart.

## Anrufe und Benachrichtigungen

### Eingehende Anrufe

Wenn Dein Telefon klingelt, fragt der Connector die hinterlegten Mandanten mit der Rufnummer des Anrufers ab. Die Cloud-App liefert die Anruferinformationen und die dort eingerichteten Schaltflächen.

* Eine **grüne Schaltfläche** nimmt den Anruf an. Unterstützt der TAPI-Treiber das Annehmen nicht, erscheint sie grau und nimmt den Anruf nicht an.
* Eine **rote Schaltfläche** legt auf. Bei Benachrichtigungen aus der Cloud wird sie auch angezeigt, wenn der TAPI-Treiber das Auflegen nicht unterstützt. In diesem Fall beendet der Klick das Gespräch nicht.
* Eine Schaltfläche mit einer **Verknüpfung** öffnet zusätzlich die passende Seite in VARIO Cloud im Standardbrowser, zum Beispiel die Adresse des Anrufers. Das funktioniert auch bei einer grau dargestellten Schaltfläche. Schaltflächen für Aufgaben oder Aktivitäten öffnen das entsprechende Formular; gespeichert wird erst in VARIO Cloud.

{% hint style="info" %}
Ob Du Anrufe über den Connector annehmen oder beenden kannst, hängt von Deiner Telefonanlage und ihrem TAPI-Treiber ab. Manche Anlagen melden Anrufe, erlauben aber keine Steuerung.
{% endhint %}

Kennt keiner der Mandanten die Nummer, erscheint keine Benachrichtigung, sofern in der Cloud-App keine Anzeige für unbekannte Anrufer eingerichtet ist.

### Ausgehende Anrufe

Klickst Du auf einen `tel:`-Link, wählt der Connector die Nummer über Deine TAPI-Leitung. Anhand der Nummer kann er Informationen aus VARIO Cloud für die Benachrichtigung abrufen.

Wählst Du direkt am Telefon, hängt die Anzeige davon ab, ob die Telefonanlage die gewählte Nummer an den Connector übermittelt. Fehlt sie, erscheint eine einfache Benachrichtigung **Ausgehender Anruf** ohne Cloud-Daten.

### Wie lange bleibt die Benachrichtigung sichtbar?

Sobald das Gespräch zustande kommt, wird die Benachrichtigung nach **10 Sekunden** ausgeblendet. Die Cloud-App kann eine andere Dauer vorgeben. Wird aufgelegt oder der Anruf nicht angenommen, verschwindet sie sofort.

### Benachrichtigungen ohne Cloud-Daten

Der Connector zeigt eine einfache Benachrichtigung mit den Informationen der Telefonanlage, wenn:

* die Rufnummer unterdrückt ist (**Rufnummer unterdrückt**),
* noch kein Mandant eingetragen ist oder
* kein Mandant eine Benachrichtigung geliefert hat und mindestens einer nicht erreichbar war.

Bei eingehenden Anrufen ist **Aktivität anlegen** grün und nimmt den Anruf an, sofern die Telefonanlage das unterstützt. Andernfalls ist die Schaltfläche grau. Ohne Cloud-Daten können **Adresse öffnen** und das Anlegen einer Aktivität kein VARIO-Formular öffnen; der Connector weist auf die fehlenden Daten hin. **Auflegen** wird in dieser einfachen Benachrichtigung nur angezeigt, wenn die Telefonanlage das Auflegen unterstützt.

## Probleme lösen

| Beobachtung                                                    | Was kannst Du tun?                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **TAPI-Leitung nicht verfügbar**                               | Die Leitung fehlt oder lässt sich nicht öffnen. Prüfe, ob Telefon und gegebenenfalls die Software der Telefonanlage angemeldet sind und ob Deine Nebenstelle geändert wurde. Mit **Leitung auswählen…** wählst Du eine andere Leitung, mit **Erneut versuchen** öffnest Du die bisherige erneut. Solange die Leitung nicht verfügbar ist, werden keine Anrufe angezeigt. |
| **Es erscheinen keine Benachrichtigungen.**                    | Rufe **Demo-Benachrichtigung anzeigen** auf. Erscheint auch die Demo nicht, prüfe **Windows-Einstellungen → System → Benachrichtigungen**: Benachrichtigungen müssen allgemein und für den Connector eingeschaltet sein. Prüfe auch **Nicht stören**.                                                                                                                    |
| **Eine Benachrichtigung erscheint ohne Cloud-Daten.**          | Prüfe den markierten Mandanten mit **Verbindung testen**. Bei **401** kontrolliere Cloud-Adresse und Zugangs-Schlüssel und trage den passenden Schlüssel erneut ein. Eine unterdrückte oder nicht übermittelte Rufnummer kann ebenfalls die Ursache sein.                                                                                                                |
| **Ein Klick auf eine Telefonnummer bewirkt nichts.**           | Prüfe, ob der Connector läuft und in Windows als Standard für **tel** festgelegt ist. Siehe [Telefonnummern-Links einrichten](#connector-fur-tel-links-verwenden).                                                                                                                                                                                                       |
| **Anruf nicht möglich** nach einem Klick auf einen `tel:`-Link | Es ist keine TAPI-Leitung eingestellt oder sie ist nicht verfügbar. Wähle in den Einstellungen Deine Leitung und prüfe ihre Verfügbarkeit.                                                                                                                                                                                                                               |

### Diagnose und Protokolle

Unter **Diagnose** stehen Dir folgende Funktionen zur Verfügung:

* **Cloud-Kommunikation protokollieren (ohne Zugangs-Schlüssel)** schreibt Anfragen an VARIO Cloud und die Antworten in ein Tagesprotokoll je Mandant. Schalte die Option bei Problemen mit der Cloud-Anbindung ein und wiederhole den betroffenen Anruf. Der Zugangs-Schlüssel wird nicht mitprotokolliert.
* **Protokoll-Ordner öffnen** öffnet den Protokollordner im Windows-Explorer. Die Protokolle helfen dem VARIO-Support bei der Analyse.
* **Zwischenspeicher leeren** entfernt zwischengespeicherte Bilder der Benachrichtigungen. Die Anrufer-Historie bleibt erhalten. Ein Bild, das gerade in einer sichtbaren Benachrichtigung verwendet wird, wird beim nächsten Mal entfernt.

## Dateien und Zugangsdaten

Der Connector legt seine Dateien im Benutzerprofil unter **`%APPDATA%\vario`** ab:

| Datei oder Ordner                                      | Inhalt                                                                                                                             |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| `VarioCloudTapiConnector.conf`                         | Einstellungen ohne Zugangs-Schlüssel.                                                                                              |
| `VarioCloudTapiConnector.log`                          | Programmprotokoll.                                                                                                                 |
| `VarioCloudTapiConnector\Logs\<Tenant>\JJJJ-MM-TT.log` | Tagesprotokoll der Cloud-Kommunikation je Mandant, wenn die Protokollierung eingeschaltet ist.                                     |
| `cache\`                                               | Zwischengespeicherte Bilder für Benachrichtigungen.                                                                                |
| `VARIO-Cloud-Callers.cache`                            | Anrufer-Historie, mit AES-256 verschlüsselt und an diesen Computer gebunden. Auf einem anderen Rechner lässt sie sich nicht lesen. |

Zugangs-Schlüssel liegen ausschließlich in der **Windows-Anmeldeinformationsverwaltung Deines Benutzerkontos**, nicht in diesen Dateien oder den Protokollen. Die Protokolle der Cloud-Kommunikation enthalten die übertragenen Anfragen und Antworten; sie sind durch das Weglassen des Schlüssels nicht automatisch anonymisiert.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.vario-software.de/vario-cloud-handbuch/grundlagen-und-konzepte/vario-cloud-tapi-connector.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
