> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoom mit anny verbinden

> Erstelle für jede Buchung automatisch ein Zoom-Meeting und teile den Einladungslink mit deinen Kund:innen.

[Zoom](https://zoom.us) ist einer der bekanntesten Dienste für Videokonferenzen. Mit der Integration plant anny für deine Buchungen automatisch Zoom-Meetings und verteilt die Einladungslinks, ohne dass du manuell Termine in Zoom anlegen musst.

Mit Zoom kannst du in anny:

* Für jede Buchung einer Ressource automatisch ein Zoom-Meeting erstellen lassen
* Den Beitritts-Link samt Meeting-ID und Passwort automatisch an deine Kund:innen verteilen
* Pro Ressource festlegen, welche Zoom-Nutzer:in das Meeting als Organisator:in erhält

Die Integration lohnt sich für alle, die Termine online durchführen, zum Beispiel Beratungsgespräche, Coachings, Sprechstunden oder Online-Kurse.

## Typische Anwendungsfälle

| Anwendungsfall        | Beschreibung                                                                                                                                                                                                 |
| :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Online-Beratung       | **Jede gebuchte Beratung bekommt automatisch ihr Zoom-Meeting.** Kund:innen erhalten den Beitritts-Link direkt mit der Buchungsbestätigung und die Berater:in startet das Meeting aus der Buchungsübersicht. |
| Kurse und Coachings   | **Teilnehmer:innen eines Termins treten demselben Meeting bei.** Buchen mehrere Personen denselben Zeitraum einer Ressource mit freier Kapazität, teilen sie sich automatisch ein gemeinsames Zoom-Meeting.  |
| Sprechstunden im Team | **Jede Ressource hat ihre eigene Organisator:in.** Du verknüpfst jede Sprechstunden-Ressource mit der passenden Zoom-Nutzer:in aus deinem Konto, damit Meetings immer bei der richtigen Person landen.       |

## Wie die Zoom-Verbindung funktioniert

Die Verbindung wird über den Zoom-Login hergestellt: Du klickst in anny auf **Autorisieren**, meldest dich bei Zoom an und erlaubst anny den Zugriff auf dein Zoom-Konto. Ein API-Schlüssel ist nicht nötig. Mit **Verbindung testen** prüfst du jederzeit, ob die Verbindung steht.

anny greift nur auf zwei Dinge zu: die Nutzerliste deines Zoom-Kontos (für die Auswahl der Organisator:innen) und die Meetings, die anny selbst für Buchungen anlegt. Bestehende Meetings und Einstellungen deines Zoom-Kontos bleiben unangetastet.

So läuft es bei einer Buchung ab:

1. Eine Buchung geht für eine verknüpfte Ressource ein.
2. anny erstellt beim hinterlegten **Organisator des Meetings** ein geplantes Zoom-Meeting. Titel, Beginn und Dauer übernimmt anny aus der Buchung, die Zeitzone von der Ressource.
3. Kund:innen erhalten den Beitritts-Link automatisch: als Button **Zoom Meeting beitreten** in der Buchungs-E-Mail (samt Zoom ID und Passwort), im Kalendereintrag und in den Buchungsdetails. Eingeloggte Team-Mitglieder sehen dort stattdessen **Zoom Meeting starten**.
4. Wird die Buchung verschoben, aktualisiert anny das Meeting. Wird sie storniert, abgelehnt oder gelöscht, löscht anny auch das Zoom-Meeting.

Widerrufst du die Autorisierung oder läuft sie ab, kann anny keine Meetings mehr erstellen, aktualisieren oder löschen. Die Verantwortlichen deiner Organisation erhalten in dem Fall die E-Mail „Die Zoom Integration hat einen Fehler" und du musst dich über **Autorisieren** erneut anmelden.

## Zoom verbinden

### Voraussetzungen

Bevor du Zoom verbindest, stelle sicher, dass du Folgendes hast:

* Ein aktives Zoom-Konto mit den Nutzer:innen, die Meetings als Organisator:innen erhalten sollen
* Die Berechtigung, in diesem Zoom-Konto Apps zu autorisieren
* Admin-Rechte in deinem anny Account

### Verbindung einrichten

<Steps>
  <Step title="Autorisieren">
    Öffne aus der Menüleiste die **Integrationen**, füge die Zoom-Integration hinzu und klicke im Bereich **Authentifizierung** auf **Autorisieren**. Melde dich bei Zoom an und bestätige den Zugriff für anny. Mit **Verbindung testen** prüfst du, ob die Anmeldung erfolgreich war.
  </Step>

  <Step title="Konfigurieren">
    Lege in den **Zoom-Einstellungen** fest, welche Ressourcen Meetings bekommen:

    1. Klicke auf **Hinzufügen**, um eine neue Zoom-Verbindung zu erstellen.
    2. Wähle unter **Wähle die Ressource** die Ressource aus (z. B. Beratungsraum 1).
    3. Optional: Begrenze die Verbindung über **Buchungsoptionen auswählen** auf bestimmte Buchungsoptionen. Ohne Auswahl gilt sie für **Alle Buchungsoptionen**.
    4. Wähle unter **Wähle den Organisator des Meetings** die Zoom-Nutzer:in, bei der die Meetings angelegt werden.
    5. Bestätige die Verbindung und wiederhole die Schritte für weitere Ressourcen.
  </Step>

  <Step title="Aktivieren">
    Aktiviere die Integration über den **Toggle** oben rechts.
  </Step>
</Steps>

Sobald die Integration aktiv ist, erstellt anny für jede neue Buchung einer verknüpften Ressource automatisch ein Zoom-Meeting und verteilt die Links.

<Tip>
  Teste die Integration mit einer Testbuchung: Buche eine verknüpfte Ressource und prüfe, ob die Buchungsbestätigung den Button **Zoom Meeting beitreten** enthält und das Meeting im Zoom-Konto der Organisator:in erscheint.
</Tip>

### Einstellungen & Optionen

| Einstellung              | Beschreibung                                                                                                                                            |
| :----------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Ressource                | Die Ressource, für deren Buchungen Meetings erstellt werden. Jede Zoom-Verbindung gilt für genau eine Ressource; Unterressourcen verbindest du einzeln. |
| Buchungsoptionen         | Begrenzt die Verbindung auf bestimmte Buchungsoptionen. Ohne Auswahl gilt **Alle Buchungsoptionen** und jede Buchung der Ressource erhält ein Meeting.  |
| Organisator des Meetings | Die Zoom-Nutzer:in aus deinem Konto, bei der die Meetings angelegt werden. Diese Person kann die Meetings in Zoom starten und verwalten.                |

<Tip>
  Die Zoom-Verbindungen lassen sich nur bearbeiten, solange die Integration deaktiviert ist. Schalte den **Toggle** vor Änderungen kurz aus und danach wieder ein.
</Tip>

## Einschränkungen

Die Zoom-Integration unterstützt nicht:

* **Vererbung auf Unterressourcen:** Eine Zoom-Verbindung gilt nur für die gewählte Ressource. Buchungen ihrer Unterressourcen erhalten kein Meeting; verbinde Unterressourcen einzeln.
* **Meetings für bestehende Buchungen:** Beim Aktivieren der Integration werden für bereits vorhandene Buchungen keine Meetings rückwirkend erstellt.
* **Meeting-Optionen aus anny:** anny setzt nur Titel, Zeit, Dauer und Zeitzone. Passwort, Warteraum und weitere Optionen bestimmen die Einstellungen deines Zoom-Kontos.
* **Meeting-Erinnerungen:** anny verschickt keine gesonderten Erinnerungs-E-Mails vor dem Meeting-Start.
* **Meetings für Blocker:** Interne Blocker-Buchungen erhalten nie ein Zoom-Meeting.

## Verbindung trennen

<Warning>
  Wenn du die Integration deaktivierst, erstellt anny keine neuen Meetings mehr. Bestehende Zoom-Meetings bleiben erhalten, werden aber nicht mehr aktualisiert oder gelöscht, auch wenn die zugehörige Buchung verschoben oder storniert wird. Beim Löschen öffnet sich ein Dialog mit einer Anleitung, wie du die anny App zusätzlich aus deinem Zoom-Konto entfernst (Zoom Marketplace), oder du wählst **Nur bei anny entfernen**. Bereits erstellte Meetings bleiben in deinem Zoom-Konto bestehen. Deinstallierst du anny direkt im Zoom Marketplace, wird die Integration auch in anny automatisch entfernt.
</Warning>

Beides findest du unter **Integrationen**: Deaktivieren über den **Toggle** oben rechts, Löschen über die **drei Punkte** → **Löschen**.

## FAQ

<AccordionGroup>
  <Accordion title="Woher bekommen meine Kund:innen den Zoom-Link?">
    Automatisch von anny: Die Buchungs-E-Mail enthält den Button **Zoom Meeting beitreten** samt Zoom ID und Passwort. Zusätzlich steht der Link im Kalendereintrag der Buchung und in den Buchungsdetails.
  </Accordion>

  <Accordion title="Wer ist Gastgeber:in des Meetings?">
    Die Zoom-Nutzer:in, die du in der Zoom-Verbindung als **Organisator des Meetings** hinterlegt hast. Sie startet das Meeting über den Link **Zoom Meeting starten** in der Buchung; Kund:innen treten über den Beitritts-Link bei.
  </Accordion>

  <Accordion title="Was passiert, wenn eine Buchung verschoben oder storniert wird?">
    Bei einer Verschiebung aktualisiert anny das Zoom-Meeting automatisch auf die neue Zeit. Wird die Buchung storniert, abgelehnt oder gelöscht, löscht anny auch das Zoom-Meeting.
  </Accordion>

  <Accordion title="Kann ich Meetings nur für bestimmte Buchungsoptionen erstellen lassen?">
    Ja. Wähle in der Zoom-Verbindung unter **Buchungsoptionen auswählen** die gewünschten Buchungsoptionen aus. Ohne Auswahl gilt die Verbindung für **Alle Buchungsoptionen**.
  </Accordion>

  <Accordion title="Warum kann ich die Zoom-Einstellungen nicht bearbeiten?">
    Die Zoom-Verbindungen sind gesperrt, solange die Integration aktiv ist. Deaktiviere sie kurz über den **Toggle**, nimm die Änderungen vor und aktiviere sie wieder.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Für eine Buchung wurde kein Zoom-Meeting erstellt">
    Meist fehlt eine passende Zoom-Verbindung oder die Integration war zum Buchungszeitpunkt deaktiviert. Prüfe, ob der **Toggle** aktiv ist, ob für die gebuchte Ressource eine Zoom-Verbindung existiert und ob die gebuchte Buchungsoption in der Verbindung ausgewählt ist. Beachte: Unterressourcen brauchen eine eigene Verbindung.
  </Accordion>

  <Accordion title="Der Meeting-Link zeigt „Meeting not ready yet“">
    Das Meeting wurde noch nicht fertig bei Zoom angelegt, zum Beispiel direkt nach der Buchung oder weil die Verbindung gestört war. Warte einen Moment und öffne den Link erneut. Bleibt die Meldung bestehen, prüfe die Integration mit **Verbindung testen**.
  </Accordion>

  <Accordion title="Ich habe die E-Mail „Die Zoom Integration hat einen Fehler“ erhalten">
    Die Autorisierung ist abgelaufen oder wurde widerrufen; anny kann keine Meetings mehr verwalten. Öffne die Integration unter **Integrationen** und melde dich über **Autorisieren** erneut bei Zoom an.
  </Accordion>

  <Accordion title="Eine neue Zoom-Nutzer:in erscheint nicht in der Auswahl">
    Die Nutzerliste wird einige Minuten zwischengespeichert. Warte kurz und lade die Seite neu. Prüfe außerdem, ob die Person im verbundenen Zoom-Konto angelegt ist; du kannst in der Auswahl auch nach der E-Mail-Adresse suchen.
  </Accordion>
</AccordionGroup>

> Wichtige Informationen für Agenten:
>
> **Abgrenzung:** Zoom ist eine der Video-Meeting-Integrationen (Kategorie „Online Meeting-Integrationen") neben MS Teams, PurpleView und den in anny integrierten Video-Calls. Zoom erstellt ausschließlich geplante Einzel-Meetings pro Buchung: keine Webinare, keine Serien-Meetings, kein Kalender-Sync.
>
> **UI-Pfade:** Einrichtung: Menüleiste → **Integrationen** → Zoom → Panel „Authentifizierung" → Button „Autorisieren" (OAuth-Login bei Zoom), Button „Verbindung testen". Regeln: Panel „Zoom-Einstellungen" → „Hinzufügen" → Modal „Zoom-Verbindung erstellen"/„Zoom-Verbindung bearbeiten" mit Feldern „Wähle die Ressource", „Buchungsoptionen auswählen" (Platzhalter „Alle Buchungsoptionen"), „Wähle den Organisator des Meetings" (Suche per E-Mail). Tabellen-Spalten: „Ressource", „Buchungsoptionen", „Organisator des Meetings". Lösch-Dialog: „So entfernst du anny von deinem Zoom Account" (Zoom Marketplace → Manage → Installed Apps → Uninstall) mit Option „Nur bei anny entfernen".
>
> **Quirks:** (1) Meetings entstehen bereits beim Eingang der Buchung, auch für noch unbestätigte Anfragen; bei Ablehnung, Storno, Ablauf oder Löschung wird das Meeting gelöscht. (2) Bei Ressourcen mit Kapazität > 1 (ohne Unterressourcen) teilen sich alle Buchungen mit identischem Start und Ende ein Meeting; es wird erst mit der letzten Buchung gelöscht. Wird eine dieser Buchungen zeitlich verschoben, bekommt sie ein neues eigenes Meeting und anny verschickt zusätzlich die E-Mails „Zoom Meeting zu deiner Buchung" (Kund:in) und „Zoom Meeting erstellt" (Team); im Normalfall gibt es keine eigene Meeting-E-Mail, der Link steckt in der Buchungsbestätigung. (3) Bei Ressourcenwechsel einer Buchung wird das alte Meeting gelöscht und nach der Verbindung der neuen Ressource neu erstellt. (4) Meeting-Titel = Standard-Buchungsbezeichnung (Ressource/Buchungsoption/Kund:in); Zeitzone der Ressource. (5) Beitritts- und Start-Link sind anny-Weiterleitungen (nicht die rohen Zoom-URLs); der rohe Link ist in den Buchungsdetails kopierbar. Solange das Meeting fehlt, liefern die Weiterleitungen den Fehler „Meeting not ready yet". (6) Fehlgeschlagene Meeting-Aktionen werden bis zu 3-mal wiederholt. (7) Nutzerliste ca. 10 Minuten gecacht, einzelne Nutzer:innen bis 1 Stunde. (8) Nach dem Aktivieren entstehen Meetings für ältere Buchungen erst, wenn diese Buchungen bearbeitet werden. (9) Während die Integration deaktiviert ist, werden Meetings auch bei Storno nicht gelöscht; das wird nach dem Reaktivieren nicht nachgeholt.
>
> **Beziehungen:** Freischaltung über dasselbe Plan-Feature wie alle Video-Meeting-Integrationen (MS Teams, PurpleView, anny Video-Calls); Plan-Zuordnung nicht im Artikel dokumentiert. Verwandte Artikel: anny Video-Calls, MS Teams, PurpleView. Die Zuordnung „Organisator des Meetings" nutzt die Nutzerliste des per OAuth verbundenen Zoom-Kontos; Autorisierungs-Verlust löst die E-Mail „Die Zoom Integration hat einen Fehler" an die Verantwortlichen aus. Wird die anny App im Zoom Marketplace deinstalliert, löscht anny die Integration automatisch (Deauthorisierungs-Webhook).
