Zoom-Integration

Areti Core für Zoom — Integrations-Leitfaden

Dieser Leitfaden erklärt, was die Zoom-Integration von Areti Core macht, wie du sie installierst und verbindest, wie du sie im Alltag nutzt und wie du sie wieder entfernst.

Was die Integration leistet

Areti Core ist eine Vertriebs- und CRM-Plattform. Die Zoom-Integration automatisiert den Video-Meeting-Teil jedes Verkaufstermins:

  • Automatische Meeting-Erstellung — wenn ein Vertriebler in Areti Core einen Termin bucht und Zoom als Videoanbieter wählt, erstellt Areti ein geplantes Zoom-Meeting im verbundenen Zoom-Konto und hängt den Join-Link an den Termin und die Bestätigungs-E-Mail an den Lead.
  • Sync beim Verschieben — wird der Termin auf eine andere Zeit gelegt, aktualisiert Areti das Zoom-Meeting in place. Der ursprüngliche Join-Link bleibt gültig.
  • Cleanup beim Löschen — wird der Termin abgesagt oder gelöscht, entfernt Areti das Zoom-Meeting, sodass keine verwaisten Meetings im Zoom-Konto bleiben.

Meeting-Inhalte, Aufzeichnungen, Teilnehmerdaten oder Chat-Nachrichten werden zu keiner Zeit abgerufen.

Was du brauchst

  1. Ein funktionierendes Zoom-Konto (kostenlos oder kostenpflichtig — beide werden unterstützt; einige Funktionen wie Waiting Rooms hängen von deinem Zoom-Plan ab).
  2. Einen Areti-Core-Workspace, in dem du Administrator bist. Nur Administratoren können ein Zoom-Konto im Namen des Workspaces verbinden.
  3. Zoom als Videoanbieter aktiviert in der Termin-Konfiguration von Areti Core. Wenn du beim Buchen eines Termins Zoom nicht als Option siehst, muss ein Administrator sie zunächst in der Admin-Konsole aktivieren.

Installation

Es gibt zwei Wege, Areti Core zu Zoom hinzuzufügen:

Variante A — über die Areti-Admin-Oberfläche (empfohlen)

  1. Melde dich unter https://reticor.io als Administrator an.
  2. Öffne die Admin-Konsole (Zahnrad-Symbol in der oberen Navigation).
  3. Gehe zu Termine → Video-Anbieter.
  4. Klicke Zoom verbinden.
  5. Ein Zoom-Consent-Fenster öffnet sich. Melde dich bei Zoom an (falls nötig), prüfe die angeforderten Berechtigungen und klicke Allow.
  6. Das Popup schließt sich. Deine Admin-Oberfläche zeigt jetzt das verbundene Zoom-Konto mit E-Mail-Adresse und Anzeigename des verbindenden Nutzers.

Variante B — über den Installations-Link aus dem Zoom App Marketplace

  1. Öffne den Installations-Link für Areti Core, den du von deinem ARETI-Ansprechpartner erhalten hast.
  2. Klicke Install oder Allow.
  3. Zoom leitet dich zu Areti Core weiter. Melde dich in deinem Workspace an.
  4. Areti bestätigt, dass dein Zoom-Konto verbunden ist.

Nach der Installation ist die Integration für den gesamten Areti-Workspace einsatzbereit — alle Vertriebler haben beim Buchen eines Termins die Zoom-Option verfügbar.

Tägliche Nutzung

Neuen Termin mit Zoom buchen

  1. Öffne einen Lead oder Kontakt in Areti Core.
  2. Klicke Termin buchen.
  3. Wähle Datum, Uhrzeit und Termin-Typ.
  4. Wähle Zoom als Video-Anbieter.
  5. Speichern.

Areti erstellt ein Zoom-Meeting im verbundenen Konto und hängt den Join-Link an den Termin. Wenn du E-Mail-Bestätigungen aktiviert hast, erhält der Lead automatisch eine Bestätigung mit dem Zoom-Link.

Termin verschieben

  1. Öffne den Termin in Areti.
  2. Ändere Startzeit, Dauer oder beides.
  3. Speichern.

Areti aktualisiert das Zoom-Meeting in place mit derselben Meeting-ID. Der Join-Link ändert sich nicht.

Termin absagen oder löschen

  1. Öffne den Termin in Areti.
  2. Klicke Termin löschen oder markiere ihn als abgesagt.

Areti löscht das zugehörige Zoom-Meeting, sodass es nicht mehr im Zoom-Konto auftaucht.

Meeting beitreten

Wenn das Meeting startet, öffne den Termin in Areti Core und klicke den Zoom-Link, oder verwende einfach den Link aus der Bestätigungs-E-Mail. Der Host startet das Meeting wie gewohnt aus seinem Zoom-Client — Areti selbst nimmt nicht an Meetings teil.

Angeforderte Berechtigungen

Die Integration fordert genau die folgenden Zoom-Scopes an, nicht mehr und nicht weniger:

