Bots und Webhooks

Bots sind automatisierte Mitglieder eines Space. Sie beantworten Slash-Befehle, posten Nachrichten mit Buttons und Menüs, öffnen kleine Formulare und können Routinearbeit übernehmen, etwa neue Mitglieder begrüßen oder Neuigkeiten posten. Coviqo kennt drei Arten:

Bots erkennen#

• Nachrichten von Bots tragen neben dem Namen ein Abzeichen BOT. Nachrichten von einem eingehenden Webhook zeigen den eigenen Namen und das Bild des Webhooks mit einem Abzeichen APP.
• Bots, die künstliche Intelligenz nutzen, sind bei jeder Nachricht mit dem Label KI gekennzeichnet, wie es die KI-Verordnung der EU verlangt.
• Bots sind keine Menschen: Sie können sich nicht anmelden und zählen nicht als Mitglieder oder Plätze deines Tarifs. Manchen Bots kannst du Direktnachrichten schicken (siehe Direktnachrichten mit Bots).

Bots in diesem Raum#

Die Rauminfo zeigt Bots in diesem Raum: jeden Bot, der den Raum sehen kann, wer ihn betreibt, wo sein Server steht, einen Link zu seinen Datenschutzhinweisen und was er hier liest – zum Beispiel „liest alle Nachrichten in diesem Raum“, „liest Dateien, Notizen und Aufgaben“, „sieht, wer online ist“, „kann im Sprachkanal zuhören“ oder „erhält Transkripte und Zusammenfassungen abgeschlossener Besprechungen“. Ein Bot, der im Raum nicht schreiben darf, ist mit „schreibt hier nicht“ markiert.

In einem Sprachraum wird ein zuhörender Bot für alle mit Bot hört zu angezeigt, und Bots erscheinen in der Teilnehmerliste mit dem Abzeichen BOT. In einem Meeting zeigt Bot erhält Transkript, welche Bots das fertige Transkript und die Zusammenfassung bekommen.

Bots nutzen#

Slash-Befehle#

Tippe / in das Nachrichtenfeld. Es erscheint eine Liste Befehle der Bots in diesem Raum, jeweils mit dem Namen des Bots und einer kurzen Beschreibung. Wähle einen Befehl und ergänze seine Optionen als name:value. Werte mit Leerzeichen setzt du in Anführungszeichen:

/poll question:"Lunch today?" options:"Pizza; Pasta; Salad" hours:2

Die Liste erklärt, welchen Typ jede Option erwartet (Text, ganze Zahl, ja/nein, @Person, Raum oder Rolle), und sagt dir vor dem Senden, wenn etwas fehlt oder ungültig ist. Legt der Bot Grenzen fest, siehst du den erlaubten Bereich neben der Option – zum Beispiel 1–10 bei einer Zahl oder ≤ 100 Zeichen bei einem Text – und einen Hinweis wie „days“ darf höchstens 7 sein, wenn ein Wert nicht passt. Befehle siehst du nur, wenn du im Raum Bots nutzen darfst und der Bot den Raum sehen und darin schreiben kann.

Manche Optionen schlagen dir beim Tippen Werte vor (in der Optionsliste mit einer kleinen Lupe markiert). Sobald du den Wert zu tippen beginnst, erscheint über dem Nachrichtenfeld eine Liste Vorschläge. Wähle mit den Pfeiltasten und Enter oder Tab oder per Klick; Escape schließt die Liste. Der Wert wird für dich eingesetzt (mit Anführungszeichen, wenn er Leerzeichen enthält). Manche Vorschläge haben eine kurze zweite Zeile mit Details. Ist der Bot langsam oder offline, erscheinen einfach keine Vorschläge – du kannst den Wert jederzeit selbst tippen.

Bei einer Raum-Option erscheint eine Liste Räume für … mit den Räumen des Space, sobald du den Wert zu tippen beginnst; wähle einen aus, und er wird für dich eingesetzt. Akzeptiert der Bot nur Sprachräume oder nur Texträume, zeigt die Liste nur diese, und du bekommst einen Hinweis wie „to“ akzeptiert nur Sprachräume, wenn du einen anderen Raum einträgst.

