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

# Gérer les audiences

L'outil campagne_email_audiences de Prescriptio gère les audiences de campagnes de votre organisation et le publipostage d'une liste de votre base : lire ses colonnes, analyser puis importer un fichier CSV.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "lister"
    },
    "name": "campagne_email_audiences"
  }
}
```

**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":{"action":"lister"},"name":"campagne_email_audiences"}}'
```

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

```json
{
  "action": "audiences",
  "fields": {
    "audiences": [
      {
        "id": "<texte>",
        "nature": "liste",
        "nom": "<texte>",
        "selection": {
          "contacts": [
            "<texte>"
          ],
          "liste_id": "<texte>",
          "q": "<texte>",
          "rang_max": 0,
          "source": "<texte>"
        }
      }
    ]
  },
  "note": "<texte>",
  "ok": true,
  "url": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `action` | `lister` · `creer` · `modifier` · `supprimer` · `bdd_publipostage_lire` · `bdd_publipostage_analyser` · `bdd_publipostage_importer` · `bdd_publipostage_modifier` | — | (défaut `"lister"`) |
| `adresse_test` | texte | — | 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. |
| `adresses` | liste de objet | — | adresse_publiee : adresses qu'une entreprise Publié (page contact, mentions légales), chacune avec la page où elle est écrite. Jamais une adresse devinée sur un motif. (min. éléments 1, max. éléments 200) |
| `audience_id` | texte | — | (format `^[0-9a-fA-F-]{36}$`) |
| `blocs` | liste de objet | — | variante avec format=builder : blocs dans l'ordre. Images HTTPS, boutons HTTPS ou [lien1] à [lien3]. (min. éléments 1, max. éléments 30) |
| `boite` | texte | — | expediteur : la partie avant l'arobase proposee pour ce domaine (défaut contact). |
| `campagne_id` | texte | — | UUID de la campagne. Requis partout sauf lister, creer, stats (global), desinscrits, expediteur et quota. |
| `campagnes_sources` | liste de texte | — | regrouper : autres brouillons jamais planifiés. Leurs destinataires rejoignent campagne_id, sans doublons ; les sources sont arrêtées et conservées, sans programmer d’envoi. (min. éléments 1, max. éléments 100) |
| `cle_idempotence` | texte | — | 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é. (format `^[!-~]+$`, min. caractères 1, max. caractères 128) |
| `contacts` | liste de texte | — | Identifiants base:<UUID> ou crm:<UUID> déjà détenus par l'organisation. (max. éléments 2000) |
| `corps` | texte | — | creer/variante : le message. Mêmes champs. Pour un lien mesure, écrire [lien1], [lien2] et les declarer par action liens. |
| `csv` | texte | — | BDD publipostage : tableau CSV avec email et colonnes libres. Analyser avant importer. (max. caractères 2000000) |
| `curseur` | texte | — | Dernier identifiant traité ; 0 pour commencer. Conserver le curseur uniquement après traitement réussi de toute la page. (format `^[0-9]+$`, max. caractères 19) |
| `decalage` | entier | — | (min 0, max 1000000) |
| `depart` | texte | — | planifier : date et heure locales de Paris, AAAA-MM-JJTHH:MM (ex. 2026-09-22T09:00). Future. Les week-ends sont repousses au lundi. controler et depart : le départ à simuler (absent : celui posé, sinon le prochain jour ouvré à 8 h). |
| `domaine` | texte | — | expediteur : le domaine a declarer ou a retirer ; verifier_domaine : le domaine declare a controler (ex. masociete.fr). |
| `email` | texte | — | desinscrits : adresse a ajouter a la liste de suppression. destinataire : le destinataire a lire (ou envoi_id). bdd_publipostage_modifier : l'adresse du contact. |
| `envoi_id` | texte | — | Un envoi de la campagne, rendu par fil ou calendrier : declarer_reponse (envoi_pour_reponse), retirer (envoi_a_retirer), destinataire. (format `^[0-9a-fA-F-]{36}$`) |
| `equipe_jours` | entier | — | modifier : nombre de jours entre le décideur et son équipe (défaut 3). (min 0, max 30) |
| `etiquette` | texte | — | variante : etiquette courte (B, C, « version courte »). Avec objet et corps, ajoute une variante ; avec variante_id, reecrit celle-ci. |
| `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. |
| `fiche_id` | texte | — | bdd_publipostage_modifier : la fiche du contact, rendue par bdd_publipostage_lire. (format `^[0-9a-fA-F-]{36}$`) |
| `fil` | `` · `reponses` · `livres` · `a_venir` · `echecs` | — | fil : filtre de l'écran. vide = tous, réponses, livres (livraison confirmée), a_venir, echecs (refusés ou revenus). |
| `filtre` | texte | — | destinataires : texte libre sur le nom, la société, la ville ou l'adresse. |
| `format` | `texte` · `html` · `builder` | — | variante : format d'une version existante. html est assaini ; builder compile les blocs comme l'interface. |
| `liens` | liste de texte | — | liens : les adresses http(s) mesurees, dans l'ordre. La première est [lien1]. Remplace la liste existante. (max. éléments 10) |
| `limite` | entier | — | destinataires : nombre maximum de personnes (défaut 100). (min 1, max 2000) |
| `liste_id` | texte | — | UUID d'une liste de la base, ou audience:<UUID> pour une audience enregistrée. creer : reprend d'un geste les contacts de cette liste de Ma base (vérifiée avant de créer). |
| `mode` | `apercu` · `constituer` | — | destinataires : apercu compte sans rien écrire, constituer ajoute a la campagne. |
| `modele_id` | texte | — | creer : point de départ (le modèle remplace corps, et objet s'il est vide). modele_appliquer/modele_supprimer/modele_modifier : identifiant rendu par modeles, y compris catalogue:<nom> pour un modèle fourni. modele_creer avec modele_id : copie ce modèle sous le nom donné. |
| `nature` | `liste` · `segment` | — | — |
| `nom` | texte | — | creer/modifier : nom de la campagne (120 caracteres au plus). |
| `nom_modele` | texte | — | modele_sauver : nom du modèle enregistré à partir d'une variante existante (120 caractères maximum). |
| `objet` | texte | — | 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]). |
| `page` | entier | — | (min 0, max 1000000) |
| `page_fil` | entier | — | fil : page à lire, à partir de 1 (page_suivante la donne). (min 1, max 10000) |
| `periode` | `campagne` · `canal` | — | stats : campagne (le détail d'une campagne, par contact) ou canal (les chiffres du jour, des 7 et des 30 jours, forme commune aux canaux de prospection). |
| `personnalisation` | objet | — | message_apercu : valeurs du contact d'exemple. bdd_publipostage_modifier : colonnes du contact de Ma base (prenom, nom, entreprise, ville, fonction, ou une colonne libre comme marque) ; une valeur vide efface. |
| `personnalisation.fonction` | texte | — | (max. caractères 200) |
| `personnalisation.nom` | texte | — | (max. caractères 200) |
| `personnalisation.prenom` | texte | — | (max. caractères 200) |
| `personnalisation.societe` | texte | — | (max. caractères 200) |
| `personnalisation.ville` | texte | — | (max. caractères 200) |
| `plafond_jour` | entier | — | quota : envois au plus par jour pour cet espace. (min 1, max 20000) |
| `plafond_mois_inclus` | entier | — | quota : envois compris dans l'offre, par mois. (min 0, max 200000) |
| `prefere` | booléen | — | expediteur : faire de ce domaine celui d'ou l'espace écrit par défaut. Un seul par espace. |
| `prix_unitaire_cents` | entier | — | quota : prix HT en centimes de l'envoi au-dela du forfait. (min 0, max 1000) |
| `rang_max` | entier | — | destinataires : 1 décideurs seuls, 2 jusqu'a prioritaire, 3 jusqu'a secondaire, 4 tout le monde (défaut). (min 1, max 4) |
| `recherche` | texte | — | fil : nom, entreprise ou adresse. (max. caractères 160) |
| `relance_jours` | entier | — | modifier : intervalle entre relances (défaut 4). (min 1, max 60) |
| `relances_max` | entier | — | modifier : nombre de relances. Une campagne créée n'en a aucune (un seul envoi) : la sequence se regle ici, 1 a 3 relances. (min 0, max 3) |
| `repondre_a` | texte | — | creer/modifier : la boite ou arrivent les réponses (celle de l'utilisateur). Obligatoire avant de planifier. |
| `retirer` | booléen | — | expediteur : avec domaine, supprime la declaration. Les campagnes déjà ecrites sous ce domaine ne sont pas reecrites : elles passent en refus a l'envoi. |
| `signature` | texte | — | Empreinte rendue par bdd_publipostage_analyser, requise pour confirmer le même import. |
| `source` | `tous` · `crm` · `base` | — | destinataires : ou chercher. crm = le carnet de contacts, base = Ma base (coordonnées REVELEES seulement), tous = les deux. |
| `taille_page` | entier | — | Taille de page : événements, calendrier (100 par défaut), fil (25 par défaut, comme l'écran). (min 1, max 200) |
| `texte_apercu` | texte | — | objet : le court texte affiché après l'objet dans la boîte de réception ; vide pour l'effacer. (max. caractères 200) |
| `valeurs` | liste de objet | — | valeurs_poser : pour chaque destinataire à venir de la campagne, ses valeurs. Clés : prenom, nom, entreprise, ville, fonction, ou une valeur libre que le message cite ([marque] -> marque). Une valeur vide efface. (min. éléments 1, max. éléments 2000) |
| `variante_id` | texte | — | variante : UUID d'une variante existante a reecrire. objet, tester, destinataire : le message vise (absent : le premier, ou celui du destinataire). |

## Quand l'utiliser

lire ses colonnes, analyser puis importer un CSV, corriger un contact (bdd_publipostage_modifier).

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

```text
Liste les audiences de campagne de mon organisation.
```

Outil : `campagne_email_audiences` · 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 | `POST /api/mcp/v1/email.audiences.list` : [email.audiences.list](https://prescriptio.fr/docs/api/email.audiences.list) |

## 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-gerer-campagnes](https://prescriptio.fr/skills/prescriptio-gerer-campagnes) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

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

- [Campagnes e-mail](https://prescriptio.fr/docs/campagnes-email) : Documentation, Les modules
- [Campagnes e-mail de bout en bout](https://prescriptio.fr/docs/guides/campagnes-email) : Guides, Parcours complets
- [Travailler une campagne e-mail](https://prescriptio.fr/skills/prescriptio-gerer-campagnes) : IA, Les skills du plugin

## Voir aussi

- [email.audiences.list](https://prescriptio.fr/docs/api/email.audiences.list) : La même action, en opération REST
- [campagne_email](https://prescriptio.fr/docs/api/campagne_email) : Gérer une campagne e-mail de bout en bout : créer le brouillon (depuis un modèle ou une liste de Ma base),…
- [campagne_email_destinataires](https://prescriptio.fr/docs/api/campagne_email_destinataires) : Les destinataires d'une campagne : constituer la liste (coordonnées déjà détenues, sans révélation),…
- [campagne_email_modeles](https://prescriptio.fr/docs/api/campagne_email_modeles) : Gérer les modèles de campagnes e-mail, en texte, HTML assaini ou blocs
- [campagne_email_expediteur](https://prescriptio.fr/docs/api/campagne_email_expediteur) : Configurer l'identité et les domaines d'expédition de l'espace
- [campagne_email_suivi](https://prescriptio.fr/docs/api/campagne_email_suivi) : Lire les statistiques, les échecs rangés par cause en mots (echecs), les événements d'envoi et les…
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module