ComposioHQ/Webex-Automation

Webex Automatisierung

Automatisieren Sie Cisco Webex Collaboration-Workflows – senden Sie Nachrichten, verwalten Sie Räume und Teams, konfigurieren Sie Webhooks und suchen Sie Personen – alles über natürliche Sprache.

Toolkit-Dokumentation: composio.dev/toolkits/webex

---

Einrichtung

1. Fügen Sie den Rube MCP Server zu Ihrer Umgebung hinzu: https://rube.app/mcp
2. Verbinden Sie Ihr Webex-Konto nach Aufforderung (OAuth-Ablauf über Composio)
3. Beginnen Sie mit der Eingabe von Befehlen in natürlicher Sprache für die Webex-Automatisierung

---

Kern-Workflows

1. Senden einer Nachricht an einen Raum oder eine Person

Senden Sie Klartext, Markdown, Dateianhänge oder Adaptive Cards an jeden Webex-Raum oder direkt an eine Person.

Tool: WEBEX_MESSAGING_CREATE_MESSAGE

Wichtige Parameter:

• roomId – ID des Zielraums (verwenden Sie WEBEX_MESSAGING_LIST_ROOMS um sie zu finden)
• toPersonEmail – stattdessen eine private 1:1-Nachricht senden (schließt sich mit roomId gegenseitig aus)
• text – Klartext-Inhalt (maximal 7439 Bytes)
• markdown – Markdown-formatierten Inhalt (hat Vorrang vor text)
• files – Liste öffentlicher URLs für Dateianhänge (eine Datei pro Nachricht)
• attachments – Adaptive Card JSON (eine Karte pro Nachricht)
• parentId – auf eine bestimmte Nachricht als verschachtelte Antwort antworten

Beispielaufforderung:

"Sende eine Markdown-Nachricht an Raum Y2lz... mit Deployment abgeschlossen und einem Link zu den Release-Notizen"

---

2. Räume auflisten und entdecken

Durchsuchen Sie alle Räume, in denen Sie Mitglied sind, gefiltert nach Typ, Team oder sortiert nach Aktivität.

Tool: WEBEX_MESSAGING_LIST_ROOMS

Wichtige Parameter:

• type – filtern nach direct (1:1) oder group
• teamId – auf Räume in einem bestimmten Team beschränken
• sortBy – sortieren nach id, lastactivity oder created
• max – Ergebnisse begrenzen (1-1000, Standard 100)

Anschließend mit WEBEX_MESSAGING_GET_ROOM_DETAILS die vollständigen Metadaten für einen bestimmten Raum abrufen, einschließlich Titel, Typ, Sperrstatus, Ersteller und Zeitstempel.

Beispielaufforderung:

"Liste meine 10 zuletzt aktiven Gruppenräume in Webex auf"

---

3. Webhooks für ereignisgesteuerte Automatisierung verwalten

Erstellen Sie Webhooks, um Echtzeit-HTTP-POST-Benachrichtigungen zu erhalten, wenn sich Webex-Ressourcen ändern.

Tool: WEBEX_WEBHOOKS_CREATE_WEBHOOK

Wichtige Parameter:

• name – menschenlesbarer Webhook-Name (erforderlich)
• targetUrl – URL, die POST-Benachrichtigungen empfängt (erforderlich)
• resource – was überwacht werden soll: messages, rooms, memberships, meetings, recordings, meetingParticipants, telephony_calls usw. (erforderlich)
• event – Auslöser-Typ: created, updated, deleted, started, ended, joined, left (erforderlich)
• filter – Benachrichtigungen eingrenzen (z. B. roomId=<id> oder hostEmail=<email>)
• secret – optionaler HMAC-Schlüssel zur Signaturprüfung der Nutzlast
• ownedBy – creator für persönliche oder org für organisationsweite Webhooks

Unterstützende Tools:

• WEBEX_LIST_WEBHOOKS – alle registrierten Webhooks auflisten mit optionalen max und ownedBy-Filtern
• WEBEX_WEBHOOKS_GET_WEBHOOK – einen bestimmten Webhook anhand der webhookId überprüfen

Beispielaufforderung:

"Erstelle einen Webhook namens 'Neue Nachrichten', der POST an https://my-app.com/hook sendet, sobald eine Nachricht in Raum Y2lz... erstellt wird"

---

4. Team-Mitgliedschaften verwalten

Personen zu Webex-Teams hinzufügen und optional Moderatorrechte gewähren.

Tool: WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP

Wichtige Parameter:

