Modifier un brouillon de courriel
Nom de l'outil
update_email_draftÉcritureDestructifIdempotent
Description
Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).
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). |
to | string | facultatif | Destinataires, qui remplacent les actuels. Adresses séparées par des virgules ; les reprendre des tiers (search_tiers, get_tiers) ou du personnel plutôt que les deviner. |
cc | string | facultatif | Copie, qui remplace l'actuelle ; chaîne vide pour la vider. |
bcc | string | facultatif | Copie cachée, qui remplace l'actuelle ; chaîne vide pour la vider. |
subject | string | facultatif | Nouvel objet. |
body | string | facultatif | Nouveau message, en texte simple. |
type | string | facultatif | Type de courriel, par son nom (availableTypes du brouillon). |
fromGeneralMailbox | boolean | facultatif | Vrai : boîte générale de la société ; faux : boîte de l'utilisateur. |
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 |
|---|---|---|---|
id | integer | Identifiant du brouillon (emailId des autres outils). | |
from | string | peut être null | Boîte d'envoi : celle de l'utilisateur ou la boîte générale de la société. |
to | string | peut être null | Destinataires. |
cc | string | peut être null | Destinataires en copie. |
bcc | string | peut être null | Destinataires en copie cachée. |
subject | string | peut être null | Objet. |
type | string | peut être null | Type de courriel (obligatoire pour l'envoi). |
dossierId | integer | peut être null | Dossier lié. |
body | string | peut être null | Corps du courriel en texte (signature et message cité compris), tronqué s'il est long. |
attachments | object[] | Pièces jointes. | |
attachments[].documentId | integer | Identifiant du document (à passer à read_document ou get_document_download_link). | |
attachments[].name | string | peut être null | Nom du fichier. |
attachments[].contentType | string | peut être null | Type MIME. |
attachments[].sizeBytes | integer | Taille en octets. | |
attachments[].isInline | boolean | Vrai pour une image intégrée au corps (logo, signature). | |
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. |
availableTypes | string[] | Types de courriel proposés (paramètre type), hors commandes fournisseur. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Modifier un brouillon de courriel | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | oui | 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": "update_email_draft",
"title": "Modifier un brouillon de courriel",
"description": "Modifie un brouillon de courriel : destinataires, objet, message, type, boîte d'envoi. Seuls les champs fournis changent ; le message remplace celui écrit par ces outils, la signature et le message cité restent. Avant l'appel, annoncer précisément la modification et attendre l'accord de l'utilisateur. Seul un brouillon que l'utilisateur a créé change ; rien n'est envoyé (prepare_email_send puis send_email).",
"inputSchema": {
"type": "object",
"properties": {
"emailId": {
"description": "Brouillon (champ id de create_email_draft).",
"type": "integer"
},
"to": {
"description": "Destinataires, qui remplacent les actuels. 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": "Copie, qui remplace l'actuelle ; chaîne vide pour la vider.",
"type": [
"string",
"null"
],
"default": null
},
"bcc": {
"description": "Copie cachée, qui remplace l'actuelle ; chaîne vide pour la vider.",
"type": [
"string",
"null"
],
"default": null
},
"subject": {
"description": "Nouvel objet.",
"type": [
"string",
"null"
],
"default": null
},
"body": {
"description": "Nouveau message, en texte simple.",
"type": [
"string",
"null"
],
"default": null
},
"type": {
"description": "Type de courriel, par son nom (availableTypes du brouillon).",
"type": [
"string",
"null"
],
"default": null
},
"fromGeneralMailbox": {
"description": "Vrai : boîte générale de la société ; faux : boîte de l'utilisateur.",
"type": [
"boolean",
"null"
],
"default": null
}
},
"required": [
"emailId"
]
},
"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": "Modifier un brouillon de courriel",
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": false
}
}