crm_advance_stage

Faire avancer une affaire vers l'étape suivante du pipeline, avec une note optionnelle.

Catégorie
CRM
Stabilité
Bêta
Version
v1
Auth
cf-access

Schéma d’entrée

{
  "type": "object",
  "properties": {
    "deal_id": { "type": "string" },
    "to_stage": { "type": "string", "enum": ["qualified", "proposal", "won", "lost"] },
    "note": { "type": "string" }
  },
  "required": ["deal_id", "to_stage"]
}

Schéma de sortie

{
  "type": "object",
  "properties": {
    "deal_id": { "type": "string" },
    "from_stage": { "type": "string" },
    "to_stage": { "type": "string" },
    "updated_at": { "type": "string", "format": "date-time" }
  }
}

Exemple d’invocation

{
  "tool": "crm_advance_stage",
  "arguments": {
    "deal_id": "D-2026-00084",
    "to_stage": "proposal",
    "note": "Pricing sent 2026-04-25, two-week follow-up window."
  }
}

Exemple de réponse

{
  "deal_id": "D-2026-00084",
  "from_stage": "qualified",
  "to_stage": "proposal",
  "updated_at": "2026-04-25T08:41:00Z"
}

Les transitions d’état sont journalisées sur l’affaire et dans run_ledger. Les transitions vers won ou lost sont terminales — rouvrir via crm_upsert_contact + une nouvelle affaire, pas via un appel d’avance.