• teamId – das Team, dem die Person hinzugefügt werden soll (erforderlich)
• personEmail – E-Mail der hinzuzufügenden Person
• personId – Webex-Personen-ID (Alternative zur E-Mail)
• isModerator – auf true setzen für Moderatorzugriff (Standard false)

Verwenden Sie WEBEX_LIST_TEAMS, um zuerst verfügbare Teams zu entdecken.

Beispielaufforderung:

"Füge [email protected] als Moderator zum Team Y2lz... hinzu"

---

5. Raum-Mitgliedschaften prüfen

Überprüfen Sie, wer in einem Raum ist, bestätigen Sie die Mitgliedschaft einer bestimmten Person oder listen Sie Mitgliedschaften in Teams auf.

Tool: WEBEX_MESSAGING_LIST_MEMBERSHIPS

Wichtige Parameter:

• roomId – alle Mitglieder eines bestimmten Raums auflisten
• personEmail – prüfen, ob eine Person Mitglied ist (erfordert roomId)
• personId – prüfen anhand der Webex-Personen-ID (erfordert roomId)
• teamId – nach Team-Zugehörigkeit filtern
• max – Ergebnisse begrenzen

Beispielaufforderung:

"Liste alle Mitglieder von Raum Y2lz... auf und sage mir, wer die Moderatoren sind"

---

6. Personen suchen und nachschlagen

Suchen Sie Personen in Ihrer Webex-Organisation nach E-Mail, Anzeigename oder ID.

Tool: WEBEX_PEOPLE_LIST_PEOPLE

Verwenden Sie dies, um Namen in Personen-IDs aufzulösen, bevor Sie Direktnachrichten senden oder Team-Mitglieder hinzufügen.

Beispielaufforderung:

"Finde die Webex-Personen-ID für [email protected]"

---

Bekannte Fallstricke

Fallstrick	Details
Webhook automatische Deaktivierung	Die Ziel-URL muss mit HTTP 2xx antworten; 100 Fehler in 5 Minuten deaktivieren den Webhook automatisch
Nachrichtengrößenlimit	Sowohl text als auch markdown haben ein Maximum von 7439 Bytes
Eine Datei pro Nachricht	Das files-Array akzeptiert eine Liste, aber es wird nur ein Anhang pro Nachricht unterstützt
Eine Karte pro Nachricht	Es wird nur ein Adaptive Card Anhang pro Nachricht unterstützt
Sich gegenseitig ausschließende Ziele	roomId und toPersonEmail/toPersonId können beim Senden von Nachrichten nicht zusammen verwendet werden
Raum-Update erfordert Titel	WEBEX_UPDATE_ROOM erfordert immer den Parameter title, auch wenn nur der Sperrstatus oder das Team geändert wird
Konflikte mit orgPublicSpaces	orgPublicSpaces kann nicht mit teamId, type oder sortBy beim Auflisten von Räumen kombiniert werden
Webhook-Lesebereich	Das Erstellen eines Webhooks erfordert den read-Bereich auf dem überwachten Ressourcentyp
Mitgliedschaftsfilter erfordert roomId	Die Filter personEmail und personId beim Auflisten von Mitgliedschaften erfordern roomId, es sei denn, Sie sind ein Compliance Officer

---

Kurzübersicht

Aktion	Tool-Slug	Wichtige Parameter
Nachricht senden	WEBEX_MESSAGING_CREATE_MESSAGE	roomId, text/markdown, toPersonEmail
Räume auflisten	WEBEX_MESSAGING_LIST_ROOMS	type, sortBy, max
Raumdetails abrufen	WEBEX_MESSAGING_GET_ROOM_DETAILS	roomId
Raum aktualisieren	WEBEX_UPDATE_ROOM	roomId, title
Nachricht löschen	WEBEX_MESSAGING_DELETE_MESSAGE	messageId
Nachrichtendetails abrufen	WEBEX_MESSAGING_GET_MESSAGE_DETAILS	messageId
Webhook erstellen	WEBEX_WEBHOOKS_CREATE_WEBHOOK	name, targetUrl, resource, event
Webhooks auflisten	WEBEX_LIST_WEBHOOKS	max, ownedBy
Webhook abrufen	WEBEX_WEBHOOKS_GET_WEBHOOK	webhookId
Teammitglied hinzufügen	WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP	teamId, personEmail, isModerator
Mitgliedschaften auflisten	WEBEX_MESSAGING_LIST_MEMBERSHIPS	roomId, personEmail, max
Personen auflisten	WEBEX_PEOPLE_LIST_PEOPLE	E-Mail-, Anzeigename-, ID-Filter
Teams auflisten	WEBEX_LIST_TEAMS	max

---

Bereitgestellt von Composio