TeamViewer-Integration einrichten
venabo unterstützt die Verbindung mit TeamViewer über das OAuth-Verfahren. Sie richten die Integration einmalig in der Systemkonfiguration ein – danach steht sie Ihrem gesamten Betrieb zur Verfügung.
💡 Tipp: Für die Einrichtung benötigen Sie Zugang zum TeamViewer-Onlineportal mit Administratorrechten, um dort eine neue App anlegen zu können.
Voraussetzungen
- Zugang zum TeamViewer-Onlineportal (administrator.teamviewer.com)
- Administratorrechte in venabo für die Systemkonfiguration
- Die Redirect-URI Ihres venabo-Servers (siehe unten)
Schritt-für-Schritt-Einrichtung
Schritt 1: App im TeamViewer-Onlineportal anlegen
- Melden Sie sich im TeamViewer-Onlineportal an.
- Navigieren Sie zu den App-Einstellungen und legen Sie eine neue App an.
- Tragen Sie im Feld Redirect URI die URI Ihres venabo-Servers ein (siehe Schritt 2).
- Speichern Sie die App. TeamViewer zeigt Ihnen anschließend die Client ID und das Client Secret an – notieren Sie beide Werte.
Schritt 2: Redirect-URI ermitteln
Die Redirect-URI folgt immer diesem Muster:
⚠️ Hinweis: Die Redirect-URI muss auf TeamViewer-Seite und in venabo exakt identisch eingetragen sein – auch Groß-/Kleinschreibung und abschließende Schrägstriche zählen.
Schritt 3: Zugangsdaten in venabo eintragen
- Öffnen Sie in venabo die Systemkonfiguration.
- Wechseln Sie zum Bereich TeamViewer.
- Tragen Sie Client ID und Client Secret aus dem TeamViewer-Portal ein.
- Geben Sie die Redirect URI identisch zur TeamViewer-App ein.
- Speichern Sie die Einstellungen und starten Sie den OAuth-Prozess.
Praxisbeispiel
Szenario: Ihre venabo-Installation ist unter https://venabo.musterfirma.de erreichbar. Sie möchten die TeamViewer-Integration aktivieren.
| Feld | Beispielwert | Wo eintragen? |
|---|---|---|
| Client ID | a1b2c3d4-e5f6-… | venabo Systemkonfiguration |
| Client Secret | xy12za34… | venabo Systemkonfiguration |
| Redirect URI | https://venabo.musterfirma.de/oauth/teamviewer | TeamViewer-App und venabo |
Häufige Fragen
Muss ich die Integration für jeden Mitarbeiter einzeln einrichten?
Nein. Sie konfigurieren die TeamViewer-Integration einmalig global in der Systemkonfiguration. Danach steht die Verbindung allen berechtigten Benutzern in venabo zur Verfügung.
Was passiert, wenn die Redirect-URI nicht übereinstimmt?
Der OAuth-Prozess schlägt fehl und venabo kann keine Verbindung zu TeamViewer aufbauen. Überprüfen Sie in diesem Fall, ob die URI in der TeamViewer-App und in der venabo-Systemkonfiguration zeichengenau identisch ist – einschließlich https:// und ohne abschließenden Schrägstrich.
Wo finde ich Client ID und Client Secret nach dem Anlegen der App?
TeamViewer zeigt Ihnen beide Werte unmittelbar nach dem Speichern der App im Onlineportal an. Das Client Secret wird in der Regel nur einmalig angezeigt – kopieren Sie es daher direkt in die venabo-Systemkonfiguration oder notieren Sie es sicher.
Kann ich dieselbe TeamViewer-App für mehrere venabo-Instanzen nutzen?
Nein. Da die Redirect-URI pro venabo-Instanz unterschiedlich ist (unterschiedliche Server-URL), benötigen Sie für jede venabo-Installation eine separate App im TeamViewer-Onlineportal.
Zusammenfassung
| Schritt | Aktion | Wo? |
|---|---|---|
| 1 | App anlegen und Redirect-URI eintragen | TeamViewer-Onlineportal |
| 2 | Client ID und Client Secret notieren | TeamViewer-Onlineportal |
| 3 | Zugangsdaten und Redirect-URI eintragen | venabo Systemkonfiguration |
| ✅ | OAuth-Verbindung aktiv | venabo & TeamViewer verbunden |