Buttons, Menüs und Formulare#

Bot-Nachrichten können Buttons und Auswahlmenüs haben. Klicke auf einen Button oder wähle etwas aus dem Menü, und der Bot reagiert – er aktualisiert zum Beispiel die Nachricht (etwa die Stimmenzahlen einer Abstimmung), postet eine Antwort oder öffnet ein Formular. Ein Formular zeigt oben den Namen des Bots („Formular von {bot}“); fülle die Felder aus und klicke auf Absenden. Manche Bots zeigen erst „{bot} denkt nach …“ und öffnen das Formular einen Moment später – es erscheint nur in dem Fenster, in dem du geklickt hast, und ein Bot kann es nur innerhalb einer Minute öffnen. Bots nutzen Formulare zum Beispiel für Meldungen oder Bewerbungen: Was du eintippst, geht an den Bot.

Manche Formulare fragen nach Dateien – zum Beispiel Screenshots für eine Clan-Bewerbung. Zieh die Dateien auf das Feld oder klicke auf Dateien auswählen; das Feld zeigt, wie viele Dateien und welche Größe und Typen erlaubt sind. Jede Datei wird hochgeladen und zuerst auf Schadsoftware geprüft („Wird auf Schadsoftware geprüft …“) – erst danach kannst du das Formular absenden. Zu große Dateien, Dateitypen, die der Bot nicht annimmt, und vom Virenscanner blockierte Dateien sind rot markiert; entferne sie mit ×. Die Dateien gehen nur an den Bot, der danach gefragt hat: Sie erscheinen nicht in den Dateien des Raums oder in der Suche, und Coviqo löscht sie nach drei Tagen (Dateien eines nicht abgeschickten Formulars nach einem Tag). Der Bot kann eine eigene Kopie behalten – sieh dir seine Datenschutzhinweise an.

Antworten, die nur du siehst#

Manche Antworten sind mit Nur für dich sichtbar gekennzeichnet. Niemand sonst sieht sie, und sie werden nicht gespeichert: Sie verschwinden, wenn du die Seite neu lädst, und du kannst sie vorher mit Ausblenden schließen. Buttons in solchen Antworten funktionieren 15 Minuten lang. Manche Bots lassen eine solche Antwort nach kurzer Zeit von selbst verschwinden (zum Beispiel eine Bestätigung „Gespeichert“) – sie zeigt dann zusätzlich Verschwindet automatisch und blendet sich kurz vorher sanft aus (ohne Animation, wenn dein System Bewegungen reduziert). Sie verschwindet auf allen deinen Geräten und kommt nicht wieder.

Braucht ein Bot einen Moment, siehst du „{bot} denkt nach …“, bis die Antwort kommt. Reagiert der Bot nicht, sagt dir Coviqo, dass er nicht antworten konnte.

Bots installieren und verwalten (Space-Admins)#

Du brauchst im Space die Berechtigung Bots verwalten (bots.manage). Eigentümer und Administratoren haben sie.

Einen Bot installieren#

Eine entwickelnde Person gibt dir den Installationslink des Bots (…/bots/install/<id>), oder du findest den Bot im Bot-Verzeichnis (siehe unten). Beim Öffnen erscheint der Installationsdialog:

