Créer un brouillon de courriel
create_email_draftDescription
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.
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 |
|---|---|---|---|
action | string | facultatif | new (défaut), reply, reply_all ou forward. |
emailId | integer | facultatif | Courriel auquel répondre, ou à transférer (champ id de search_emails ou get_my_emails). |
dossierId | integer | facultatif | Dossier où classer un nouveau courriel (champ id de search_dossiers) ; une réponse reprend celui du courriel d'origine. |
to | string | facultatif | 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. |
cc | string | facultatif | 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. |
bcc | string | facultatif | 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. |
subject | string | facultatif | Objet ; une réponse reprend celui du courriel d'origine. |
body | string | facultatif | Message, en texte simple (retours à la ligne gardés). |
type | string | facultatif | Type de courriel, par son nom (availableTypes du brouillon) ; obligatoire pour l'envoi. |
fromGeneralMailbox | boolean | facultatif | Vrai pour envoyer depuis la boîte générale de la société (administrateurs et commerciaux) ; défaut : 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 | Créer un brouillon de 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 | non | 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": "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
}
}