Campagnes e-mail de bout en bout | Documentation Prescriptio

Un message ne part que sur un test, une planification ou un envoi unitaire que vous demandez. Les réponses ne sont pas lues dans une boîte : elles se déclarent, et les relances de la personne s'arrêtent.

Une campagne Prescriptio part des contacts que votre organisation possède déjà, dans votre carnet ou dans votre base. Pour chaque entreprise, celui que vous avez désigné comme décideur reçoit le premier message ; son équipe, quelques jours plus tard. Vous relisez le calendrier avant le premier envoi, et chaque message parti rejoint le fil du prospect, à côté de ses messages LinkedIn. Ce guide suit le même parcours de trois façons : dans l'application, avec votre agent IA, et par l'API.

Avant de commencer

L'abonnement Prescriptio. Il comprend 500 envois par mois pour toute l'organisation, 300 par jour au plus. L'option e-mail, à 10 € HT par mois et par organisation, porte ce total à 10 000 et ouvre l'envoi depuis votre propre domaine vérifié, à 1 000 par jour au plus. Le domaine commun reste limité à 300 par jour, même avec l'option. Au plafond, les nouveaux envois s'arrêtent jusqu'au mois suivant : rien n'est facturé en plus. Un compte gratuit prépare une campagne, mais aucun e-mail ne part.
Des contacts avec une adresse : ceux de votre carnet, et les fiches de votre base dont vous avez révélé l'adresse. Une adresse publiée par une entreprise (page de contact, mentions légales) entre aussi, avec la page où elle est écrite. Jamais une adresse devinée.
Votre adresse de réponse. Les réponses arrivent dans votre boîte ; elle est obligatoire avant de planifier.
Votre agent IA connecté à Prescriptio à l'adresse complète du connecteur, https://prescriptio.fr/api/mcp : voir Connecter votre agent IA. À l'adresse des connecteurs ChatGPT et Claude, qui se termine par /connectors, votre agent ne voit que quatre outils et ce parcours s'arrête.
Pour l'API : une autorisation OAuth avec la portée mcp:read ou mcp:write selon l'opération. Voir Authentification et quotas.

Les étapes en un coup d'œil

Étape	Dans l'application	Avec votre agent IA
Expéditeur	lignes « De » et « Réponses à »	`campagne_email_expediteur` : `expediteur`, `verifier_domaine`
Brouillon	« Nouvelle campagne », depuis un modèle ou une liste	`campagne_email` : `creer`
Message	page du message : lettre, blocs, variantes et liens	`campagne_email` : `variante`, `objet`, `liens`
Destinataires	« Destinataires »	`campagne_email_destinataires` : `constituer`, `adresse_publiee`, `valeurs_poser`
Contrôle	vue « Départ », « Contrôle avant envoi »	`campagne_email` : `controler`, `depart`
Test	« Envoyer un test »	`campagne_email` : `tester`
Départ	vue « Départ », « Planifier le départ »	`campagne_email` : `planifier`
Suivi	vue « Suivi », réponses déclarées	`campagne_email_suivi` : `statistiques`, `echecs`, `declarer_reponse`

Dans l'application

Créez la campagne
Dans Mes campagnes, « Nouvelle campagne » : un nom, un objet, un message. Le message se compose sur la page de la campagne ; les volets sont Aperçu, Destinataires, Départ et Suivi. Partez d'un modèle, ou reprenez d'un geste une liste de votre base.
Composez le message
Par blocs : titre, texte, image, bouton, citation. Les champs [prénom], [nom], [entreprise], [ville] et [fonction] se remplacent pour chaque destinataire ; des variantes du même message et des liens dont les clics sont comptés s'ajoutent.
Choisissez les destinataires
Les destinataires sont regroupés par entreprise. Le meilleur rang posé (décideur, prioritaire, secondaire) passe en premier ; à rang égal, l'ordre de la liste décide. La règle de l'organisation espace les collègues un à un, de trois jours par défaut, même sans décideur désigné. Une fiche sans adresse révélée est comptée et signalée, jamais utilisée. Jusqu'à 2 000 destinataires par campagne.
Réglez l'expéditeur et les relances
L'expéditeur est celui de votre organisation : le domaine commun, vérifié, par défaut ; votre propre domaine avec l'option, une fois sa preuve DNS vérifiée. Une campagne n'a aucune relance tant que vous n'en réglez pas : de une à trois, quatre jours d'écart par défaut.
Vérifiez, puis testez
Dans Départ, « Contrôle avant envoi » dit ce qui bloque et ce qui avertit : identité, message, qualité de la liste, règles de sollicitation et quota. « Envoyer un test » fait arriver le message dans votre boîte avant le premier destinataire : cinq essais au plus en dix minutes, et un test réellement envoyé compte dans vos envois.
Lisez le calendrier, puis planifiez
Le calendrier dit qui est prévu, qui attendra et pour quelle raison. « Planifier le départ » pose une date et une heure au plus tôt, à l'heure de Paris. Les créneaux de l'organisation, jours fériés et jours sans envoi sont appliqués ; hors créneau, le départ attend le premier moment autorisé. Vous pouvez mettre en pause, reprendre ou arrêter la campagne.
Suivez, et notez les réponses
La vue Suivi distingue les envoyés, les échecs, les clics, les désinscriptions et les réponses notées. Quand un contact vous répond, « A répondu » d'un clic : ses relances s'arrêtent et sa fiche de prospection le sait.