1. Wähle den Space. Auswählen kannst du nur Spaces, in denen du Bots verwalten darfst; der Dialog zeigt außerdem, wie viele Bots der Space hat und welche Grenze sein Tarif setzt.
2. Prüfe die Berechtigungen, die der Bot anfragt. Sie sind wie im Rollen-Editor gruppiert, und jede ist ein Kontrollkästchen: Entferne das Häkchen bei allem, was du nicht gewähren willst. Du kannst nur Berechtigungen vergeben, die du selbst hast. Moderationsrechte (zum Beispiel Nachrichten anderer löschen oder Mitglieder in ein Timeout schicken) zeigen eine zusätzliche Warnung.
3. Prüfe die Datenzugriffe. Manche Zugriffe sind immer enthalten (Befehle und Buttons, die Mitgliederliste mit Namen und Rollen). Weitergehende Zugriffe – alle Nachrichten in den Räumen lesen, die der Bot sehen kann, Dateien, Notizen und Aufgaben lesen, sehen, wer online ist, in Sprachräumen zuhören, Meeting-Transkripte erhalten Tickets lesen und bearbeiten (Tickets lesen, Tickets schreiben und ändern – siehe Tickets), Tickets im Namen beliebiger Mitglieder öffnen (Tickets im Auftrag von Mitgliedern öffnen), im Namen der meldenden Person oder der Beteiligten auf Tickets antworten (Auf Tickets im Auftrag von Mitgliedern antworten), Räume und Raumrechte verwalten (Räume und Raumrechte verwalten), sehen, wer bei Terminen zu- oder abgesagt hat (Zusagen zu Terminen), Team-Einstellungen ändern (Team-Einstellungen verwalten), sich im Namen beliebiger Mitglieder bei Teams bewerben oder auf Termine antworten (Im Auftrag von Mitgliedern bei Teams bewerben, Im Auftrag von Mitgliedern auf Termine antworten) – musst du einzeln ankreuzen. Zuhören in Sprachräumen setzt Community Pro oder höher voraus, Meeting-Transkripte Business oder Enterprise; enthält dein Tarif sie nicht, werden sie zwar angezeigt, lassen sich aber nicht ankreuzen.
4. Lies, wer den Bot betreibt, wo sein Server steht, seine Datenschutzhinweise und ob er KI nutzt. Ein eigener Bot erhält die Inhalte, mit denen er arbeitet, in lesbarer Form – installiere also nur Bots, denen du vertraust.
5. Klicke auf Installieren.

Der Bot tritt dem Space mit einer eigenen Rolle „Bot: <name>“ bei. Niemand kann einem Bot das Recht geben, den Space zu administrieren, Rollen, Abrechnung oder das Audit-Log zu verwalten oder andere Bots zu verwalten.

Ändern, was ein Bot darf#

Öffne Space-Einstellungen › Apps & Integrationen › Bots und wähle den Bot aus:

• Übersicht: Profil, Betreiber, Befehle, wer ihn installiert hat.
• Berechtigungen: Setze oder entferne jederzeit Häkchen bei den Berechtigungen der Bot-Rolle – auch hier nur bei Berechtigungen, die du selbst hast.
• Räume: Erlaube oder verweigere Berechtigungen für einzelne Räume, genau wie Raumberechtigungen für eine Rolle. Um einen Bot aus einem Raum herauszuhalten, verweigere dort Räume sehen.
• Datenzugriff: Genehmige weitergehende Datenzugriffe oder ziehe sie zurück. Für Meeting-Transkripte wählst du außerdem die Räume, deren Meetings der Bot erhalten darf.

Die Rolle des Bots erscheint im Rollen-Editor mit dem Hinweis „Von Bot verwaltet“; sie kann dort weder Personen zugewiesen noch bearbeitet oder gelöscht werden. Einen Bot kannst du auch nicht kicken oder bannen – pausiere oder entferne ihn stattdessen.

Einen Bot Rollen vergeben lassen#

Manche Bots (zum Beispiel ein Clan-Bot, der Ränge von einer anderen Plattform übernimmt) fragen den Datenzugriff Rollen vergeben an. Nachdem du ihn unter Datenzugriff freigegeben hast, öffne auf der Bot-Seite den Reiter Rollen vergeben und hake die Rollen an, die der Bot Mitgliedern geben und wieder nehmen darf. Die Liste bietet nur Rollen unterhalb der Bot-Rolle an – ziehe die Bot-Rolle unter Rollen vorher darüber. Rollen, die kicken, bannen, stummschalten oder einladen dürfen, und Rollen mit Sonderrechten wie Gesprächsleiter oder Soundboard gehen nur mit dem Schalter Rollen mit Moderationsrechten erlauben – ein Warnhinweis erinnert daran, dass der Bot dann Moderationsrechte verteilen kann. Rollen mit Admin-Rechten (zum Beispiel Administrator oder Space verwalten) gehen nur mit dem Schalter Rollen mit Admin-Rechten erlauben und nur, wenn sie unter der Bot-Rolle liegen. Einschalten und solche Rollen anhaken können nur der Inhaber und Administratoren; vorher bestätigst du eine Warnung, denn der Bot kann dann jede Person zum Admin machen – auch deine Co-Admins – oder Admin-Rollen wegnehmen. Der Bot kann allen Mitgliedern Rollen geben und nehmen, auch dem Inhaber; die Inhaberschaft selbst ist keine Rolle, der Inhaber behält immer alle Rechte. Zum Ändern der Liste brauchst du das Recht Rollen verwalten. Jede Änderung des Bots steht mit dem Bot als Akteur im Audit-Log.

