# Zoom-Meetings (https://docs.akollo.com/de/connections/zoom)



Akollo kann die Angaben zu bereits beendeten Meetings in Ihrem Zoom-Konto lesen: wann jedes Meeting begann und endete, wie lange es dauerte, wie viele Personen teilnahmen und welcher Host es abhielt. Akollo legt nie ein Meeting an, ändert oder löscht keines und greift nie auf Registrierungen zu. Namen und E-Mail-Adressen der Teilnehmenden werden nicht gelesen.

## Was synchronisiert wird [#was-synchronisiert-wird]

| Daten                                       | Von Akollo gelesen                                                      |
| ------------------------------------------- | ----------------------------------------------------------------------- |
| Beginn und Ende beendeter Meetings          | Ja                                                                      |
| Dauer                                       | Ja                                                                      |
| Anzahl der Teilnehmenden                    | Ja                                                                      |
| Host, der das Meeting abhielt               | Ja                                                                      |
| Thema des Meetings                          | Nur wenn **Store meeting topics** eingeschaltet ist (standardmäßig aus) |
| Namen und E-Mail-Adressen der Teilnehmenden | Nein                                                                    |
| Registrierungen                             | Nein                                                                    |
| Meetings anlegen, ändern oder löschen       | Nie                                                                     |

## Voraussetzungen [#voraussetzungen]

* Ein Zoom-Konto im Tarif Pro oder höher. Der Bericht über vergangene Meetings, den Akollo liest, ist im kostenlosen Tarif nicht verfügbar.
* Eine Zoom-Kontoadministration, die im Zoom App Marketplace eine App anlegen kann.

## Zoom-App anlegen [#zoom-app-anlegen]

<Steps>
  <Step>
    ### Server-to-Server-OAuth-App starten [#server-to-server-oauth-app-starten]

    Wählen Sie im Zoom App Marketplace **Develop → Build App** und dann **Server-to-Server OAuth**.
  </Step>

  <Step>
    ### App benennen [#app-benennen]

    Geben Sie der App einen Namen, zum Beispiel „Akollo Meeting-Leser“.
  </Step>

  <Step>
    ### Berechtigungen hinzufügen [#berechtigungen-hinzufügen]

    Fügen Sie unter **Scopes** genau diese zwei hinzu:

    * `user:read:list_users:admin`
    * `report:read:list_meetings:admin`
  </Step>

  <Step>
    ### App aktivieren [#app-aktivieren]

    Aktivieren Sie die App. Notieren Sie **Account ID**, **Client ID** und **Client secret**.
  </Step>
</Steps>

Akollo meldet sich als diese App an. Es fordert keine Person auf, sich bei Zoom anzumelden.

## In Akollo verbinden [#in-akollo-verbinden]

<Steps>
  <Step>
    ### Client Secret hinterlegen [#client-secret-hinterlegen]

    Hinterlegen Sie das Client Secret im Akollo-Tresor für die Zoom-Verbindung.
  </Step>

  <Step>
    ### Anbietereinstellungen ausfüllen [#anbietereinstellungen-ausfüllen]

    Öffnen Sie **Integrations → Connections**, öffnen Sie die Zoom-Verbindung und füllen Sie **Provider settings** (Anbietereinstellungen) aus:

    * **Zoom account ID** und **Client ID** aus der App.
    * **Vault reference**: die Tresor-ID des Client Secrets.
    * **Store meeting topics**: standardmäßig aus. Meeting-Themen können Kundennamen enthalten; schalten Sie diese Option nur ein, wenn Ihre Richtlinie es erlaubt. Ist sie aus, speichert Akollo nie ein Thema.
    * **Days to read back**: wie weit das erste Lesen zurückreicht, 1 bis 30 Tage (14, wenn leer).
  </Step>

  <Step>
    ### Speichern [#speichern]

    Speichern Sie die Einstellungen. Wenn Sie später die Account ID oder die Client ID ändern, brauchen Sie erneut das Client Secret.
  </Step>
</Steps>

<Callout type="warn" title="Achtung">
  Ihre Administration muss außerdem `zoom.us` und `api.zoom.us` in den Netzwerkeinstellungen des Connectors erlauben. Fehlt einer der beiden, sendet Akollo nichts an Zoom.
</Callout>

## Wie oft gelesen wird [#wie-oft-gelesen-wird]

Akollo prüft stündlich auf neu beendete Meetings. Jede Prüfung liest ab einem Tag vor dem zuletzt gesehenen Meeting erneut. So wird ein Meeting an einer Tagesgrenze nie verpasst, und ein doppelt gelesenes Meeting wird nicht doppelt gespeichert.

## Häufige Fragen [#häufige-fragen]

<Accordions type="single">
  <Accordion title="Funktioniert Akollo mit einem kostenlosen Zoom-Konto?">
    Nein. Der Bericht über vergangene Meetings, den Akollo liest, setzt ein Zoom-Konto im Tarif Pro oder höher voraus.
  </Accordion>

  <Accordion title="Muss sich jemand für Akollo bei Zoom anmelden?">
    Nein. Akollo meldet sich als Server-to-Server-OAuth-App an und fordert keine Person zur Anmeldung auf.
  </Accordion>

  <Accordion title="Liest Akollo, wer an einem Meeting teilgenommen hat?">
    Nein. Akollo liest, wie viele Personen teilgenommen haben, nicht deren Namen oder E-Mail-Adressen.
  </Accordion>

  <Accordion title="Warum werden keine Meeting-Themen angezeigt?">
    **Store meeting topics** ist standardmäßig aus, weil Themen Kundennamen enthalten können. Schalten Sie die Option nur ein, wenn Ihre Richtlinie es erlaubt.
  </Accordion>

  <Accordion title="Wie weit reicht das erste Lesen zurück?">
    So weit, wie **Days to read back** angibt: 1 bis 30 Tage, 14 Tage bei leerem Feld.
  </Accordion>
</Accordions>

## Verwandte Seiten [#verwandte-seiten]

* [Verbundene Systeme](/de/connections)
* [Synchronisierung im Detail](/de/connections/sync-details)