Par l'API

Les mêmes fonctions s'appellent en REST : POST /api/mcp/v1/{operation}, un corps JSON, une autorisation OAuth mcp:read ou mcp:write selon la fiche de l'opération. Les routes REST et le connecteur partagent les quotas d'appels et les droits de l'organisation.

Étape	Opérations	Résultat à contrôler
Domaine	`email.domains.create`, puis `email.domains.list`	la preuve TXT à publier, nom et valeur
Vérification	`email.domains.verify`	le domaine est utilisable avant de devenir expéditeur
Brouillon	`email.campaigns.create`	l'identifiant de la campagne ; aucun message ne part
Message	`email.campaigns.get`, `email.messages.upsert`	la variante ; format texte, HTML ou blocs
Modèles	`email.templates.list`, `save`, `apply`, `delete`	un modèle appliqué remplace le premier message
Test	`email.messages.test`	l'acceptation du fournisseur
Audience	`email.recipients.preview`, puis `email.recipients.add`	prévisualiser avant d'écrire ; seules les adresses détenues entrent
Publipostage d'une liste	`bdd.mailmerge.preview`, puis `bdd.mailmerge.import`	un CSV avec l'e-mail et des colonnes libres, confirmé par la signature rendue ; aucun envoi
Départ	`email.campaigns.schedule`	le calendrier est posé ; les envois partent dans le créneau ouvré, à l'heure de Paris
Suivi	`email.campaigns.get`, `email.metrics.get`	acceptation, livraison, échecs, clics et désinscriptions ont des sens distincts

{"campagne_id":"<UUID>","variante_id":"<UUID>","objet":"Bonjour [prenom]","format":"builder","blocs":[{"kind":"titre","text":"Bonjour [prenom]"},{"kind":"texte","text":"Découvrez notre équipe."},{"kind":"bouton","text":"En savoir plus","url":"[lien1]"}]}

Déclarez le lien avec email.links.replace avant de planifier. L'API rend les valeurs DNS de chaque domaine ; elle ne modifie pas la zone DNS chez votre hébergeur.

Envoi unitaire et rejeu

email.messages.send (action envoyer) demande cle_idempotence, email, objet, le contenu (corps ou blocs) et une adresse de réponse, explicite ou enregistrée dans l'identité. Il utilise le domaine vérifié, les exclusions et les plafonds communs ; un quota atteint le laisse en attente.

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

Gardez la clé pour chaque message logique : la même clé et la même requête retrouvent le même envoi ; une autre requête avec cette clé est refusée. Après un délai dépassé, rejouez la requête identique ou appelez email.messages.get, sans créer de nouvelle clé. en_cours peut signifier une issue encore inconnue chez le fournisseur : aucun renvoi automatique n'est fait. mode=journal signifie aucun envoi réel.

Événements à consommer

email.events.poll (action evenements) lit le journal de l'organisation par pages de 200 au plus. Premier appel : curseur:"0" ; après traitement réussi de toute la page, gardez fields.curseur_suivant. Une page vide laisse le curseur inchangé ; un rejeu rend les mêmes identifiants, à dédoublonner par id. Les types message.* décrivent le traitement, livraison.* le retour du fournisseur, desinscription une adresse exclue, activite.* un clic, un envoi ou une réponse. Les dates sont en UTC, au format ISO 8601 ; les événements de livraison arrivent après la synchronisation avec le fournisseur, sans délai garanti.

