mirror of
https://github.com/simstudioai/sim.git
synced 2026-02-03 03:04:57 -05:00
253 lines
11 KiB
Plaintext
253 lines
11 KiB
Plaintext
---
|
|
title: Zoom
|
|
description: Zoom-Meetings und -Aufzeichnungen erstellen und verwalten
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="zoom"
|
|
color="#2D8CFF"
|
|
/>
|
|
|
|
{/* MANUAL-CONTENT-START:intro */}
|
|
[Zoom](https://zoom.us/) ist eine führende cloudbasierte Kommunikationsplattform für Videomeetings, Webinare und Online-Zusammenarbeit. Sie ermöglicht Benutzern und Organisationen, Meetings einfach zu planen, zu hosten und zu verwalten und bietet Tools für Bildschirmfreigabe, Chat, Aufzeichnungen und mehr.
|
|
|
|
Mit Zoom können Sie:
|
|
|
|
- **Meetings planen und verwalten**: Sofortige oder geplante Meetings erstellen, einschließlich wiederkehrender Termine
|
|
- **Meeting-Optionen konfigurieren**: Meeting-Passwörter festlegen, Warteräume aktivieren und Video/Audio der Teilnehmer steuern
|
|
- **Einladungen versenden und Details teilen**: Meeting-Einladungen und Informationen zum einfachen Teilen abrufen
|
|
- **Meeting-Daten abrufen und aktualisieren**: Auf Meeting-Details zugreifen, bestehende Meetings ändern und Einstellungen programmgesteuert verwalten
|
|
|
|
In Sim ermöglicht die Zoom-Integration Ihren Agenten die Automatisierung der Planung und Meeting-Verwaltung. Verwenden Sie Tool-Aktionen, um:
|
|
|
|
- Neue Meetings mit benutzerdefinierten Einstellungen programmgesteuert zu erstellen
|
|
- Alle Meetings für einen bestimmten Benutzer (oder sich selbst) aufzulisten
|
|
- Details oder Einladungen für jedes Meeting abzurufen
|
|
- Bestehende Meetings direkt aus Ihren Automatisierungen zu aktualisieren oder zu löschen
|
|
|
|
Um eine Verbindung zu Zoom herzustellen, fügen Sie den Zoom-Block ein und klicken Sie auf `Connect`, um sich mit Ihrem Zoom-Konto zu authentifizieren. Nach der Verbindung können Sie die Zoom-Tools verwenden, um Zoom-Meetings zu erstellen, aufzulisten, zu aktualisieren und zu löschen. Sie können Ihr Zoom-Konto jederzeit trennen, indem Sie unter Einstellungen > Integrationen auf `Disconnect` klicken, und der Zugriff auf Ihr Zoom-Konto wird sofort widerrufen.
|
|
|
|
Diese Funktionen ermöglichen es Ihnen, die Zusammenarbeit aus der Ferne zu optimieren, wiederkehrende Videositzungen zu automatisieren und die Zoom-Umgebung Ihrer Organisation als Teil Ihrer Workflows zu verwalten.
|
|
{/* MANUAL-CONTENT-END */}
|
|
|
|
## Gebrauchsanweisung
|
|
|
|
Integrieren Sie Zoom in Workflows. Erstellen, listen, aktualisieren und löschen Sie Zoom-Meetings. Erhalten Sie Meeting-Details, Einladungen, Aufzeichnungen und Teilnehmerinformationen. Verwalten Sie Cloud-Aufzeichnungen programmatisch.
|
|
|
|
## Tools
|
|
|
|
### `zoom_create_meeting`
|
|
|
|
Ein neues Zoom-Meeting erstellen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. |
|
|
| `topic` | string | Ja | Meeting-Thema |
|
|
| `type` | number | Nein | Meeting-Typ: 1=sofort, 2=geplant, 3=wiederkehrend ohne feste Zeit, 8=wiederkehrend mit fester Zeit |
|
|
| `startTime` | string | Nein | Meeting-Startzeit im ISO 8601-Format \(z.B. 2025-06-03T10:00:00Z\) |
|
|
| `duration` | number | Nein | Meeting-Dauer in Minuten |
|
|
| `timezone` | string | Nein | Zeitzone für das Meeting \(z.B. America/Los_Angeles\) |
|
|
| `password` | string | Nein | Meeting-Passwort |
|
|
| `agenda` | string | Nein | Meeting-Agenda |
|
|
| `hostVideo` | boolean | Nein | Mit eingeschaltetem Host-Video starten |
|
|
| `participantVideo` | boolean | Nein | Mit eingeschaltetem Teilnehmer-Video starten |
|
|
| `joinBeforeHost` | boolean | Nein | Teilnehmern erlauben, vor dem Host beizutreten |
|
|
| `muteUponEntry` | boolean | Nein | Teilnehmer beim Betreten stummschalten |
|
|
| `waitingRoom` | boolean | Nein | Warteraum aktivieren |
|
|
| `autoRecording` | string | Nein | Automatische Aufzeichnungseinstellung: local, cloud oder none |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `meeting` | object | Das erstellte Meeting mit allen seinen Eigenschaften |
|
|
|
|
### `zoom_list_meetings`
|
|
|
|
Alle Meetings für einen Zoom-Benutzer auflisten
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. |
|
|
| `type` | string | Nein | Meeting-Typ-Filter: scheduled, live, upcoming, upcoming_meetings oder previous_meetings |
|
|
| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite \(max. 300\) |
|
|
| `nextPageToken` | string | Nein | Token für Paginierung, um die nächste Ergebnisseite zu erhalten |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `meetings` | array | Liste der Meetings |
|
|
| `pageInfo` | object | Paginierungsinformationen |
|
|
|
|
### `zoom_get_meeting`
|
|
|
|
Details eines bestimmten Zoom-Meetings abrufen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die Meeting-ID |
|
|
| `occurrenceId` | string | Nein | Vorkommnis-ID für wiederkehrende Meetings |
|
|
| `showPreviousOccurrences` | boolean | Nein | Frühere Vorkommnisse für wiederkehrende Meetings anzeigen |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `meeting` | object | Die Meeting-Details |
|
|
|
|
Details eines bestimmten Zoom-Meetings abrufen
|
|
|
|
Ein bestehendes Zoom-Meeting aktualisieren
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die zu aktualisierende Meeting-ID |
|
|
| `topic` | string | Nein | Meeting-Thema |
|
|
| `type` | number | Nein | Meeting-Typ: 1=sofort, 2=geplant, 3=wiederkehrend ohne feste Zeit, 8=wiederkehrend mit fester Zeit |
|
|
| `startTime` | string | Nein | Meeting-Startzeit im ISO 8601-Format \(z.B. 2025-06-03T10:00:00Z\) |
|
|
| `duration` | number | Nein | Meeting-Dauer in Minuten |
|
|
| `timezone` | string | Nein | Zeitzone für das Meeting \(z.B. Europe/Berlin\) |
|
|
| `password` | string | Nein | Meeting-Passwort |
|
|
| `agenda` | string | Nein | Meeting-Agenda |
|
|
| `hostVideo` | boolean | Nein | Mit eingeschaltetem Host-Video starten |
|
|
| `participantVideo` | boolean | Nein | Mit eingeschaltetem Teilnehmer-Video starten |
|
|
| `joinBeforeHost` | boolean | Nein | Teilnehmern erlauben, vor dem Host beizutreten |
|
|
| `muteUponEntry` | boolean | Nein | Teilnehmer beim Betreten stummschalten |
|
|
| `waitingRoom` | boolean | Nein | Warteraum aktivieren |
|
|
| `autoRecording` | string | Nein | Automatische Aufzeichnungseinstellung: local, cloud oder none |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `success` | boolean | Ob das Meeting erfolgreich aktualisiert wurde |
|
|
|
|
Ein Zoom-Meeting löschen
|
|
|
|
Ein Zoom-Meeting löschen oder abbrechen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die zu löschende Meeting-ID |
|
|
| `occurrenceId` | string | Nein | Occurrence-ID zum Löschen eines bestimmten Termins eines wiederkehrenden Meetings |
|
|
| `scheduleForReminder` | boolean | Nein | Erinnerungs-E-Mail zur Stornierung an Teilnehmer senden |
|
|
| `cancelMeetingReminder` | boolean | Nein | Stornierungs-E-Mail an Teilnehmer und alternative Hosts senden |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `success` | boolean | Ob das Meeting erfolgreich gelöscht wurde |
|
|
|
|
### `zoom_get_meeting_invitation`
|
|
|
|
Den Einladungstext für ein Zoom-Meeting abrufen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die Meeting-ID |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `invitation` | string | Der Meeting-Einladungstext |
|
|
|
|
### `zoom_list_recordings`
|
|
|
|
Alle Cloud-Aufzeichnungen eines Zoom-Benutzers auflisten
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `userId` | string | Ja | Die Benutzer-ID oder E-Mail-Adresse. Verwenden Sie "me" für den authentifizierten Benutzer. |
|
|
| `from` | string | Nein | Startdatum im Format yyyy-mm-dd (innerhalb der letzten 6 Monate) |
|
|
| `to` | string | Nein | Enddatum im Format yyyy-mm-dd |
|
|
| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite (max. 300) |
|
|
| `nextPageToken` | string | Nein | Token für die Paginierung, um die nächste Ergebnisseite zu erhalten |
|
|
| `trash` | boolean | Nein | Auf true setzen, um Aufzeichnungen aus dem Papierkorb aufzulisten |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `recordings` | array | Liste der Aufzeichnungen |
|
|
| `pageInfo` | object | Paginierungsinformationen |
|
|
|
|
Alle Aufzeichnungen für ein bestimmtes Zoom-Meeting abrufen
|
|
|
|
Alle Aufzeichnungen für ein bestimmtes Zoom-Meeting abrufen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die Meeting-ID oder Meeting-UUID |
|
|
| `includeFolderItems` | boolean | Nein | Elemente innerhalb eines Ordners einbeziehen |
|
|
| `ttl` | number | Nein | Gültigkeitsdauer für Download-URLs in Sekunden \(max. 604800\) |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `recording` | object | Die Meeting-Aufzeichnung mit allen Dateien |
|
|
|
|
Cloud-Aufzeichnungen für ein Zoom-Meeting löschen
|
|
|
|
Cloud-Aufzeichnungen für ein Zoom-Meeting löschen
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die Meeting-ID oder Meeting-UUID |
|
|
| `recordingId` | string | Nein | Spezifische Aufzeichnungsdatei-ID zum Löschen. Wenn nicht angegeben, werden alle Aufzeichnungen gelöscht. |
|
|
| `action` | string | Nein | Löschaktion: "trash" \(in Papierkorb verschieben\) oder "delete" \(dauerhaft löschen\) |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `success` | boolean | Ob die Aufzeichnung erfolgreich gelöscht wurde |
|
|
|
|
Teilnehmer eines vergangenen Zoom-Meetings auflisten
|
|
|
|
Teilnehmer eines vergangenen Zoom-Meetings auflisten
|
|
|
|
#### Eingabe
|
|
|
|
| Parameter | Typ | Erforderlich | Beschreibung |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `meetingId` | string | Ja | Die vergangene Meeting-ID oder UUID |
|
|
| `pageSize` | number | Nein | Anzahl der Datensätze pro Seite \(max. 300\) |
|
|
| `nextPageToken` | string | Nein | Token für Paginierung, um die nächste Ergebnisseite zu erhalten |
|
|
|
|
#### Ausgabe
|
|
|
|
| Parameter | Typ | Beschreibung |
|
|
| --------- | ---- | ----------- |
|
|
| `participants` | array | Liste der Meeting-Teilnehmer |
|
|
| `pageInfo` | object | Paginierungsinformationen |
|
|
|
|
## Hinweise
|
|
|
|
- Kategorie: `tools`
|
|
- Typ: `zoom`
|