Préparer l'envoi d'un courriel

Tool nameprepare_email_send
WriteIdempotentPrepares an action, no effect

Changes nothing: shows the e-mail exactly as it will leave, with warnings, and returns a 10-minute confirmation token.

Description

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

Prépare l'envoi d'un brouillon sans rien envoyer ni modifier : renvoie le courriel tel qu'il partira, les points d'attention (destinataires inconnus, hors du dossier, copie cachée) et un jeton de confirmation valable 10 minutes. Montrer à l'utilisateur l'expéditeur, les destinataires, l'objet, le message, les pièces jointes et les points d'attention, puis attendre son accord explicite avant send_email. Un brouillon modifié ensuite doit être préparé à nouveau.

Required access

Parameters

NameTypePresenceDescription
emailIdintegerrequiredBrouillon (champ id de create_email_draft).

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
emailobjectLe courriel tel qu'il partira : le montrer à l'utilisateur (expéditeur, destinataires, objet, message, pièces jointes).
email.idintegerIdentifiant du brouillon (emailId des autres outils).
email.fromstringnullableBoîte d'envoi : celle de l'utilisateur ou la boîte générale de la société.
email.tostringnullableDestinataires.
email.ccstringnullableDestinataires en copie.
email.bccstringnullableDestinataires en copie cachée.
email.subjectstringnullableObjet.
email.typestringnullableType de courriel (obligatoire pour l'envoi).
email.dossierIdintegernullableDossier lié.
email.bodystringnullableCorps du courriel en texte (signature et message cité compris), tronqué s'il est long.
email.attachmentsobject[]Pièces jointes.
email.attachments[].documentIdintegerIdentifiant du document (à passer à read_document ou get_document_download_link).
email.attachments[].namestringnullableNom du fichier.
email.attachments[].contentTypestringnullableType MIME.
email.attachments[].sizeBytesintegerTaille en octets.
email.attachments[].isInlinebooleanVrai pour une image intégrée au corps (logo, signature).
email.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.
email.availableTypesstring[]Types de courriel proposés (paramètre type), hors commandes fournisseur.
warningsstring[]Points à signaler à l'utilisateur avant l'envoi (destinataires inconnus, hors du dossier…).
confirmationTokenstringJeton à passer à send_email, seulement après l'accord explicite de l'utilisateur sur ce courriel.
expiresAtstring (date-time)Échéance du jeton (10 minutes) ; au-delà, ou si le brouillon change, préparer à nouveau.

MCP annotations

AnnotationValueMeaning
titlePréparer l'envoi d'un 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.
idempotentHintyesCalling 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": "prepare_email_send",
  "title": "Préparer l'envoi d'un courriel",
  "description": "Prépare l'envoi d'un brouillon sans rien envoyer ni modifier : renvoie le courriel tel qu'il partira, les points d'attention (destinataires inconnus, hors du dossier, copie cachée) et un jeton de confirmation valable 10 minutes. Montrer à l'utilisateur l'expéditeur, les destinataires, l'objet, le message, les pièces jointes et les points d'attention, puis attendre son accord explicite avant send_email. Un brouillon modifié ensuite doit être préparé à nouveau.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "emailId": {
        "description": "Brouillon (champ id de create_email_draft).",
        "type": "integer"
      }
    },
    "required": [
      "emailId"
    ]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "email": {
        "description": "Le courriel tel qu'il partira : le montrer à l'utilisateur (expéditeur, destinataires, objet, message, pièces jointes).",
        "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"
        ]
      },
      "warnings": {
        "description": "Points à signaler à l'utilisateur avant l'envoi (destinataires inconnus, hors du dossier…).",
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "confirmationToken": {
        "description": "Jeton à passer à send_email, seulement après l'accord explicite de l'utilisateur sur ce courriel.",
        "type": "string"
      },
      "expiresAt": {
        "description": "Échéance du jeton (10 minutes) ; au-delà, ou si le brouillon change, préparer à nouveau.",
        "type": "string",
        "format": "date-time"
      }
    },
    "required": [
      "email",
      "confirmationToken",
      "expiresAt"
    ]
  },
  "annotations": {
    "title": "Préparer l'envoi d'un courriel",
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false,
    "readOnlyHint": false
  }
}