Joindre des documents à un courriel
attach_documents_to_emailDescription
Joint au brouillon une copie de documents d'Oxygenius que l'utilisateur voit (documents d'un dossier, pièces jointes de courriels) : le document d'origine ne change pas. Aucun fichier ne vient de la conversation. 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 joint une nouvelle copie. 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). |
documentIds | integer[] | obligatoire | Documents à joindre (champ id de list_dossier_documents, ou documentId des pièces jointes de get_email) ; 20 au plus. |
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 | Joindre des documents à 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 | 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": "attach_documents_to_email",
"title": "Joindre des documents à un courriel",
"description": "Joint au brouillon une copie de documents d'Oxygenius que l'utilisateur voit (documents d'un dossier, pièces jointes de courriels) : le document d'origine ne change pas. Aucun fichier ne vient de la conversation. 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 joint une nouvelle copie. 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"
},
"documentIds": {
"description": "Documents à joindre (champ id de list_dossier_documents, ou documentId des pièces jointes de get_email) ; 20 au plus.",
"type": "array",
"items": {
"type": "integer"
}
}
},
"required": [
"emailId",
"documentIds"
]
},
"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": "Joindre des documents à un courriel",
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}