[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Ajouter un média à un e-mail

L'outil mail_prospection_media_ajouter de Prescriptio ajoute une capture, un GIF ou une pièce jointe à un e-mail individuel préparé, sans envoi.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "message_id": "<message_id>",
      "nom_fichier": "<nom_fichier>",
      "ordre": 0
    },
    "name": "mail_prospection_media_ajouter"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"message_id":"<message_id>","nom_fichier":"<nom_fichier>","ordre":0},"name":"mail_prospection_media_ajouter"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "canal": "mp",
  "captures": [
    {}
  ],
  "empreinte": "<texte>",
  "envoye": false,
  "erreurs": [
    "<texte>"
  ],
  "message_id": "<texte>",
  "modele": {},
  "note": "<texte>",
  "objet": "<texte>",
  "pieces_jointes_confirmees_extension": false,
  "pret_extension": false,
  "statut": "<texte>",
  "texte": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `cid` | texte | — | (max. caractères 80) |
| `disposition` | `piece_jointe` · `inline` | — | — |
| `fichier_base64` | texte | — | (max. caractères 3145728) |
| `image_base64` | texte | — | (max. caractères 3145728) |
| `legende` | texte | — | (max. caractères 300) |
| `message_id` | texte | oui | (format `^[0-9a-fA-F-]{36}$`) |
| `nom_fichier` | texte | oui | (max. caractères 180) |
| `obligatoire` | booléen | — | — |
| `ordre` | entier | oui | (min 1, max 8) |

## Quand l'utiliser

Vérifie le fichier et le propriétaire du brouillon ; aucun envoi.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Joins cette capture à l'e-mail préparé.
```

Outil : `mail_prospection_media_ajouter` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

## En bref

| | |
|---|---|
| Effets | lecture et écriture dans l'espace du compte |
| Portée OAuth | `mcp:write` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | l'espace du compte authentifié (ses alertes, ses dossiers, sa base) |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-prospecter-email](https://prescriptio.fr/skills/prescriptio-prospecter-email) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `mail_prospection_media_ajouter`.

- [Préparer un e-mail individuel](https://prescriptio.fr/skills/prescriptio-prospecter-email) : IA, Les skills du plugin

## Voir aussi

- [mail_prospection_brouillon_enregistrer](https://prescriptio.fr/docs/api/mail_prospection_brouillon_enregistrer) : Enregistrer un brouillon d'e-mail individuel déjà rédigé
- [mail_prospection_statut](https://prescriptio.fr/docs/api/mail_prospection_statut) : Valider, annuler ou déclarer un e-mail individuel effectivement envoyé
- [mail_prospection_planning](https://prescriptio.fr/docs/api/mail_prospection_planning) : Lister, fixer ou retirer les échéances des e-mails individuels préparés
- [mail_prospection_modeles](https://prescriptio.fr/docs/api/mail_prospection_modeles) : Trames d'e-mails individuels approfondis de votre espace, séparées des MP LinkedIn et des campagnes
- [mail_prospection_lots](https://prescriptio.fr/docs/api/mail_prospection_lots) : Organiser les lots d'e-mails individuels personnalisés : contenu approfondi fourni pour chaque…
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module