send_inbox_message

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

Verhalten und Grenzen

Schreibt und sendet eine einfache Nachricht in einem Schritt aus einem Agent Mailbox (inboxId aus list_inboxes) an ausdrückliche To/CC/BCC-Empfänger (bis 50 verschiedene Adressen). Für direkte Sendeaufträge gedacht; für Entwürfe zum Prüfen oder Bearbeiten und für Anhänge save_inbox_draft und send_inbox_draft verwenden. Benötigt Schreib- und Senderecht des Clients, mindestens einen To-Empfänger und nicht leeren Text. Je Nachricht eine stabile requestId (8–128 ASCII-Buchstaben/Ziffern/Unterstriche/Bindestriche), je Postfach bzw. Empfängerkreis eine eigene; nach unklarer Antwort dieselbe requestId wiederholen, das liefert den bestehenden Versand statt erneut zu senden. Gibt Versand-ID und Status zurück: queued/sending ist keine Zustellung, accepted nur die Annahme durch den Anbieter; Fortschritt über get_inbox_send_status.

Berechtigungen

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

inbox:send

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "to": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "cc": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "bcc": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 320,
        "format": "email",
        "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
      }
    },
    "subject": {
      "type": "string",
      "maxLength": 998
    },
    "text": {
      "type": "string",
      "maxLength": 100000
    },
    "html": {
      "type": "string",
      "maxLength": 200000
    },
    "replyToEntryId": {
      "type": "string"
    },
    "inboxId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "requestId": {
      "type": "string",
      "pattern": "^[a-zA-Z0-9_-]{8,128}$"
    }
  },
  "required": [
    "to",
    "cc",
    "bcc",
    "subject",
    "text",
    "inboxId",
    "requestId"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "type": "string",
      "enum": [
        "queued",
        "sending",
        "accepted",
        "delivered",
        "failed",
        "unknown",
        "cancelled"
      ]
    },
    "failureCode": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "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