Identité, audiences, modèles et suivi sans interface

email.identity.get et email.identity.update lisent et modifient l'identité par défaut (un administrateur pour la modification). email.audiences.list, create, update et delete gèrent les listes et segments, avec des identifiants base:<UUID> ou crm:<UUID>. email.messages.preview rend l'objet, le texte et le HTML personnalisés, sans agir sur aucun destinataire réel. email.recipients.list lit le calendrier par pages de 1 à 200 touches ; email.recipients.delete retire une touche non envoyée ; email.recipients.reply annule les relances après une réponse déclarée. email.campaigns.delete refuse une campagne qui a déjà envoyé. email.deliveries.refresh contrôle au plus trois livraisons dues par appel.

Le résultat attendu

Le départ, jour par jour, puis une semaine de suiviExemple · données fictives

Données d'exemple : campagne, entreprises, volumes et dates fictifs.

Campagne « Lancement de l'enduit chaux-chanvre, Grand Ouest » · 84 destinataires dans 31 entreprises · 3 fiches sans adresse révélée, signalées et écartées.

Jour (Paris)	Qui part	Envois
lundi 12/10, à partir de 9 h	les décideurs	31
à partir du jeudi 15/10	les collègues, espacés un à un dans chaque entreprise	53 à répartir
à partir du lundi 19/10	premières relances admissibles, après sept jours au moins	selon le contrôle

À relire avant le départ : les destinataires qui attendront, ceux qu'une règle écarte, la qualité des adresses et le quota. Ces dates sont indicatives : une réponse, une exclusion ou une pause automatique peut encore modifier les envois. Les ouvertures restent indicatives.

Les outils mobilisés

Outil	Ce qu'il fait dans ce parcours
`campagne_email`	crée, compose, contrôle, teste, planifie, met en pause, arrête
`campagne_email_destinataires`	constitue la liste, lit le fil, pose les valeurs, retire les adresses écartées
`campagne_email_expediteur`	déclare et vérifie le domaine, lit et règle l'identité
`campagne_email_modeles`	gère les modèles de campagne
`campagne_email_audiences`	gère les audiences et le publipostage d'une liste de votre base
`campagne_email_suivi`	lit les statistiques et les échecs, déclare une réponse
`campagne_email_quotas`	lit la consommation et les plafonds
`campagne_email_desinscriptions`	lit les désinscriptions, ajoute une exclusion

Ce que le parcours ne fait pas

Il ne promet aucun taux de livraison ni de réponse.
Il ne lit pas votre boîte. Les réponses arrivent chez vous ; notez-les d'un clic, ou faites-les déclarer par votre agent.
Il ne révèle aucune adresse. Seules entrent les adresses que votre organisation détient déjà.
Il ne prend pas les ouvertures pour des lectures. Certaines messageries chargent l'image de suivi pour tout le monde : les ouvertures sont indicatives ; les clics, les désinscriptions et les échecs sont relevés.
Il ne confond pas accepté et livré. « Envoyé » veut dire accepté par la passerelle ; la livraison se confirme séparément.
Il ne facture aucun dépassement. Au plafond, les envois s'arrêtent.
Il applique les règles de l'organisation. Par défaut : deux messages sur trente jours, sept jours entre deux messages, trois jours entre deux collègues et soixante jours sans nouvelle campagne après une réponse. Le calendrier les applique avant le départ, et l'envoi les vérifie à nouveau.
Il peut suspendre une campagne. Après une première vague de cinquante messages au plus, le suivi conditionne la suite ; trop de retours entraînent une pause automatique. Un domaine d'envoi suspendu retient aussi les messages.
Il ne touche pas à votre zone DNS. Il vous donne les valeurs à publier chez votre hébergeur.
Il ne recontacte jamais un désinscrit.

Pour aller plus loin

Campagnes e-maille module, ses écrans et son offre.Préparer un e-mail de prospection individuelun e-mail long, pour une seule personne.campagne_emailtoutes les actions et leurs paramètres.Authentification et quotasOAuth, portées et plafonds d'appels.