OAuth-Integrationsleitfaden

meetergo verwendet OAuth 2.0 zur Verbindung mit externen Diensten wie Kalendern, Videokonferenzen und CRM-Systemen. Dieser Leitfaden erklärt, wie OAuth-Integrationen funktionieren und wie Sie Verbindungsprobleme beheben.

Wie OAuth in meetergo funktioniert

Der OAuth-Ablauf

Wenn Sie eine Integration verbinden (wie Google Calendar), geschieht Folgendes:

1. Autorisierungsanfrage: Sie klicken auf „Verbinden" und werden zum Dienst weitergeleitet (z.B. Google)
2. Benutzereinwilligung: Sie gewähren meetergo die Berechtigung, auf bestimmte Daten zuzugreifen
3. Autorisierungscode: Der Dienst sendet einen Code zurück an meetergo
4. Token-Austausch: meetergo tauscht den Code gegen Zugangs-Tokens
5. Verbindung gespeichert: Tokens werden sicher für fortlaufenden Zugang gespeichert

Was meetergo anfordert

Verschiedene Integrationen fordern verschiedene Berechtigungen an:

Kalenderintegrationen

Videokonferenzen

CRM-Integrationen

OAuth-Verbindungen verwalten

Verbundene Dienste anzeigen

1. Gehen Sie zu Einstellungen → Integrationen
2. Sehen Sie alle verbundenen Dienste
3. Prüfen Sie den Verbindungsstatus (aktiv, abgelaufen, Fehler)

Integration neu verbinden

Wenn eine Verbindung abläuft oder Probleme hat:

1. Gehen Sie zu Einstellungen → Integrationen
2. Finden Sie die Integration
3. Klicken Sie auf Neu verbinden oder Aktualisieren
4. Autorisieren Sie erneut beim Dienst

Integration trennen

1. Gehen Sie zu Einstellungen → Integrationen
2. Finden Sie die Integration
3. Klicken Sie auf Trennen oder Entfernen
4. Bestätigen Sie die Trennung

Dies widerruft meetergo's Zugang. Die Integration kann auch in der Liste der verbundenen Apps des Dienstes erscheinen, bis sie dort vollständig widerrufen wird.

OAuth-Statusverwaltung

Wie meetergo OAuth handhabt

meetergo verwendet sichere OAuth-Statusparameter um:

• CSRF-Angriffe zu verhindern
• Zu verfolgen, welcher Benutzer die Verbindung initiiert hat
• Den Callback korrekt zu behandeln

Token-Aktualisierung

OAuth-Tokens laufen ab. meetergo automatisch:

• Aktualisiert Tokens vor dem Ablauf
• Wiederholt fehlgeschlagene Aktualisierungen
• Benachrichtigt Sie, wenn die Aktualisierung fehlschlägt

Wenn die automatische Aktualisierung fehlschlägt, müssen Sie manuell neu verbinden.

OAuth-Probleme beheben

„Verbindung fehlgeschlagen"-Fehler

Häufige Ursachen:

1. Popup blockiert: Erlauben Sie Popups von meetergo
2. Drittanbieter-Cookies: Aktivieren Sie Drittanbieter-Cookies
3. Netzwerkprobleme: Überprüfen Sie Ihre Internetverbindung
4. Dienstausfall: Der externe Dienst kann ausgefallen sein

„Berechtigung verweigert"

Wenn Sie Berechtigungsfehler sehen:

1. Sie haben möglicherweise erforderliche Berechtigungen abgelehnt
2. Wiederholen Sie die Verbindung und akzeptieren Sie alle angeforderten Berechtigungen
3. Prüfen Sie, ob Ihre Organisation die App einschränkt

„Token abgelaufen"

Wenn Tokens ablaufen und sich nicht aktualisieren:

1. Gehen Sie zu Einstellungen → Integrationen
2. Trennen Sie die Integration
3. Verbinden Sie neu
4. Autorisieren Sie erneut beim Dienst

Google-spezifische Probleme

Für Google Calendar-Verbindungen:

• Stellen Sie sicher, dass Drittanbieter-App-Zugang in Google Workspace aktiviert ist
• Prüfen Sie, ob Ihr Admin meetergo eingeschränkt hat
• Versuchen Sie, ein persönliches Google-Konto zum Testen zu verwenden

Microsoft-spezifische Probleme

Für Outlook/Teams-Verbindungen:

• Admin-Einwilligung kann für Organisationskonten erforderlich sein
• Prüfen Sie Azure AD App-Berechtigungen
• Persönliche vs. Arbeitskonten können unterschiedliche Einschränkungen haben

Für Entwickler: Integrationen erstellen

meetergo's API verwenden

Wenn Sie benutzerdefinierte Integrationen erstellen:

1. API-Schlüssel: Verwenden Sie API-Schlüssel für Server-zu-Server
2. Webhooks: Empfangen Sie Ereignisse bei Buchungen
3. Kein OAuth nötig: Ihre Integration verwendet API-Schlüssel, nicht OAuth

Siehe API-Dokumentation.

Webhook-Authentifizierung

Webhooks verwenden kein OAuth, aber Sie sollten:

• HTTPS-Endpunkte verwenden
• Payload-Signaturen validieren
• Wiederholungsbehandlung implementieren

CRM-Integrationsmuster

Bei der Synchronisierung mit CRMs:

1. Webhook-ausgelöst: meetergo sendet Buchungsdaten per Webhook
2. Ihr Server: Empfängt und verarbeitet die Daten
3. CRM-API: Ihr Code ruft die CRM-API mit Ihren eigenen OAuth-Tokens auf

meetergo handhabt die Buchungsseite; Sie handeln die CRM-Seite.

Sicherheitsüberlegungen

Token-Speicherung

meetergo speichert OAuth-Tokens:

• Verschlüsselt im Ruhezustand
• Zugang kontrolliert durch Ihr Konto
• Automatisch aktualisiert

Minimale Berechtigungen

meetergo fordert nur notwendige Berechtigungen an:

• Kalender lesen/schreiben (nicht E-Mail)
• Meeting-Erstellung (nicht alle Zoom-Daten)
• Kontakt-/Deal-Zugang (nicht alle CRM-Daten)

Zugang widerrufen

Um meetergo's Zugang vollständig zu widerrufen:

1. In meetergo trennen
2. Auch im Dienst widerrufen:
   • Google: myaccount.google.com → Sicherheit → Drittanbieter-Apps
   • Microsoft: account.microsoft.com → Datenschutz → Apps und Dienste
   • Zoom: zoom.us → Einstellungen → Apps

OAuth-Scopes-Referenz

Google Calendar

https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

Microsoft Graph

Calendars.ReadWrite
User.Read
OnlineMeetings.ReadWrite

Zoom

meeting:write
user:read

FAQ

Warum benötigt meetergo diese Berechtigungen?

Jede Berechtigung ermöglicht eine bestimmte Funktion:

• Kalender lesen: Ihre Verfügbarkeit prüfen
• Kalender schreiben: Gebuchte Meetings hinzufügen
• Meeting erstellen: Video-Links generieren

Kann ich einschränken, worauf meetergo zugreift?

Sie müssen die angeforderten Berechtigungen gewähren, damit die Integration funktioniert. meetergo greift nur auf das zu, was für die Terminplanung benötigt wird.

Werden meine Daten mit Dritten geteilt?

meetergo teilt Ihre OAuth-Daten nicht. Tokens werden nur verwendet, um die Integrationsfunktionalität bereitzustellen.

Was, wenn mein Unternehmen OAuth-Apps einschränkt?

Kontaktieren Sie Ihren IT-Admin um:

• meetergo in Ihren OAuth-Richtlinien freizugeben
• Admin-Einwilligung für die erforderlichen Berechtigungen zu erteilen
• Drittanbieter-App-Zugang zu aktivieren

Kann ich persönliche Konten für die Arbeit verwenden?

Ja, wenn Ihre Organisation es erlaubt. Einige bevorzugen die Trennung von persönlichen und Arbeitskalendern.

Verwandte Artikel

• Kalender verbinden
• Google Calendar verbinden
• Outlook Calendar verbinden
• Verlorene Verbindungen wiederherstellen
• API-Dokumentation