Wer über welche Einladung kam#

Unter Space-Einstellungen › Einladungen & Beitritt › Einladungen zeigt jede Einladung, wie viele Leute darüber beigetreten und noch Mitglied sind (N beigetreten (aktiv)). Die Mitgliederliste zeigt unter dem Beitrittsdatum, wie jemand dazukam – zum Beispiel Über Einladung aB3dE7 von Ada, Über den Link /deinname oder Über Single Sign-on. Das sehen nur Leute, die einladen oder Mitglieder verwalten dürfen. Bei Mitgliedern, die vor der Einführung beigetreten sind, steht nichts.

Einen Bot Räume verwalten lassen#

Mit dem Datenzugriff Räume und Raumrechte verwalten und den Berechtigungen Räume erstellen / Räume verwalten kann ein Bot Räume und Kategorien anlegen, bearbeiten, archivieren und löschen – zum Beispiel ein Clan-Bot, der für jeden Trupp einen Sprachraum öffnet – und Raumrechte setzen. Rechte ändert er nur für Rollen unterhalb seiner eigenen Rolle und vergibt nur, was er selbst darf; Admins und andere Bots sind nie betroffen. Ein Bot legt höchstens 50 Räume und Kategorien pro Tag an. Mit Mitglieder verschieben kann er Leute außerdem in einen anderen Sprachraum verschieben oder trennen, aber nie Leute mit einer höheren Rolle. Alles steht mit dem Bot als Akteur im Audit-Log.

Tickets, Termine und Foren#

• Ein Bot kann für dich ein Ticket öffnen, nachdem du einen seiner Buttons oder eines seiner Formulare benutzt hast (zum Beispiel Melden). Mit dem Datenzugriff Tickets im Auftrag von Mitgliedern öffnen, den ein Admin freigibt, kann er auch für beliebige Mitglieder Tickets öffnen – zum Beispiel aus einem Formular auf eurer Clan-Website. Solche Tickets zeigen Erstellt von {bot} im Auftrag von {name}, die Liste zeigt über {bot}. Du bekommst die üblichen Ticket-Benachrichtigungen. Bots können auch Dateien an Tickets hängen; dabei gelten die üblichen Größengrenzen, der Speicher und der Virenscan. Ein Bot kann ein Ticket, das er für sich selbst geöffnet hat, auch nachträglich an dich übergeben (zum Beispiel eine ältere Anfrage von der Website); das Ticket zeigt dann denselben Hinweis, der Verlauf zeigt Melder: {bot} → {name}. Ein Bot mit dem Recht, Tickets zu bearbeiten – oder der Bot, der das Ticket geöffnet hat – kann die Beschreibung korrigieren; der Verlauf zeigt dann Beschreibung bearbeitet. Ein Bot kann auch in deinem Namen auf ein Ticket antworten, das du eröffnet hast oder verfolgst – direkt nachdem du einen seiner Buttons oder eines seiner Formulare benutzt hast, oder mit dem Datenzugriff Auf Tickets im Auftrag von Mitgliedern antworten (zum Beispiel, um deine Antwort per E-Mail weiterzugeben). Eine solche Antwort zählt als deine und zeigt über {bot}; das Team wird wie üblich benachrichtigt.
• Mit Zusagen zu Terminen sieht ein Bot, wer bei Terminen in Räumen, die er sehen kann, zugesagt, abgesagt oder „vielleicht“ geantwortet hat. Er kann Termine absagen, die er selbst erstellt hat, oder alle Termine, wenn er Termine verwalten hat. Er kann einen Termin auch in einen anderen Raum verschieben – mit Termine verwalten im bisherigen und im neuen Raum (eigene Termine: Termine erstellen im neuen Raum); Antworten, Tickets und Erinnerungen bleiben erhalten, genau wie wenn eine Person ihn verschiebt (siehe Kalender und Termine).
• Ein Bot kann sich für dich bei einem Team bewerben oder auf einen Termin antworten, direkt nachdem du einen seiner Buttons oder eines seiner Formulare benutzt hast. Mit Im Auftrag von Mitgliedern bei Teams bewerben oder Im Auftrag von Mitgliedern auf Termine antworten, die ein Admin freigibt, kann er das für beliebige Mitglieder tun – zum Beispiel aus einem Bewerbungsformular auf eurer Website. Solche Bewerbungen und Antworten zeigen über {bot} – im Bewerbungs-Posteingang, unter Meine Bewerbungen und in der Teilnehmerliste des Termins. Es gelten die üblichen Regeln (das Team muss Bewerbungen annehmen, der Termin freie Plätze haben). Eine Bewerbung kannst du wie gewohnt zurückziehen; antwortest du selbst auf den Termin, verschwindet die Markierung.
• Mit Team-Einstellungen verwalten und der Berechtigung Teams verwalten kann ein Bot Teams des Space umbenennen, festlegen, wie man beitritt (offen, per Bewerbung, nur auf Einladung), und die Bewerbungsfrage setzen. Ein Team, das (oder dessen übergeordnetes Team) Raumrechte vergibt, die der Bot selbst nicht hat, kann er nicht für alle öffnen.
• In Forum-Räumen schreiben Bots Beiträge und Antworten wie Menschen, mit denselben Rechten und Tag-Regeln.

