Préparer l'envoi d'un courriel
Nom de l'outil
prepare_email_sendÉcritureIdempotentPrépare une action, sans effet
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.
Accès requis
- Au moins une de ces permissions :
mail-inbox.list.viewoumail-outbox.list.viewoumail-sendbox.list.viewoumail-trashbox.list.viewouall-mail.list.viewoudossier-detail.tab.mailbox - Société ouverte aux outils d'écriture (Paramètres → Intégration IA).
- Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
emailId | integer | obligatoire | Brouillon (champ id de create_email_draft). |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
email | object | Le courriel tel qu'il partira : le montrer à l'utilisateur (expéditeur, destinataires, objet, message, pièces jointes). | |
email.id | integer | Identifiant du brouillon (emailId des autres outils). | |
email.from | string | peut être null | Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société. |
email.to | string | peut être null | Destinataires. |
email.cc | string | peut être null | Destinataires en copie. |
email.bcc | string | peut être null | Destinataires en copie cachée. |
email.subject | string | peut être null | Objet. |
email.type | string | peut être null | Type de courriel (obligatoire pour l'envoi). |
email.dossierId | integer | peut être null | Dossier lié. |
email.body | string | peut être null | Corps du courriel en texte (signature et message cité compris), tronqué s'il est long. |
email.attachments | object[] | Pièces jointes. | |
email.attachments[].documentId | integer | Identifiant du document (à passer à read_document ou get_document_download_link). | |
email.attachments[].name | string | peut être null | Nom du fichier. |
email.attachments[].contentType | string | peut être null | Type MIME. |
email.attachments[].sizeBytes | integer | Taille en octets. | |
email.attachments[].isInline | boolean | Vrai pour une image intégrée au corps (logo, signature). | |
email.sendsDocument | string | peut être null | 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. |
email.availableTypes | string[] | Types de courriel proposés (paramètre type), hors commandes fournisseur. | |
warnings | string[] | Points à signaler à l'utilisateur avant l'envoi (destinataires inconnus, hors du dossier…). | |
confirmationToken | string | Jeton à passer à send_email, seulement après l'accord explicite de l'utilisateur sur ce courriel. | |
expiresAt | string (date-time) | Échéance du jeton (10 minutes) ; au-delà, ou si le brouillon change, préparer à nouveau. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Préparer l'envoi d'un courriel | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | non | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | oui | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"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
}
}