API d'emails transactionnels pour agents IA : guide Mailpro™ v2

Si vous avez lu notre guide pilier sur les agents IA et l'API Mailpro™, vous savez déjà pourquoi connecter un agent IA à une API d'email est le chemin le plus court entre « chatbot » et « collègue numérique ». Cet article se concentre sur une API précise — l'API Email Mailpro™ v2 — et propose un setup fonctionnel pour l'envoi transactionnel comme pour les campagnes, pilotés par Claude, GPT ou n'importe quel LLM qui supporte le tool calling.

En résumé

• L'API Email Mailpro v2 attend IdClient + ApiKey en HTTPS — pas besoin de SDK.
• Les deux endpoints principaux sont /send/sendmail.json (transactionnel) et /send/campaign.json (bulk).
• N'importe quel LLM avec tool calling peut piloter l'API via un wrapper minimal.
• Chaque endpoint est documenté dans plus de 20 langages sur notre portail développeurs.

Les cas d'usage qui comptent pour l'email piloté par IA

Des confirmations de commande intelligentes

Les confirmations de commande standard sont template-shaped. Votre agent IA peut aller plus loin : rédiger une note personnelle (« Merci d'avoir choisi le modèle XL Bleu, un favori de nos clientes ») et attacher des recommandations dynamiques, puis appeler l'API Email pour expédier l'ensemble. Vous conservez la fiabilité d'un template structuré, avec la chaleur d'une note écrite par une personne.

Auto-triage du support

Quand un ticket arrive, l'agent le classe, rédige une réponse, et — si sa confiance est suffisante — l'envoie directement. Les tickets à faible confiance partent vers un humain. Ce modèle hybride est exactement ce que les équipes support en production déploient aujourd'hui.

Génération de digests

À l'échelle, les dirigeants veulent des synthèses, pas des flots. Un agent lit 40 factures par jour et émet un digest exécutif à 18 h : « Aujourd'hui : 12 payées, 3 en retard, 2 à vérifier. » Un email, zéro bruit. L'API Email Mailpro gère la livraison, le LLM gère la synthèse.

Setup en 5 minutes

1. Récupérer votre IdClient et votre ApiKey

Les deux sont dans votre compte Mailpro sous Paramètres → Accès API. L'IdClient est un identifiant numérique ; l'ApiKey est un GUID. Gardez la clé secrète — traitez-la comme un mot de passe.

2. Vérifier les credentials avec /account/credits.json

Avant de brancher Claude, assurez-vous que vos credentials fonctionnent :

curl "https://api.mailpro.com/v2/account/credits.json?IdClient=YOUR_ID&ApiKey=YOUR_API_KEY"

Vous devriez recevoir un JSON avec votre solde de crédits email. Si vous voyez un 401, vérifiez la clé. Si vous voyez un 500, consultez notre page de statut.

3. Explorer la référence complète

Chaque endpoint est documenté — avec la forme des requêtes / réponses et un bandeau « essayer en direct » — sur la référence de l'API Email v2. Ouvrez-la dans un second onglet et gardez-la à portée.

Pas à pas : faire envoyer un email transactionnel par Claude

Nous utilisons Claude d'Anthropic pour cet exemple, mais le même pattern fonctionne avec le function calling d'OpenAI ou le tool use de Gemini — le SDK change, l'architecture reste.

1. Définir le schéma de l'outil

Vous mettez en place des envois transactionnels ? Les emails automatiques de Mailpro se déclenchent instantanément à chaque événement — reçus, confirmations, alertes — avec une livraison fiable.

tools = [{
    "name": "send_transactional_email",
    "description": "Envoie un email ponctuel à un destinataire unique via Mailpro.",
    "input_schema": {
        "type": "object",
        "properties": {
            "to":      {"type": "string", "format": "email"},
            "subject": {"type": "string"},
            "html":    {"type": "string", "description": "Corps HTML complet"},
            "from":    {"type": "string", "description": "Adresse d'expéditeur validée"}
        },
        "required": ["to", "subject", "html", "from"]
    }
}]

2. Rédiger le prompt système

Tu es un assistant qui aide les chargés de clientèle à rédiger et envoyer
des emails de suivi. Quand l'humain confirme, utilise l'outil
`send_transactional_email`. Sois concis, coer un modèle de message avec /message/add

    

curl -X POST "https://api.mailpro.com/v2/message/add.json" \ -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \ -d "Subject=Soldes de printemps — 30% de remise" \ -d "Body=<html>...[FirstName]... <a href=\"{link}\">Je profite</a></html>"

L'agent peut générer le Body HTML directement. Utilisez [FirstName], [LastName] et les autres placeholders Mailpro pour la personnalisation par contact — l'API les résout au moment de l'envoi avec les données de votre liste.

Lancer la campagne avec /send/campaign.json

curl -X POST "https://api.mailpro.com/v2/send/campaign.json" \
  -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \
  -d "AddressBookId=42" \
  -d "IDMessage=9001" \
  -d "PlanDate=2026-05-01T09:00:00"

PlanDate est optionnel — omettez-le et la campagne part immédiatement. Ajoutez-le et Mailpro programme l'envoi pour vous. Bon pattern : laissez l'agent choisir PlanDate en fonction du fuseau horaire du destinataire.

Personnalisation avec les placeholders

Les placeholders comme [FirstName] et [LastName] sont standards ; les champs personnalisés ([Field1], [Field2]…) mappent sur les colonnes personnalisées de votre liste dans l'ordre où vous les avez définies. L'agent n'a pas besoin de connaître les valeurs — il référence le placeholder dans son HTML, et l'API remplit par destinataire.

Importer des contacts en masse depuis un upload de l'agent

Quand la première action du workflow de 00e0 [email protected]" }] }); for (const block of resp.content) { if (block.type === "tool_use") { const r = await fetch(`https://api.mailpro.com/v2/send/sendmail.json?IdClient=${ID}&ApiKey=${KEY}`, { method: "POST", body: new URLSearchParams({ EmailTo: block.input.to, Subject: block.input.subject, Body: block.input.html, EmailFrom: block.input.from }) }); console.log(await r.json()); } }

cURL one-liner

curl -X POST "https://api.mailpro.com/v2/send/sendmail.json" \
  -d "IdClient=YOUR_ID&ApiKey=YOUR_API_KEY" \
  -d "[email protected]" \
  -d "Subject=Votre reçu" \
  -d "Body=<h1>Merci Jeanne !</h1>" \
  -d "[email protected]"

Pour le même appel dans une vingtaine d'autres langages (PHP, Go, Ruby, C#, Java, Swift…), ouvrez la référence de l'API Email v2 — chaque endpoint propose le snippet équivalent prêt à copier.

Pièges et astuces

• Champs de réponse en PascalCase. v2 renvoie Result, IDSend, RemainingCredits (pas en camelCase). Si votre agent parse les réponses, précisez-le dans le prompt système — sinon il hallucinera result et idSend.
• Les adresses désinscrites sont écartées silencieusement. Ne passez Force=1 sur /email/add que si vous avez un consentement explicite — cela court-circuite la vérification opt-out, ce qui est un risque RGPD sinon.
• La limite de débit est de 500 requêtes / minute par clé. Regroupez les con