Pausieren und entfernen#

• Pausieren stoppt den Bot in diesem Space sofort; seine Befehle verschwinden. Du kannst ihn jederzeit fortsetzen.
• Entfernen nimmt den Bot zusammen mit seiner Rolle aus dem Space. Seine bisherigen Nachrichten bleiben erhalten.

Jede Installation, Änderung und Entfernung wird im Aktivitäts-Feed für Moderierende und im Audit-Log festgehalten. Was ein Bot selbst tut – zum Beispiel eine Nachricht löschen oder ein Mitglied in ein Timeout schicken –, erscheint dort mit dem Bot als handelnder Instanz.

Bot-Verzeichnis#

Das Bot-Verzeichnis (über Space-Einstellungen › Apps & Integrationen › Bots oder …/bots/directory) listet Bots, die der Betreiber deines Coviqo-Servers geprüft hat. Suche nach Namen, filtere nach Kategorie und öffne einen Bot, um seine Beschreibung, Screenshots, die angefragten Berechtigungen und Datenzugriffe, den Betreiber, den Serverstandort und seine Datenschutzhinweise zu sehen. Ein Abzeichen Verifiziert bedeutet, dass der Betreiber geprüft hat, wer den Bot betreibt. Installieren öffnet den üblichen Installationsdialog. Bot melden schickt eine Meldung an das Trust-&-Safety-Team des Betreibers.

Bots, die nicht im Verzeichnis stehen, lassen sich weiterhin über ihren Installationslink installieren.

Direktnachrichten mit Bots#

Du kannst einem Bot schreiben, der in einem deiner Spaces installiert ist, oder einem Bot aus dem Verzeichnis: Öffne den Bot unter Bots in diesem Raum und wähle Nachricht senden. Unterhaltungen mit Bots zeigen in deinen Direktnachrichten das Abzeichen BOT.

• Ein Bot antwortet erst, nachdem du ihm geschrieben oder einen seiner Befehle oder Buttons genutzt hast. Er beginnt nie von sich aus eine Unterhaltung.
• Ein Bot sieht nur Unterhaltungen, an denen er beteiligt ist – nie deine anderen Nachrichten.
• Bot blockieren in der Unterhaltung verhindert, dass der Bot dir schreibt; du kannst die Blockierung jederzeit aufheben.
• Bots lassen sich nicht zu Gruppenunterhaltungen hinzufügen.

Bots in Sprachräumen#

