Créer un brouillon de courriel

Tool namecreate_email_draft
Write

Creates a draft e-mail: new, reply, reply all or forward, with the user's signature. Nothing is sent.

Description

Exact text sent to the model by tools/list (French, the language of the data):

Crée un brouillon de courriel de l'utilisateur, comme le bouton Nouveau, Répondre, Répondre à tous ou Transférer de la messagerie : la signature de l'utilisateur est ajoutée, une réponse reprend l'expéditeur, l'objet et le message cité, un transfert reprend les pièces jointes du courriel d'origine. Le message (body) est du texte simple placé avant la signature. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Ne pas rappeler l'outil après un succès : chaque appel crée un brouillon. Rien n'est envoyé. Renvoie le brouillon, avec les types de courriel proposés.

Required access

Parameters

NameTypePresenceDescription
actionstringoptionalnew (défaut), reply, reply_all ou forward.
emailIdintegeroptionalCourriel auquel répondre, ou à transférer (champ id de search_emails ou get_my_emails).
dossierIdintegeroptionalDossier où classer un nouveau courriel (champ id de search_dossiers) ; une réponse reprend celui du courriel d'origine.
tostringoptionalDestinataires, qui remplacent ceux d'une réponse. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.
ccstringoptionalDestinataires en copie. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.
bccstringoptionalDestinataires en copie cachée. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.
subjectstringoptionalObjet ; une réponse reprend celui du courriel d'origine.
bodystringoptionalMessage, en texte simple (retours à la ligne gardés).
typestringoptionalType de courriel, par son nom (availableTypes du brouillon) ; obligatoire pour l'envoi.
fromGeneralMailboxbooleanoptionalVrai pour envoyer depuis la boîte générale de la société (administrateurs et commerciaux) ; défaut : boîte de l'utilisateur.

Result

The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.

Result fields
NameTypePresenceDescription
idintegerIdentifiant du brouillon (emailId des autres outils).
fromstringnullableBoîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.
tostringnullableDestinataires.
ccstringnullableDestinataires en copie.
bccstringnullableDestinataires en copie cachée.
subjectstringnullableObjet.
typestringnullableType de courriel (obligatoire pour l'envoi).
dossierIdintegernullableDossier lié.
bodystringnullableCorps du courriel en texte (signature et message cité compris), tronqué s'il est long.
attachmentsobject[]Pièces jointes.
attachments[].documentIdintegerIdentifiant du document (à passer à read_document ou get_document_download_link).
attachments[].namestringnullableNom du fichier.
attachments[].contentTypestringnullableType MIME.
attachments[].sizeBytesintegerTaille en octets.
attachments[].isInlinebooleanVrai pour une image intégrée au corps (logo, signature).
sendsDocumentstringnullableDevis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.
availableTypesstring[]Types de courriel proposés (paramètre type), hors commandes fournisseur.

MCP annotations

AnnotationValueMeaning
titleCréer un brouillon de courrielHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintnoThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe tool reads e-mails or document content, or reaches an external service.

JSON definition

Exact tools/list entry
{
  "name": "create_email_draft",
  "title": "Créer un brouillon de courriel",
  "description": "Crée un brouillon de courriel de l'utilisateur, comme le bouton Nouveau, Répondre, Répondre à tous ou Transférer de la messagerie : la signature de l'utilisateur est ajoutée, une réponse reprend l'expéditeur, l'objet et le message cité, un transfert reprend les pièces jointes du courriel d'origine. Le message (body) est du texte simple placé avant la signature. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Ne pas rappeler l'outil après un succès : chaque appel crée un brouillon. Rien n'est envoyé. Renvoie le brouillon, avec les types de courriel proposés.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "action": {
        "description": "new (défaut), reply, reply_all ou forward.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "emailId": {
        "description": "Courriel auquel répondre, ou à transférer (champ id de search_emails ou get_my_emails).",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "dossierId": {
        "description": "Dossier où classer un nouveau courriel (champ id de search_dossiers) ; une réponse reprend celui du courriel d'origine.",
        "type": [
          "integer",
          "null"
        ],
        "default": null
      },
      "to": {
        "description": "Destinataires, qui remplacent ceux d'une réponse. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "cc": {
        "description": "Destinataires en copie. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "bcc": {
        "description": "Destinataires en copie cachée. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "subject": {
        "description": "Objet ; une réponse reprend celui du courriel d'origine.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "body": {
        "description": "Message, en texte simple (retours à la ligne gardés).",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "type": {
        "description": "Type de courriel, par son nom (availableTypes du brouillon) ; obligatoire pour l'envoi.",
        "type": [
          "string",
          "null"
        ],
        "default": null
      },
      "fromGeneralMailbox": {
        "description": "Vrai pour envoyer depuis la boîte générale de la société (administrateurs et commerciaux) ; défaut : boîte de l'utilisateur.",
        "type": [
          "boolean",
          "null"
        ],
        "default": null
      }
    }
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "id": {
        "description": "Identifiant du brouillon (emailId des autres outils).",
        "type": "integer"
      },
      "from": {
        "description": "Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.",
        "type": [
          "string",
          "null"
        ]
      },
      "to": {
        "description": "Destinataires.",
        "type": [
          "string",
          "null"
        ]
      },
      "cc": {
        "description": "Destinataires en copie.",
        "type": [
          "string",
          "null"
        ]
      },
      "bcc": {
        "description": "Destinataires en copie cachée.",
        "type": [
          "string",
          "null"
        ]
      },
      "subject": {
        "description": "Objet.",
        "type": [
          "string",
          "null"
        ]
      },
      "type": {
        "description": "Type de courriel (obligatoire pour l'envoi).",
        "type": [
          "string",
          "null"
        ]
      },
      "dossierId": {
        "description": "Dossier lié.",
        "type": [
          "integer",
          "null"
        ]
      },
      "body": {
        "description": "Corps du courriel en texte (signature et message cité compris), tronqué s'il est long.",
        "type": [
          "string",
          "null"
        ]
      },
      "attachments": {
        "description": "Pièces jointes.",
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "documentId": {
              "description": "Identifiant du document (à passer à read_document ou get_document_download_link).",
              "type": "integer"
            },
            "name": {
              "description": "Nom du fichier.",
              "type": [
                "string",
                "null"
              ]
            },
            "contentType": {
              "description": "Type MIME.",
              "type": [
                "string",
                "null"
              ]
            },
            "sizeBytes": {
              "description": "Taille en octets.",
              "type": "integer"
            },
            "isInline": {
              "description": "Vrai pour une image intégrée au corps (logo, signature).",
              "type": "boolean"
            }
          },
          "required": [
            "documentId",
            "sizeBytes",
            "isInline"
          ]
        }
      },
      "sendsDocument": {
        "description": "Devis, facture ou note de crédit qu'envoie ce courriel (une facture ou une note de crédit passe au statut Envoyé à l'envoi, sauf facture déjà payée), ou vide.",
        "type": [
          "string",
          "null"
        ]
      },
      "availableTypes": {
        "description": "Types de courriel proposés (paramètre type), hors commandes fournisseur.",
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "id"
    ]
  },
  "annotations": {
    "title": "Créer un brouillon de courriel",
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}