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

# Gérer les désinscriptions

L’outil campagne_email_desinscriptions de Prescriptio lit et complète la liste d’exclusion de votre organisation. Il permet une réinscription sur demande écrite et confirmation explicite, ainsi que l’exclusion ou le rétablissement d’un domaine.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

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

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

### Forme de la réponse pour la lecture des exclusions

```json
{
  "action": "desinscrits_lus",
  "fields": {
    "desinscrits": [
      { "au": "<texte>", "email": "<texte>", "origine": "<texte>" }
    ],
    "total": "<entier>",
    "ne_veulent_plus_recevoir": "<entier>",
    "adresses_qui_ne_fonctionnent_pas": "<entier>",
    "domaines_exclus": "<entier>"
  },
  "note": "<texte>",
  "ok": true
}
```
Les marqueurs entre chevrons indiquent les types, pas des valeurs à attendre. Les trois autres actions rendent respectivement `reinscrite`, `domaine_exclu` ou `domaine_retabli`, avec les champs propres à leur résultat.

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `action` | `desinscrits` · `reinscrire` · `domaine_exclure` · `domaine_retablir` | — | Défaut : `desinscrits`. Lit les exclusions, réinscrit une personne à sa demande, exclut un domaine ou le rétablit. |
| `email` | texte | selon l’action | `desinscrits` : absent pour lire, présent pour exclure cette adresse. `reinscrire` : adresse à réinscrire, obligatoire. |
| `raison` | texte | — | Motif de l’exclusion lors de `desinscrits` avec `email` ; 300 caractères au plus, conservé avec son auteur. |
| `demande` | texte | pour `reinscrire` | Demande écrite de la personne, avec sa date et son canal ; de 10 à 600 caractères. |
| `accord` | booléen | pour `reinscrire` | Doit valoir `true` : l’utilisateur confirme que la personne a demandé à recevoir de nouveau ses messages. |
| `domaine` | texte | pour les actions de domaine | Domaine destinataire à exclure ou à rétablir, par exemple `cabinet-dupont.fr`. Une messagerie publique ne peut pas être exclue en entier. |

Le tableau décrit les paramètres utilisés par ces quatre actions. Le schéma partagé des campagnes annonce aussi des champs destinés aux autres outils ; ils ne changent pas les actions autorisées ici.

## Quand l'utiliser

Sans `email`, `desinscrits` lit les 500 exclusions les plus récentes et donne les compteurs de toute l’organisation. Avec `email`, il ajoute l’adresse à la liste d’exclusion, avec une `raison` facultative.

`reinscrire` exige une demande écrite de la personne et `accord: true`. Une adresse en échec ne peut pas être réinscrite. Si son domaine reste exclu, cette réinscription ne lui ouvre aucun envoi.

`domaine_exclure` exclut le domaine destinataire de tous les envois de l’organisation et annule les messages prévus vers lui. `domaine_retablir` retire cette exclusion de domaine : les exclusions individuelles restent en place et les messages annulés ne repartent pas.

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

```text
Qui s'est désinscrit de mes campagnes ce mois-ci ?
```

Outil : `campagne_email_desinscriptions` · 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.suppressions.list` : [email.suppressions.list](https://prescriptio.fr/docs/api/email.suppressions.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_desinscriptions`.

- [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.suppressions.list](https://prescriptio.fr/docs/api/email.suppressions.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_audiences](https://prescriptio.fr/docs/api/campagne_email_audiences) : Lister, créer, modifier et supprimer les audiences de campagnes propres à votre organisation ; le…
- [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
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module