Envoyer un message | Documentation Prescriptio

POST /api/mcp/v1/email.messages.send, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil mail_prospection_envoyer. Un envoi réel exige un abonnement de l’organisation ou un accès offert admissible.

exemple synthétique

curl -sS https://prescriptio.fr/api/mcp/v1/email.messages.send \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"cle_idempotence":"commande-123-confirmation","corps":"Votre demande est enregistrée.","email":"[email protected]","objet":"Confirmation","repondre_a":"[email protected]"}'

{
  "cle_idempotence": "commande-123-confirmation",
  "corps": "Votre demande est enregistrée.",
  "email": "[email protected]",
  "objet": "Confirmation",
  "repondre_a": "[email protected]"
}

Réponsegénérée depuis le schéma

{
  "action": "<envoyer | envoi_lire>",
  "fields": {
    "campagne_id": "<texte>",
    "destinataire": "<texte>",
    "envoi_id": "<texte>",
    "livraison": "<texte>",
    "mode": "<texte>",
    "statut": "<texte>"
  },
  "note": "<texte>",
  "ok": null,
  "url": "<texte>"
}

Paramètres du corps

blocsliste

Variante avec format=builder : blocs dans l'ordre. Images HTTPS, boutons HTTPS ou [lien1] à [lien3].

Voir les propriétés

kindtexterequis

(valeurs : titre · texte · image · bouton · separateur)

texttexte

urltexte

cle_idempotencetexterequis

Clé stable pour un envoi unitaire. Un rejeu du même contenu retrouve le même message ; un autre contenu est refusé. Ne pas renouveler la clé après un délai dépassé. (max. 128 caractères)

corpstexte

Creer/variante : le message. Mêmes champs. Pour un lien mesure, écrire [lien1], [lien2] et les declarer par action liens.

emailtexterequis

Desinscrits : adresse a ajouter a la liste de suppression. Destinataire : le destinataire a lire (ou envoi_id). bdd_publipostage_modifier : l'adresse du contact.

expediteurtexte

Creer/modifier : adresse d'expedition. Doit appartenir a un domaine verifie pour cet espace (action expediteur les liste) ou au domaine de repli de la plateforme. Laisser vide prend l'adresse par défaut de l'espace. Un domaine seulement declare est refuse : sans SPF/DKIM le message part en indesirable.

expediteur_nomtexte

Creer/modifier : le nom affiche par la messagerie du destinataire.

formattexte

Variante : format d'une version existante. Html est assaini ; builder compile les blocs comme l'interface. (valeurs : texte · html · builder)

objettexterequis

Creer/variante : objet du message. Champs : [prenom] [nom] [entreprise] [ville] [fonction] (l'accent est optionnel : [prenom] et [prénom] valent pareil, [société] vaut [entreprise]).

repondre_atexte

Creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier.

Quand l'utiliser

Clé d’idempotence obligatoire, exclusions et quotas communs. En local : journal sans envoi. Relire le même identifiant après un délai dépassé ; ne pas créer une nouvelle clé.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

En bref

Adresse: POST /api/mcp/v1/email.messages.send
Contrat: 3.0.0
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.
Outil MCP: mail_prospection_envoyer : même traitement

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 codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite email.messages.send.

Campagnes e-mail de bout en boutGuides, Parcours complets API RESTIA, Intégrations

Voir aussi

Référence APIL'adresse, l'authentification et les codes de réponse mail_prospection_envoyerLa même action par le connecteur MCP OpenAPILe schéma machine de toutes les opérations

curl -sS https://prescriptio.fr/api/mcp/v1/email.messages.send \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"cle_idempotence":"commande-123-confirmation","corps":"Votre demande est enregistrée.","email":"[email protected]","objet":"Confirmation","repondre_a":"[email protected]"}'

{ "action": "<envoyer | envoi_lire>", "fields": { "campagne_id": "<texte>", "destinataire": "<texte>", "envoi_id": "<texte>", "livraison": "<texte>", "mode": "<texte>", "statut": "<texte>" }, "note": "<texte>", "ok": null, "url": "<texte>" }

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Envoyer un message L'opération REST email.messages.send de Prescriptio sert à envoyer un message unitaire sans préparer de campagne. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/email.messages.send \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"cle_idempotence":"commande-123-confirmation","corps":"Votre demande est enregistrée.","email":"[email protected]","objet":"Confirmation","repondre_a":"[email protected]"}' ``` **Corps JSON** ```json { "cle_idempotence": "commande-123-confirmation", "corps": "Votre demande est enregistrée.", "email": "[email protected]", "objet": "Confirmation", "repondre_a": "[email protected]" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<envoyer | envoi_lire>", "fields": { "campagne_id": "<texte>", "destinataire": "<texte>", "envoi_id": "<texte>", "livraison": "<texte>", "mode": "<texte>", "statut": "<texte>" }, "note": "<texte>", "ok": null, "url": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `blocs` | liste | — | variante avec format=builder : blocs dans l'ordre. Images HTTPS, boutons HTTPS ou [lien1] à [lien3]. | | `blocs[].kind` | texte | oui | (valeurs : `titre` · `texte` · `image` · `bouton` · `separateur`) | | `blocs[].text` | texte | — | — | | `blocs[].url` | texte | — | — | | `cle_idempotence` | texte | oui | Clé stable pour un envoi unitaire. Un rejeu du même contenu retrouve le même message ; un autre contenu est refusé. Ne pas renouveler la clé après un délai dépassé. (max. 128 caractères) | | `corps` | texte | — | creer/variante : le message. Mêmes champs. Pour un lien mesure, écrire [lien1], [lien2] et les declarer par action liens. | | `email` | texte | oui | desinscrits : adresse a ajouter a la liste de suppression. destinataire : le destinataire a lire (ou envoi_id). bdd_publipostage_modifier : l'adresse du contact. | | `expediteur` | texte | — | creer/modifier : adresse d'expedition. Doit appartenir a un domaine VERIFIE pour cet espace (action expediteur les liste) ou au domaine de repli de la plateforme. Laisser vide prend l'adresse par défaut de l'espace. Un domaine seulement declare est refuse : sans SPF/DKIM le message part en indesirable. | | `expediteur_nom` | texte | — | creer/modifier : le nom affiche par la messagerie du destinataire. | | `format` | texte | — | variante : format d'une version existante. html est assaini ; builder compile les blocs comme l'interface. (valeurs : `texte` · `html` · `builder`) | | `objet` | texte | oui | creer/variante : objet du message. Champs : [prenom] [nom] [entreprise] [ville] [fonction] (l'accent est optionnel : [prenom] et [prénom] valent pareil, [société] vaut [entreprise]). | | `repondre_a` | texte | — | creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier. | ## Quand l'utiliser Clé d’idempotence obligatoire, exclusions et quotas communs. En local : journal sans envoi. Relire le même identifiant après un délai dépassé ; ne pas créer une nouvelle clé. ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/email.messages.send` | | Contrat | 3.0.0 | | 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. | | Outil MCP | [`mail_prospection_envoyer`](https://prescriptio.fr/docs/api/mail_prospection_envoyer) : même traitement | ## 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 codes HTTP, le corps d’erreur et les compteurs d’appels et de dossiers sont communs. Chaque action conserve aussi ses 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 pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `email.messages.send`. - [Campagnes e-mail de bout en bout](https://prescriptio.fr/docs/guides/campagnes-email) : Guides, Parcours complets - [API REST](https://prescriptio.fr/docs/integrations/api-rest) : IA, Intégrations ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [mail_prospection_envoyer](https://prescriptio.fr/docs/api/mail_prospection_envoyer) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations