Werkzeuge · Support
MCP-Tools für das Modul Support (Coworking): Tickets mit Fotos öffnen, die Warteschlange und Meine Tickets auflisten, sichten, zuweisen, lösen, interne Notiz, abbrechen, wieder öffnen, Fotos und Fristen, dazu die Konfiguration, wer antwortet und welche Frist pro Kategorie gilt.
Das Modul Support über den Assistenten: Der Resident öffnet und verfolgt Tickets (mit Fotos), das Team sichtet die Warteschlange, antwortet, schreibt interne Notizen und löst Tickets, und der Administrator konfiguriert, wer antwortet und welche Fristen gelten. Die Rollen sind die der Oberfläche: Der Assistent tut nie mehr, als die angemeldete Person tun würde.
Jedes Tool hat ein Siegel: Nur lesen ändert nichts, Ändert legt sofort etwas an oder ändert es, und Mit Bestätigung handelt erst nach deinem Ja zu einer Zusammenfassung. Siehe Geld und Bestätigung.
Kurz gesagt
| Tool | Was es tut | Mindestrolle | Typ |
|---|---|---|---|
get_support_space_settings | Wie der Bereich funktioniert: Limits, Fristen und, für das Team, wer antwortet | Jede | Nur lesen |
get_support_overview | Die Warteschlange in Zahlen | Moderator oder Finanzen | Nur lesen |
list_support_tickets | Die ganze Warteschlange, mit Filtern und Fristen | Moderator oder Finanzen | Nur lesen |
list_my_support_tickets | Deine Tickets | Jede | Nur lesen |
get_support_ticket | Ein Ticket mit der Unterhaltung und den Fotos | Jede (der Resident liest seine) | Nur lesen |
get_support_resource_open_count | Wie viele offene Tickets ein Element hat | Jede | Nur lesen |
create_support_ticket | Öffnet ein Ticket, mit Fotos | Jede | Ändert |
update_support_ticket | Sichtung: Status, Priorität, Kategorie, Zuständigkeit, Ort | Moderator oder Finanzen, und die Kategorie beantworten | Ändert |
add_support_comment | Kommentiert oder schreibt eine interne Notiz | Jede (die Notiz nur, wer antwortet) | Ändert |
cancel_support_ticket | Bricht ein Ticket ab | Jede (der Resident seines) | Mit Bestätigung |
reopen_support_ticket | Öffnet ein Ticket wieder | Jede (der Resident sein gelöstes) | Ändert |
add_support_photo | Hängt ein Foto an | Jede | Ändert |
replace_support_photo | Ersetzt ein Foto durch ein anderes | Jede | Ändert |
remove_support_photo | Entfernt ein Foto | Jede | Mit Bestätigung |
delete_support_comment | Löscht eine Nachricht der Unterhaltung | Administrator | Mit Bestätigung |
delete_support_ticket | Löscht ein Ticket und die Fotos | Administrator | Mit Bestätigung |
Nach Rolle sehen Eigentümer und Administrator alle 16; Moderator und Finanzen 14; das Mitglied 11. Das Team sind Eigentümer, Administrator, Moderator und Finanzen, aber wer antwortet (sichten, zuweisen, antworten, Notizen schreiben), ist nur, wer zur Auswahl der Kategorie gehört; außerhalb davon lehnt die API mit einem übersetzten 403 ab, und der Assistent sagt das. Siehe Wer antwortet.
Den Bereich legst du mit create_space und module: "support" an; update_space ändert nur, was du mitschickst.
Die Konfiguration des Bereichs
Das Argument support von create_space und update_space akzeptiert (was du schickst, wird mit dem Bestehenden zusammengeführt):
| Feld | Typ | Beschreibung |
|---|---|---|
allow_urgent_flag | wahr oder falsch | Der Resident kann „Es ist dringend“ setzen (wird zu hoher Priorität). Voreinstellung: ja |
max_open_per_member | 0 bis 1000 | Offene Tickets pro Resident; 0 = kein Limit. Voreinstellung: 10 |
location_hint | Text bis 200 | Der Hinweis im Feld „Ort“ |
default_assignee_id | ID oder null | Wer neue Tickets erhält |
responders | Objekt | Wer antwortet: tags (Namen der Tags), group_ids, profile_ids und by_category (die Auswahl jeder Kategorie, die die des Bereichs ersetzt). Eigentümer und Administrator antworten immer; ohne Auswahl antwortet das ganze Team |
sla.enabled | wahr oder falsch | Schaltet die Fristen ein. Voreinstellung: ja |
sla.business_hours | {days, start, end} | Wochentage (0 = Sonntag bis 6 = Samstag) und Uhrzeit HH:MM, in der Zeitzone der Community. Voreinstellung: Mo bis Fr, 09:00 bis 18:00. Ohne Feiertage |
sla.categories | pro Kategorie | first_response und resolution, jeweils mit value (ganze Zahl) und unit (hours oder days). Voreinstellung: 4 Stunden und 1 Tag |
Die Kategorien sind FACILITIES, CLEANING, EQUIPMENT, INTERNET, ACCESS, BILLING und OTHER; die Arten MAINTENANCE und REQUEST; die Status OPEN, IN_PROGRESS, WAITING_REQUESTER, RESOLVED und CANCELED; die Prioritäten LOW, NORMAL, HIGH und URGENT.
get_support_space_settings
Nur lesen
Wie der Bereich funktioniert. allowUrgentFlag, maxOpenPerMember, locationHint, hasBookings (ob resource_id verwendet werden kann) und sla. Das Team erhält außerdem responders, defaultAssigneeId und canAnswerCategories (die Kategorien, die du beantwortest); der Resident erhält nie responders. Rolle: jede mit Zugriff auf den Bereich.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Support-Bereich (list_spaces) |
get_support_overview
Nur lesen
Die Warteschlange in Zahlen: open, inProgress, waitingRequester, unassigned, mine, overdue (Frist abgelaufen, Uhr läuft) und total. Ohne space werden alle Support-Bereiche zusammengezählt. Rolle: Moderator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Nein |
Frag so: „Wie steht es um die Ticket-Warteschlange?“
list_support_tickets
Nur lesen
Die ganze Warteschlange, nach der jüngsten Aktivität oder nach Priorität. Mit eingeschalteten Fristen bringt jedes Ticket sla mit (firstResponseDueAt, resolveDueAt, paused und die lesbaren Daten in der Zeitzone der Community) und, für das Team, sla.overdue. Jeder Eintrag sagt, was du tun kannst (canAnswer, canAssign...). Der Resident nutzt list_my_support_tickets. Rolle: Moderator oder Finanzen.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Nein | |
kind, status, priority, category | Werte oben | Nein | Je ein Wert |
assignee_profile_id | ID | Nein | Tickets dieser zuständigen Person |
unassigned | wahr oder falsch | Nein | Nicht zugewiesen |
mine | wahr oder falsch | Nein | Dir zugewiesen |
overdue | wahr oder falsch | Nein | Frist abgelaufen und Uhr läuft (Wartet auf Antwort zählt nicht) |
due_today | wahr oder falsch | Nein | Die nächste Frist fällt auf heute; nur in Bereichen mit Fristen |
requester_profile_id | ID | Nein | Tickets dieser Person |
resource_id | ID | Nein | Tickets dieses Elements der Buchungen |
q | Text | Nein | Nummer, #42 oder ein Teil des Titels |
sort | activity oder priority | Nein | |
page, limit | Zahlen | Nein | Seitenweise (bis 100) |
Frag so: „Welche Tickets sind überfällig oder heute fällig?“
list_my_support_tickets
Nur lesen
Die Tickets, die du geöffnet hast, vom neuesten zum ältesten. Rolle: jede mit Zugriff auf den Bereich.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Nein | |
kind, status, priority, category | Werte oben | Nein | |
resource_id | ID | Nein | |
q | Text | Nein | |
page, limit | Zahlen | Nein |
get_support_ticket
Nur lesen
Ein Ticket mit der Zeitleiste: Nachrichten, Änderungsverlauf, die internen Notizen (nur für das Team) und die Fotos als kurzlebige Links. Der Resident liest seine; das Team liest alle, auch außerhalb der Auswahl der Antwortenden. Ein fremdes Ticket: 404. Rolle: jede.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | Aus list_support_tickets oder list_my_support_tickets |
get_support_resource_open_count
Nur lesen
Der Duplikat-Hinweis. Nur die Anzahl offener Tickets eines Raums, Arbeitsplatzes oder Geräts der Buchungen, ohne Titel oder Verfasser, um vor einem weiteren Ticket zu warnen. Rolle: jede.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
resource_id | ID | Ja | Aus list_booking_resources |
create_support_ticket
Ändert
Ein Ticket öffnen, mit Fotos. Das Team wird über die E-Mail-Warteschlange benachrichtigt. Wer die Kategorie beantwortet, kann außerdem die priority festlegen und im Namen eines Residenten öffnen (requester_profile_id): Der Resident erhält eine E-Mail, daher zeigt der Assistent vorher, wer sie bekommt. Über dem Limit offener Tickets des Bereichs: 409; über 10 Tickets pro Stunde: 429. Derselbe Aufruf mit derselben client_request_id liefert dasselbe Ticket. Rolle: jede mit Zugriff auf den Bereich.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
space | ID oder Link | Ja | Der Support-Bereich |
kind | MAINTENANCE oder REQUEST | Ja | |
category | Kategorie | Ja | |
title | Text | Ja | Bis 140 Zeichen |
description | Text | Ja | Bis 10000 |
resource_id | ID | Nein | Raum, Arbeitsplatz oder Gerät (list_booking_resources) |
location_text | Text | Nein | Bis 120 Zeichen; gilt ohne Element |
urgent | wahr oder falsch | Nein | Wird zu hoher Priorität, wenn der Bereich es erlaubt |
priority | Priorität | Nein | Nur wer antwortet |
requester_profile_id | ID | Nein | Nur wer antwortet: öffnet im Namen dieses Residenten |
photos | Liste | Nein | Bis 5, jedes mit image_url oder image_base64 (+ image_type) |
client_request_id | Text | Nein | Verhindert Duplikate bei wiederholtem Tippen |
Frag so: „Öffne ein Wartungsticket: Der Beamer in Raum 3 geht nicht an, hier ist das Foto.“
update_support_ticket
Ändert
Die Sichtung. Nur wer die Kategorie des Tickets beantwortet; außerhalb davon ein übersetzter 403. Schicke nur, was sich ändert. message begleitet RESOLVED oder WAITING_REQUESTER als öffentliche Antwort, und der Resident erhält eine E-Mail; eine Zuweisung benachrichtigt die zuständige Person. RESOLVED und CANCELED gehen nur zurück auf OPEN. URGENT lässt sich nur hier festlegen. Jede Änderung erscheint in der Unterhaltung. Rolle: Moderator oder Finanzen, und die Kategorie beantworten.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
status | Status | Nein | |
priority | Priorität | Nein | |
kind, category | Werte | Nein | Die Kategorie wechselt nur zu einer, die du auch beantwortest |
assignee_profile_id | ID oder null | Nein | Muss die Kategorie beantworten; null entfernt die Zuständigkeit |
resource_id | ID oder null | Nein | Das Element der Buchungen |
location_text | Text oder null | Nein | |
title | Text | Nein | |
message | Text | Nein | Zusammen mit RESOLVED oder WAITING_REQUESTER |
Frag so: „Weise Ticket #42 Pedro zu und löse es mit dem Hinweis, dass wir die Lampe getauscht haben.“
add_support_comment
Ändert
Kommentieren, mit Fotos. Der Resident kommentiert seine Tickets (in Wartet auf Antwort geht es zurück auf In Bearbeitung; bei einem gelösten wird es wieder geöffnet); wer antwortet, ebenso, und der Resident erhält eine E-Mail (zwei Antworten innerhalb von 10 Minuten erzeugen nur eine E-Mail). Mit internal: true ist es eine interne Notiz: nur wer antwortet, darf das, der Resident sieht sie nie, und es wird keine E-Mail verschickt. Kommentare lassen sich nicht bearbeiten. Rolle: jede (die Notiz nur, wer antwortet).
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
body | Text | Ja | Bis 10000 Zeichen |
internal | wahr oder falsch | Nein | Interne Notiz |
photos | Liste | Nein | Bis 5, wie bei create_support_ticket |
Frag so: „Notiere intern bei Ticket #42, dass der Techniker am Donnerstag kommt.“
cancel_support_ticket
Mit Bestätigung
Ein offenes Ticket abbrechen. Wird Abgebrochen; nichts wird gelöscht. Der Resident bricht sein Ticket ab, solange es nicht gelöst ist; wer die Kategorie beantwortet, ebenso (etwa bei einem Duplikat). Gelöst oder bereits abgebrochen: 400. Rolle: jede, in den Grenzen oben.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja |
Liefert: beim ersten Aufruf die Zusammenfassung (Nummer, Titel, Status, Resident) und den Bestätigungscode.
reopen_support_ticket
Ändert
Wieder öffnen. Der Resident öffnet sein gelöstes Ticket wieder, und das Team wird benachrichtigt; wer antwortet, öffnet auch ein abgebrochenes wieder. Anderer Status: 400. Die Lösungsfrist beginnt neu. Rolle: jede, in den Grenzen oben.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja |
add_support_photo
Ändert
Ein Foto anhängen (JPEG, PNG oder WebP, bis 20 MB), privat gespeichert: Nur der Resident und das Team öffnen es. Bis 20 pro Ticket (409 darüber). Der Resident bei seinem; wer antwortet, bei jedem. Rolle: jede.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
image_url oder image_base64 | Link oder Text | Ja | Das Bild; image_base64 mit image_type |
replace_support_photo
Ändert
Ein Foto ersetzen. Das neue wird zuerst angehängt; danach wird das alte entfernt und die Datei gelöscht. Der Resident ersetzt die Fotos der Eröffnung und seiner Kommentare; wer antwortet, jedes. Rolle: jede.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
photo_id | ID | Ja | Aus get_support_ticket |
image_url oder image_base64 | Link oder Text | Ja | Das neue Bild |
remove_support_photo
Mit Bestätigung
Ein Foto entfernen (die Datei wird endgültig gelöscht). Wer antwortet, entfernt jedes; der Resident die der Eröffnung und seiner Kommentare. Rolle: jede, in den Grenzen oben.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
photo_id | ID | Ja | Aus get_support_ticket |
Liefert: beim ersten Aufruf die Zusammenfassung und den Bestätigungscode.
delete_support_comment
Mit Bestätigung
Eine Nachricht der Unterhaltung löschen, mit ihren Fotos. Die Einträge des Verlaufs werden nicht gelöscht. Rolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja | |
comment_id | ID | Ja | Aus get_support_ticket |
delete_support_ticket
Mit Bestätigung
Ein Ticket und seine Fotos löschen; nichts wird anonymisiert oder aufbewahrt. Um ein Ticket wirklich abzuschließen, nutze update_support_ticket (Gelöst) oder cancel_support_ticket. Rolle: Administrator.
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
ticket_id | ID | Ja |
Liefert: beim ersten Aufruf die Zusammenfassung (Nummer, Titel, Status, Resident, Fotos) und den Bestätigungscode.