ScopeVerwendung
user:read:userEinmaliges Lesen des Grundprofils des verbindenden Nutzers bei der Verbindung, um das Zoom-Konto dem korrekten Areti-Workspace zuzuordnen
meeting:write:meetingErstellung eines geplanten Zoom-Meetings, wenn ein Nutzer in Areti einen Termin bucht
meeting:update:meetingAktualisierung von Startzeit und Dauer eines Zoom-Meetings beim Verschieben des zugehörigen Termins
meeting:delete:meetingLöschung des Zoom-Meetings bei Absage oder Löschung des zugehörigen Termins

Wir fordern keine Scopes zum Lesen von Meeting-Inhalten, Aufzeichnungen, Teilnehmern, Chat, Benutzerlisten, Abrechnung, Telefonie, Webinaren oder anderen Zoom-Funktionen an.

Welche Daten gespeichert werden

Beim Verbinden von Zoom speichert Areti folgende Daten serverseitig in seiner in der EU gehosteten Supabase-Datenbank:

  • OAuth Access Token und Refresh Token (at-rest verschlüsselt, niemals im Browser)
  • deine Zoom-Benutzer-ID, Zoom-E-Mail-Adresse und Anzeigename
  • für jedes Meeting, das Areti in deinem Namen erstellt: Meeting-ID, Join-URL, Start-URL, Meeting-Passwort

Es werden keine Meeting-Aufzeichnungen, Transkripte, Teilnehmerlisten, Chat-Nachrichten oder sonstigen Meeting-Inhalte gespeichert.

Siehe die Datenschutzerklärung für alle Details zur Verarbeitung, Aufbewahrungsdauer und zu deinen Rechten nach DSGVO.

Integration trennen

Es gibt zwei Wege zum Trennen.

Aus Areti Core

  1. Melde dich als Administrator in Areti Core an.
  2. Öffne Admin-Konsole → Termine → Video-Anbieter.
  3. Klicke Zoom trennen neben dem verbundenen Konto.
  4. Bestätige.

Areti löscht sofort die gespeicherten OAuth-Tokens und die Zoom-Benutzer-Identität. Bereits existierende Meeting-Links an vergangenen oder zukünftigen Terminen werden nicht entfernt, da die Meetings selbst weiterhin in deinem Zoom-Konto existieren — du kannst sie bei Bedarf manuell in Zoom löschen.

Aus Zoom

  1. Melde dich bei https://zoom.us an.
  2. Gehe zu Advanced → App Marketplace → Manage → Installed Apps.
  3. Finde Areti Core und klicke Remove.
  4. Bestätige.

Zoom benachrichtigt Areti über den Deauthorization-Notification-Endpoint, und Areti löscht die gespeicherten OAuth-Tokens und Benutzeridentität innerhalb von Sekunden. Die Entfernung gilt für jeden Areti-Workspace, der mit diesem Zoom-Nutzer verbunden war.

Fehlerbehebung

„Zoom-Meeting konnte nicht erstellt werden"

Häufigste Ursache ist ein abgelaufenes oder widerrufenes OAuth-Token, meist weil das Zoom-Konto-Passwort geändert oder die App in Zoom entfernt wurde. Lösung: Zoom in der Areti-Admin-Konsole trennen und erneut verbinden.

„Zoom-Link fehlt am Termin"

Prüfe:

  1. Ob beim Termin tatsächlich „Zoom" als Video-Anbieter gewählt ist (nicht Google Meet oder eine andere Option).
  2. Ob aktuell ein Zoom-Konto in der Admin-Konsole verbunden ist.
  3. Ob der Termin nach dem Verbinden des Zoom-Kontos erstellt wurde.

Wenn alle drei Punkte zutreffen, wende dich an support@areti.de.

„Das verschobene Meeting zeigt in Zoom noch die alte Zeit"

Zoom cached Meeting-Details in seiner eigenen Oberfläche für kurze Zeit. Aktualisiere den Zoom-Desktop-Client oder das Zoom-Web-Dashboard, dann sollte die Änderung erscheinen. Bleibt die Zeit nach 5 Minuten falsch, wende dich an den Support.

„App in Zoom entfernt, Areti zeigt aber noch verbunden"

Der Deauthorization-Notification-Endpoint arbeitet asynchron. In sehr seltenen Fällen kann es einige Minuten dauern, bis Areti die Entfernung widerspiegelt. Dauert es länger als 10 Minuten, trenne manuell über die Areti-Admin-Konsole.

Support

Wenn du auf ein Problem stößt, das hier nicht abgedeckt ist, schreib uns an support@areti.de. Gib deinen Workspace-Namen, die Termin- oder Lead-ID und die genaue Uhrzeit des Fehlers an — das hilft uns, schnell zu helfen.

Anbieter

Areti Core wird von der ARETI GmbH in Deutschland entwickelt. Die Zoom-Integration wird vom Areti-Core-Team gepflegt.

Firma: ARETI GmbH Adresse: Saarstraße 7, 80797 München, Deutschland Handelsregister: Amtsgericht München, HRB 248858 Website: https://reticor.io Support: support@areti.de