Gérer les désinscriptions | Documentation Prescriptio

Les adresses en échec ne peuvent pas être réinscrites. Rétablir un domaine ne réinscrit pas ses adresses exclues individuellement et ne relance aucun message annulé. Chaque appel consomme une unité de quota.

exemple synthétique

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

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"}}'

{
  "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

actiondesinscrits · reinscrire · domaine_exclure · domaine_retablir

Défaut : desinscrits. Lit les exclusions, réinscrit une personne à sa demande, exclut un domaine ou le rétablit.

emailtexte

desinscrits : absent pour lire, présent pour exclure cette adresse. reinscrire : adresse à réinscrire, obligatoire.

raisontexte

Motif de l’exclusion lors de desinscrits avec email ; 300 caractères au plus, conservé avec son auteur.

demandetexte

Demande écrite de la personne, avec sa date et son canal ; de 10 à 600 caractères.

accordbooléen

Doit valoir true : l’utilisateur confirme que la personne a demandé à recevoir de nouveau ses messages.

domainetexte

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.

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

Le prompt qui le déclenche

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

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

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 et Authentification et quotas.

Les skills qui s'en servent

prescriptio-gerer-campagnesLe 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-mailDocumentation, Les modules Campagnes e-mail de bout en boutGuides, Parcours complets Travailler une campagne e-mailIA, Les skills du plugin

Voir aussi

email.suppressions.listLa même action, en opération REST campagne_emailGé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_destinatairesLes destinataires d'une campagne : constituer la liste (coordonnées déjà détenues, sans révélation),…campagne_email_audiencesLister, créer, modifier et supprimer les audiences de campagnes propres à votre organisation ; le…campagne_email_modelesGérer les modèles de campagnes e-mail, en texte, HTML assaini ou blocs campagne_email_expediteurConfigurer l'identité et les domaines d'expédition de l'espace Catalogue des outilsTous les outils, rangés par module

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"}}'

{ "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 }

[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