send_feedback

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Erfordert feedback:write. Speichert eine vom Nutzer beauftragte Rückmeldung und plant deren Versand an den Ridian-Support ein. Enthält den beauftragten Text, Kategorie, Sprache und Antwortwunsch sowie interne Nutzer- und Workspace-Referenzen zur Zuordnung; keine Chatverläufe oder Kalender-/Kontaktinhalte. Kein Versand aus dem Nutzerpostfach. Nur aufrufen, wenn der Nutzer in dieser Anfrage darum gebeten hat, niemals ungefragt bei eigenen Werkzeugproblemen. Eine stabile requestId verhindert doppelte Meldungen. Das Ergebnis received bestätigt die Aufnahme, nicht die Zustellung. Zugestellte Rückmeldungen lassen sich nicht zurückrufen.

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

feedback:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "message": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    },
    "category": {
      "type": "string",
      "enum": [
        "bug",
        "idea",
        "question",
        "other"
      ]
    },
    "wantsReply": {
      "type": "boolean"
    },
    "locale": {
      "type": "string",
      "enum": [
        "de",
        "en"
      ]
    },
    "requestId": {
      "type": "string",
      "minLength": 8,
      "maxLength": 100
    }
  },
  "required": [
    "message",
    "category",
    "wantsReply",
    "locale",
    "requestId"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    },
    "reference": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "received",
        "delivered"
      ]
    }
  },
  "required": [
    "ok",
    "reference",
    "status"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

Fehlerbehandlung