Comment envoyer des emails et des SMS avec un agent IA (guide de l'API Mailpro™)

Les grands modèles de langage ne se contentent plus de discuter. Avec le tool use, le function calling et le Model Context Protocol, ils sont devenus des agents qui agissent — et l'une des actions les plus utiles qu'ils puissent accomplir est d'envoyer un email ou un SMS à votre place. Ce guide pilier explique comment connecter Claude, GPT, Gemini ou n'importe quel agent IA moderne aux API Mailpro pour qu'il délivre de vrais messages dans de vraies boîtes mail et sur de vrais téléphones.

En résumé

• Mailpro propose trois API que votre agent IA peut appeler : Email v2, CRM v3, SMS.
• Chaque endpoint est documenté sur notre portail développeurs avec des exemples de code prêts à copier dans plus de 20 langages de programmation.
• Email v2 pour les envois simples et les campagnes, CRM v3 pour tout l'écosystème contacts et intégrations, SMS pour les messages courts et les OTP.
• Les agents IA s'intègrent via du HTTPS + JSON standard, sans SDK propriétaire.

Pourquoi donner à votre agent IA le pouvoir d'envoyer des emails et des SMS ?

Du chatbot à l'action : le virage des IA agentiques

Jusqu'à récemment, une conversation avec un LLM s'arrêtait au prompt. Le modèle vous écrivait un brouillon, un résumé, un bout de code — et c'était à vous de faire le dernier kilomètre. Avec le tool use (terme d'Anthropic), le function calling (terme d'OpenAI) ou le Model Context Protocol (standard ouvert émergent), le modèle décide d'appeler une fonction externe, et vous exécutez cet appel. D'un coup, l'agent peut consulter un enregistrement, calculer quelque chose, et envoyer un message.

Cette dernière étape — l'envoi — est celle qui transforme l'IA d'un jouet en véritable process métier. Un agent qui répond à un ticket de support, c'est bien. Un agent qui y répond et qui envoie la solution par email, c'est une heure de support économisée.

Quatre cas d'usage concrets

• Envoi transactionnel intelligent. L'agent rédige une confirmation de commande personnalisée, une relance promotionnelle, un email de reset de mot de passe, puis le dispatche via l'API Email v2 Mailpro.
• Campagnes déclenchées par événement. Donnez à l'agent un brief de campagne et une liste cible : il rédige le texte, programme l'envoi et vous renvoie l'identifiant de campagne.
• Hygiène CRM à grande échelle. L'agent lit des données de leads chaotiques, les nettoie, les tague, les affecte à un segment — le tout via l'API CRM v3 Mailpro.
• OTP à la demande. L'agent demande un code à usage unique par SMS via l'API SMS pour vérifier l'identité d'un utilisateur en plein milieu d'un chat.

Dans tous les cas, l'agent ne vous « remplace » pas : il ferme la boucle entre décider et agir.

Les API Mailpro en 30 secondes

Mailpro expose trois API REST, chacune conçue pour un rôle précis. Un agent peut en utiliser une, deux ou les trois dans le même workflow. Toutes sont servies depuis api.mailpro.com et documentées sur notre portail développeurs, avec des exemples de code copiables dans plus de 20 langages (cURL, Python, Node.js, PHP, Go, Ruby, C#, Java, Swift, Kotlin et bien d'autres).

Email API v2 — simple et directe pour envoyer

La plus directe des trois. Si vous voulez simplement envoyer un email C'est l'API à choisir dès que vous travaillez sur le répertoire de vos destinataires, pas seulement sur l'envoi. C'est aussi celle qu'utilisent les intégrations no-code et partenaires.

Besoin d’email et de SMS au même endroit ? Les offres Mailpro donnent à votre agent IA les deux canaux via une seule API — une intégration, une facture prévisible.

• Envoyer un SMS (unitaire ou campagne) ? → API SMS. Un channel à part, avec sa propre auth et ses propres crédits.

Les trois API coexistent : un même contact Mailpro est visible depuis v2 et v3. Rien n'empêche votre agent d'utiliser v3 pour créer proprement un contact avec ses tags, puis v2 pour lui envoyer un email, puis la SMS API pour lui envoyer un rappel.

Un exemple minimal : Claude envoie un email à votre liste VIP

Le motif le plus propre consiste à exposer un wrapper fin autour de l'API Mailpro comme un outil que l'agent peut appeler. Voici la version minimale en Python avec le SDK d'Anthropic :

import anthropic
import requests

ANTHROPIC_KEY = "sk-ant-..."
MAILPRO_ID = 123456         # YOUR_ID_CLIENT
MAILPRO_KEY = "YOUR_API_KEY"  # ne jamais envoyer cette clé au modèle

client = anthropic.Anthropic(api_key=ANTHROPIC_KEY)

# 1. Déclarer l'outil
tools = [{
    "name": "send_email_campaign",
    "description": "Envoie une campagne email à une liste Mailpro.",
    "input_schema": {
        "type": "object",
        "properties": {
            "list_id":  {"type": "integer", "description": "ID de la liste Mailpro"},
            "subject":  {"type": "string"},
            "html":     {"type": "string", "description": "Corps HTML complet"}
        },
        "required": ["list_id", "subject", "html"]
    }
}]

# 2. Demander à Claude de composer la campagne
msg = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=tools,
    messages=[{
        "role": "user",
        "content": "Rédige un email de soldes de printemps pour notre liste VIP (ID 42) et envoie-le."
    }]
)

# 3. Exécuter l'appel d'outil
for block in msg.content:
    if block.type == "tool_use" and block.name == "send_email_campaign":
        args = block.input
        r = requests.post(
            "https://api.mailpro.com/v2/send/campaign.json",
            params={"IdClient": MAILPRO_ID, "ApiKey": MAILPRO_KEY},
            data={
                "AddressBookId": args["list_id"],
                "Subject":       args["subject"],
                "Body":          args["html"]
            }
        )
        print("Réponse Mailpro :", r.json())

Deux points clés : la clé API reste dans votre code (jamais dans le prompt), et l'agent ne voit que la forme de l'outil — il n'a pas besoin des credentials pour faire son travail. C'est le fondement de tout pattern d'intégration agentique. Pour voir le même appel dans un autre langage, la documentation de l'API Email v2 propose le snippet équivalent en Node.js, PHP, Go, Ruby, C# et une vingtaine d'autres.

Sécurité et bonnes pratiques pour l'envoi piloté par IA

Les systèmes agentiques sont rapides et partent en éventail. Une boucle mal configurée peut expédier des milliers de messages indésirables en quelques minutes. Quatre règles à respecter :

Ne jamais exposer votre clé API au LLM directement

Le modèle doit recevoir le schéma de l'outil, pas les credentials. Gardez la clé dans des variables d'environnement côté serveur et injectez-e9alise la requête HTTPS. Le portail développeurs montre les requêtes exactes à émettre dans votre langage préféré.

Quelle est la différence entre email transactionnel et campagne ?

Un email transactionnel est un message un-à-un déclenché par un événement (confirmation de commande, reset de mot de passe). Une campagne est un message un-à-plusieurs envoyé à une liste. Mailpro gère les deux — le détail de chaque endpoint est dans notre guide v2.

Faut-il un plan payant pour commencer avec les agents IA ?

Non — vous pouvez démarrer sur l'offre gratuite, tout tester, et passer à un plan payant quand votre volume le justifie. Voir les tarifs.

Quels modèles IA fonctionnent avec l'API Mailpro ?

Tout modèle qui supporte le function calling ou le tool use : Anthropic Claude, OpenAI GPT-4/5, Google Gemini, Mistral, et les modèles locaux via Ollama ou LM Studio. L'API est en HTTP + JSON, le modèle n'a qu'à émettre un appel d'outil JSON valide.

Est-il sûr de laisser un agent IA envoyer des emails en autonomie ?

Oui, avec des garde-fous : cantonnez la portée de la clé API, imposez des rate limits côté code, conservez des logs d'audit, et ajoutez une confirmation humaine pour les envois à fort enjeu (campagnes bulk, destinataires inconnus).