update_lead_status

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

Verhalten und Grenzen

Setzt den Status eines Leads und hält die Änderung im Verlauf fest. Feste Status: neu, kontaktiert, qualifiziert, gebucht, kunde, verloren. Mit note kommt im selben Schritt auch diese Notiz dazu. Überschreibt den aktuellen Status; vorher mit dem Nutzer bestätigen.

Berechtigungen

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

leads:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "lead_id from list_leads."
    },
    "status": {
      "type": "string",
      "enum": [
        "neu",
        "kontaktiert",
        "qualifiziert",
        "gebucht",
        "kunde",
        "verloren"
      ]
    },
    "note": {
      "description": "Optional note (1–4000 characters) added together with the status change.",
      "type": "string",
      "minLength": 1,
      "maxLength": 4000
    }
  },
  "required": [
    "lead_id",
    "status"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "neu",
        "kontaktiert",
        "qualifiziert",
        "gebucht",
        "kunde",
        "verloren"
      ]
    },
    "changed": {
      "type": "boolean"
    },
    "note_added": {
      "type": "boolean"
    }
  },
  "required": [
    "lead_id",
    "status",
    "changed"
  ],
  "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