Ab Community Pro können Bots Sprachräumen beitreten – zum Beispiel, um Musik abzuspielen oder Ansagen vorzulesen. Sie erscheinen in der Teilnehmerliste mit dem Abzeichen BOT.

• Ein Bot kann den Raum nur hören, wenn ein Admin für ihn „In Sprachkanälen zuhören“ genehmigt hat. Solange ein solcher Bot im Raum ist, sehen alle Bot hört zu.
• Ein Bot kann nur dort sprechen, wo er sprechen darf – wie Menschen auch. Bots nutzen nie Video oder Bildschirmfreigabe.
• Bots treten nie Meetings oder Direktanrufen bei. In Räumen, die externe Gäste sehen können, dürfen Bots nur beitreten, wenn jemand, der den Raum verwaltet, in den Raumeinstellungen (Sprache & Medien › Audio & Video) Bots dürfen trotz externer Gäste beitreten eingeschaltet hat.

Coviqo-Bots#

Coviqo-Bots richtest du unter Space-Einstellungen › Apps & Integrationen › Bots › Coviqo-Bots ein. Du brauchst die Berechtigung Coviqo-Bots erstellen (bots.create) oder Bots verwalten. Jeder Coviqo-Bot ist ein eigener Bot mit einem änderbaren Namen, einem Bild, einer eigenen Rolle und einem Schalter zum Ausschalten. Er zählt zur Bot-Grenze deines Tarifs. Seine Rolle erhält nur Berechtigungen, die du selbst hast.

Eingehende Webhooks#

Über einen eingehenden Webhook kann ein anderes Werkzeug Nachrichten in einen Raum posten – zum Beispiel „Build 128 erfolgreich“ von deinem Build-Server. Du richtest sie unter Space-Einstellungen › Apps & Integrationen › Bots › Webhooks ein (dafür brauchst du Bots verwalten):

1. Klicke auf Webhook erstellen, wähle den Raum, gib einen Namen und optional ein Bild an.
2. Kopiere die Adresse. Sie wird nur einmal angezeigt – behandle sie wie ein Passwort, denn alle, die sie kennen, können in den Raum posten.
3. Trage sie im anderen Werkzeug ein. Das Werkzeug sendet eine Nachricht als JSON, zum Beispiel {"content": "Build 128 succeeded"}.

Nachrichten erscheinen mit dem Namen und Bild des Webhooks – auch in Benachrichtigungen, wenn dich eine Webhook-Nachricht erwähnt. Im Hintergrund werden sie im Namen der Person gepostet, die den Webhook erstellt hat; diese Person muss also im Raum schreiben dürfen. Verlässt sie den Space oder verliert sie dieses Recht, funktioniert der Webhook nicht mehr, bis ein anderer Admin auf Übernehmen klickt. URL neu erzeugen erstellt eine neue Adresse und macht die alte sofort ungültig; außerdem kannst du einen Webhook ausschalten oder löschen. Bearbeiten oder löschen kannst du nur Webhooks von Räumen, die du selbst sehen kannst.

Tarifgrenzen#

Der Betreiber deines Servers kann andere Grenzen festlegen. Ist eine Grenze erreicht, kannst du erst wieder Bots installieren oder erstellen, wenn du einen entfernst oder den Tarif wechselst (siehe das Kapitel Tarife und Abrechnung).

Für Entwickler#

Alle mit einem regulären Konto können unter Einstellungen › Entwickler eigene Bots bauen:

