Envoyer un message de test | Documentation Prescriptio

POST /api/mcp/v1/email.messages.test, portée mcp:write; droits, conditions d’offre et quotas contrôlés par l’action. Même traitement que l'outil campagne_email. 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.test \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"adresse_test":"[email protected]","campagne_id":"00000000-0000-0000-0000-000000000001","variante_id":"00000000-0000-0000-0000-000000000002"}'

{
  "adresse_test": "[email protected]",
  "campagne_id": "00000000-0000-0000-0000-000000000001",
  "variante_id": "00000000-0000-0000-0000-000000000002"
}

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

{
  "action": null,
  "fields": {
    "campagne_id": "<texte>",
    "destinataire": "<texte>",
    "resultat": "<texte>",
    "variante_id": "<texte>"
  },
  "ok": null,
  "url": "<texte>"
}

Paramètres du corps

adresse_testtexterequis

Tester : adresse destinataire du test (5 essais maximum en 10 minutes par espace). Absente : l'adresse de test de l'organisation (identité). En local, le message est compose sans envoi réel.

campagne_idtexterequis

UUID de la campagne. Requis partout sauf lister, creer, stats (global), desinscrits, expediteur et quota.

variante_idtexterequis

Variante : UUID d'une variante existante a reecrire. Objet, tester, destinataire : le message vise (absent : le premier, ou celui du destinataire).

Quand l'utiliser

Limite de cinq tests en dix minutes par organisation.

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

En bref

Adresse: POST /api/mcp/v1/email.messages.test
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: campagne_email : 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.test.

Campagnes e-mail de bout en boutGuides, Parcours complets

Voir aussi

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

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Envoyer un message de test L'opération REST email.messages.test de Prescriptio sert à composer et envoyer un vrai message de test à une adresse choisie. ### Exemple d'appel, synthétique **curl** ```bash curl -sS https://prescriptio.fr/api/mcp/v1/email.messages.test \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"adresse_test":"[email protected]","campagne_id":"00000000-0000-0000-0000-000000000001","variante_id":"00000000-0000-0000-0000-000000000002"}' ``` **Corps JSON** ```json { "adresse_test": "[email protected]", "campagne_id": "00000000-0000-0000-0000-000000000001", "variante_id": "00000000-0000-0000-0000-000000000002" } ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": null, "fields": { "campagne_id": "<texte>", "destinataire": "<texte>", "resultat": "<texte>", "variante_id": "<texte>" }, "ok": null, "url": "<texte>" } ``` ## Paramètres du corps | Nom | Type | Requis | Description | |---|---|---|---| | `adresse_test` | texte | oui | tester : adresse destinataire du test (5 essais maximum en 10 minutes par espace). Absente : l'adresse de test de l'organisation (identité). En local, le message est compose sans envoi réel. | | `campagne_id` | texte | oui | UUID de la campagne. Requis partout sauf lister, creer, stats (global), desinscrits, expediteur et quota. | | `variante_id` | texte | oui | variante : UUID d'une variante existante a reecrire. objet, tester, destinataire : le message vise (absent : le premier, ou celui du destinataire). | ## Quand l'utiliser Limite de cinq tests en dix minutes par organisation. ## En bref | | | |---|---| | Adresse | `POST /api/mcp/v1/email.messages.test` | | 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 | [`campagne_email`](https://prescriptio.fr/docs/api/campagne_email) : 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.test`. - [Campagnes e-mail de bout en bout](https://prescriptio.fr/docs/guides/campagnes-email) : Guides, Parcours complets ## Voir aussi - [Référence API](https://prescriptio.fr/docs/reference) : L'adresse, l'authentification et les codes de réponse - [campagne_email](https://prescriptio.fr/docs/api/campagne_email) : La même action par le connecteur MCP - [OpenAPI](https://prescriptio.fr/openapi.json) : Le schéma machine de toutes les opérations