Référence MCP

add_comment

Commenter une fiche

Référence générée depuis le contrat versionné · Version Markdown

Rôle#

Ajoute un commentaire au fil de discussion d'une société, d'un contact, d'un devis ou d'une requête, comme l'onglet Discussion. Exige le scope d'écriture de l'objet visé. Pour tracer un appel ou un rendez-vous, log_interaction reste l'outil.

Accès#

Un scope parmi : companies:write, contacts:write, quotes:write, requests:write. Le geste exige ensuite le scope de l’objet demandé. Le scope ne remplace pas les gardes de visibilité, d'organisation, de module ni les scopes complémentaires des gestes composés.

Catalogue complet · Approbations

Paramètres#

Le schéma ci-dessous est produit par la fonction qui enregistre les outils, y compris idempotency_key lorsqu'elle s'applique. Consultez les objets imbriqués dans le schéma complet.

Champ	Type	Obligatoire	Description
`object`	string	Oui	Type de la fiche Valeurs : company, contact, quote, request
`id`	string	Oui	Identifiant de la fiche
`body`	string	Oui	Texte du commentaire
`idempotency_key`	string	Non	Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h

Schéma JSON complet des paramètres

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "enum": [
        "company",
        "contact",
        "quote",
        "request"
      ],
      "description": "Type de la fiche"
    },
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Identifiant de la fiche"
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "Texte du commentaire"
    },
    "idempotency_key": {
      "description": "Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "object",
    "id",
    "body"
  ],
  "additionalProperties": false
}