• Bot anlegen: Du bekommst ein Token (wird einmal angezeigt, kann erneuert werden) und einen öffentlichen Schlüssel.
• Interaktions-URL: die https-Adresse deines Bots, an die Coviqo Befehle, Button-Klicks und abgeschickte Formulare sendet. Coviqo prüft sie beim Speichern: Dein Server muss eine signierte Testanfrage beantworten und eine mit falscher Signatur ablehnen.
• Details: Betreiber, Serverstandort, Link zur Datenschutzerklärung und ob dein Bot KI nutzt – wird Admins im Installationsdialog angezeigt.
• Berechtigungen und Datenzugriffe, die dein Bot anfragt, und der Installationslink. Schalte Öffentlich installierbar ein, damit andere ihn installieren können; sonst kannst nur du es.
• Installationen: wo dein Bot installiert ist, mit einer Warnung, wo ein Admin weniger Berechtigungen gewährt hat als angefragt.
• Ereignisse: eine https-Adresse, die signierte Ereignisse empfängt (neue Nachrichten, beitretende Mitglieder, Aufgaben, Datei-Uploads und mehr), welche Ereignisse du haben willst, und ein Protokoll der letzten 100 Zustellungen mit Erneut senden. Coviqo testet die Adresse beim Speichern. Schlagen Zustellungen einen Tag lang fehl, stoppt Coviqo sie und sagt dir Bescheid; Wieder aktivieren startet sie neu. Statt über eine Adresse kann sich dein Bot auch mit dem WebSocket-Gateway verbinden.
• Bot-Verzeichnis: Reiche deinen Bot mit einer Kurz- und einer Langbeschreibung, Kategorien und Screenshots ein. Der Betreiber prüft ihn; du bekommst eine Benachrichtigung, wenn er angenommen oder abgelehnt wurde. Änderungen an Berechtigungen, Datenzugriffen oder Adressen schicken den Eintrag erneut in die Prüfung.

Entwicklermodus: IDs finden#

Bots sprechen Spaces, Räume, Personen, Rollen und alles andere über ihre ID an. Schalte Einstellungen › Darstellung › Entwicklermodus ein (standardmäßig aus, wird mit deinem Konto gespeichert), um sie zu sehen:

• ID kopieren in den Menüs (Rechtsklick oder …) von Spaces, Kategorien, Räumen, Nachrichten, Personen (Mitgliederliste, Chat, Profil …), Teams, Terminen, Meetings, Aufgaben, Notizen, Dateien, Ordnern, Tickets und Direktnachrichten. In Space-Einstellungen › Rollen per Rechtsklick auf eine Rolle; unter Einladungen kopiert der Fingerabdruck-Button die Einladungs-ID.
• Kästen Für Entwickler mit den IDs und einem Kopieren-Button: Raumeinstellungen › Allgemein (Raum-, Space- und Kategorie-ID), Space-Einstellungen › Übersicht (Space-ID), Rollen (Rollen-ID und die Erwähnung <@&id>), Übersicht eines installierten Bots (Anwendungs-, Installations-, Bot-Nutzer- und Rollen-ID) und jeder eingehende Webhook (Webhook-ID, URL ohne Secret, Raum-ID).

Ohne Entwicklermodus ist davon nichts zu sehen. Einstellungen › Entwickler zeigt je Bot immer IDs und Endpunkte – Anwendungs-ID, Bot-Nutzer-ID, seine Erwähnung <@id>, API-Basis-URL, Gateway und OpenAPI-Datei dieser Installation (wichtig, wenn Coviqo auf deinem eigenen Server läuft) – mit Links zu Ratenbegrenzung und Fehlercodes sowie für jede Installation Space- und Installations-ID. Diese Instanz zeigt dieselben URLs und deine eigene Nutzer-ID schon vor dem ersten Bot. Der öffentliche Schlüssel prüft Interaktionen und Ereignisse; ein neues Token gibt es unter Schlüssel und Token.

Login-Apps („Mit Coviqo anmelden“): Im selben Bereich kannst du eine Website oder App registrieren, bei der sich Menschen mit ihrem Coviqo-Konto anmelden können – du bekommst eine Client-ID und ein Secret (siehe Integrationen › Mit Coviqo anmelden; die Entwickler-Referenz hat ein eigenes Kapitel dazu).

Die Entwickler-Referenz – Token-Schnittstelle, Befehle, Buttons, Formulare, Signaturen, Ereignisse und Grenzen – ist öffentlich auf der Website unter /developers zu finden (auf Englisch, mit einer OpenAPI-3.1-Beschreibung für Postman / Insomnia und dem Beispiel-SDK zum Herunterladen; der Entwicklerbereich verlinkt darauf). Weitere Interna stehen in der Technischen Dokumentation (Kapitel Bot-Plattform) und in docs/BOTS.md. Ein kleines Node-Beispiel liegt in examples/bot-sdk.