Intégration IA
Envoyez des SMS depuis vos agents IA
Vous développez un agent IA, un chatbot ou un assistant intelligent et vous souhaitez qu'il puisse envoyer des SMS à vos utilisateurs ? L'API SMS Vert Pro V2 est conçue pour s'intégrer facilement dans n'importe quel workflow d'intelligence artificielle.
Que votre agent soit construit avec LangChain, CrewAI, AutoGen, Claude (MCP), ChatGPT (function calling) ou tout autre framework, notre API REST JSON permet d'ajouter l'envoi de SMS comme outil (tool) en quelques lignes de code.
Pourquoi intégrer le SMS dans votre agent IA ?
- Notifications en temps réel : votre agent envoie un SMS quand il détecte un événement important (alerte, changement de statut, livraison)
- Confirmation d'actions : après une réservation, une commande ou une inscription traitée par l'IA, un SMS de confirmation est envoyé automatiquement
- Authentification OTP : sécurisez les actions sensibles avec un code à usage unique envoyé par SMS et vérifié via l'API
- Rappels automatiques : votre agent programme des SMS de rappel (rendez-vous, échéances, renouvellements)
- Communication client : l'IA répond aux demandes et peut envoyer un récapitulatif par SMS au client
Comment ça marche ?
L'intégration se fait en 3 étapes :
Créez un compte
Inscription gratuite avec 10 SMS offerts. Générez votre token API Bearer depuis l'API pour authentifier vos requêtes.
Définissez le tool
Déclarez l'envoi de SMS comme un outil disponible pour votre agent IA. Un simple appel HTTP POST avec le texte, le destinataire et l'expéditeur suffit.
L'agent envoie
Quand l'agent décide d'envoyer un SMS, il appelle le tool qui fait un POST à notre API. Le SMS est délivré en quelques secondes.
L'intégration du SMS dans un agent IA est simple et rapide. Votre agent déclare l'envoi de SMS comme un outil disponible, et notre API gère le reste : envoi, délivrabilité, accusés de réception.
Quel que soit le framework utilisé, l'appel se résume à un POST HTTP en JSON avec le destinataire et le message.
Exemple : tool definition pour un agent IA
Voici comment déclarer l'envoi de SMS comme outil dans les principaux frameworks :
Python (LangChain / fonction générique)
import requests
def send_sms(to: str, text: str, sender: str = "MonApp") -> dict:
"""Envoie un SMS à un destinataire via SMS Vert Pro."""
response = requests.post(
"https://www.smsvertpro.com/api/v2/",
headers={
"Content-Type": "application/json",
"Authorization": "Bearer VOTRE_TOKEN"
},
json={
"request": "send_sms",
"message": {"sender": sender, "text": text},
"recipients": [to]
}
)
return response.json()
# L'agent appelle : send_sms("33612345678", "Votre RDV est confirmé pour demain 10h.")
Vérification OTP (authentification à double facteur)
def generate_otp(gsm: str) -> dict:
"""Génère et envoie un code OTP par SMS."""
return requests.post("https://www.smsvertpro.com/api/v2/",
headers={"Authorization": "Bearer VOTRE_TOKEN", "Content-Type": "application/json"},
json={"request": "generate_otp", "gsm": gsm}
).json()
def verify_otp(gsm: str, code: str) -> dict:
"""Vérifie un code OTP saisi par l'utilisateur."""
return requests.post("https://www.smsvertpro.com/api/v2/",
headers={"Authorization": "Bearer VOTRE_TOKEN", "Content-Type": "application/json"},
json={"request": "verify_otp", "gsm": gsm, "code": code}
).json()
Node.js / JavaScript
async function sendSms(to, text, sender = "MonApp") {
const res = await fetch("https://www.smsvertpro.com/api/v2/", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer VOTRE_TOKEN"
},
body: JSON.stringify({
request: "send_sms",
message: { sender, text },
recipients: [to]
})
});
return res.json();
}
Nos serveurs MCP open source
Choisissez la version adaptée à votre environnement :
Serveur MCP — Hébergé (zéro installation)
Pour tester ou déployer sans rien installer sur votre machine, utilisez simplement l'endpoint hébergé sur nos serveurs. Il suffit d'une URL et d'un token Bearer dans votre client MCP (Claude Desktop via mcp-remote, ChatGPT Team, Cursor, n8n, Make…).
https://www.smsvertpro.com/mcp/
Exemple de configuration Claude Desktop via le proxy mcp-remote :
{
"mcpServers": {
"smsvertpro": {
"command": "npx",
"args": [
"mcp-remote",
"https://www.smsvertpro.com/mcp/",
"--header",
"Authorization: Bearer VOTRE_TOKEN_API"
]
}
}
}
Ce mode est idéal pour les équipes multi-postes et les clients MCP compatibles Streamable HTTP (ChatGPT Team/Enterprise, Cursor, Windsurf, etc.). Le token reste lié à votre compte et transite en HTTPS.
Documentation complète
Serveur MCP — PHP (Claude Desktop, Cursor, Windsurf…)
Si vous utilisez Claude Desktop, Cursor, Windsurf ou tout autre client compatible MCP (Model Context Protocol), vous pouvez connecter l'envoi de SMS en quelques secondes grâce à notre serveur MCP open source écrit en PHP. Aucun code à écrire : l'agent IA dispose directement des outils SMS (envoi, crédits, OTP, accusés de réception…).
Installation :
git clone https://github.com/3-bees-online/mcp-server-smsvertpro-php.git
Puis ajoutez la configuration dans votre client MCP (exemple pour Claude Desktop) :
{
"mcpServers": {
"smsvertpro": {
"command": "php",
"args": ["/chemin/vers/server.php"],
"env": {
"SMSVERTPRO_API_TOKEN": "votre_token_api"
}
}
}
}
Le serveur fonctionne avec PHP 7.4+ et ne nécessite aucune dépendance externe. Une fois configuré, demandez simplement à votre agent : « Envoie un SMS au 33612345678 pour confirmer le rendez-vous de demain » — il s'occupe du reste.
Voir le projet sur GitHub
Documentation complète
Serveur MCP — Python
Vous préférez Python ? Notre serveur MCP Python utilise le SDK officiel MCP d'Anthropic et ajoute une validation renforcée de toutes les entrées (numéros, messages, codes OTP). Installation :
git clone https://github.com/3-bees-online/mcp-server-smsvertpro-python.git cd mcp-server-smsvertpro-python pip install -r requirements.txt
La configuration dans Claude Desktop est identique, en remplaçant php par python et server.php par server.py.
Voir le projet sur GitHub
Documentation complète
Serveur MCP — TypeScript / Node.js
Pour les développeurs JavaScript et TypeScript, notre serveur MCP est disponible en une commande via npm — aucune installation manuelle :
npx @3-bees-online/mcp-server-smsvertpro
Configuration Claude Desktop :
{
"mcpServers": {
"smsvertpro": {
"command": "npx",
"args": ["@3-bees-online/mcp-server-smsvertpro"],
"env": {
"SMSVERTPRO_API_TOKEN": "votre_token_api"
}
}
}
}
Voir le projet sur GitHub Voir sur npm
Les outils SMS disponibles pour votre agent
| Outil (tool) | Description | Cas d'usage IA |
|---|---|---|
send_sms |
Envoyer un SMS | Notification, confirmation, alerte |
generate_otp |
Envoyer un code OTP | Vérification d'identité avant une action sensible |
verify_otp |
Vérifier un code OTP | Valider que l'utilisateur a bien reçu le code |
credits |
Consulter le solde | L'agent vérifie les crédits avant d'envoyer |
reports |
Statut de livraison | L'agent informe le client du statut de son SMS |
cancel |
Annuler un SMS programmé | L'agent annule un envoi différé avant qu'il ne parte |
Avantages pour les développeurs IA
- API JSON simple : un seul endpoint POST, pas de SDK à installer
- Authentification Bearer Token : rapide, sans login/password dans chaque requête
- Direct opérateur : 98% de délivrabilité, SMS livrés en quelques secondes
- OTP intégré : génération et vérification de codes en 2 appels API
- Sans abonnement : payez uniquement les SMS envoyés, à partir de 0,049€/SMS
- Marque blanche : proposez le SMS sous votre propre marque à vos utilisateurs via les sous-comptes
- 10 SMS offerts pour tester l'intégration gratuitement
Un projet d'intégration IA ?
01 60 04 51 65
Questions fréquentes
Oui. L'API est conçue pour être appelée de manière programmatique. Votre agent IA peut envoyer des SMS de manière totalement autonome en appelant l'endpoint send_sms avec le numéro du destinataire et le texte du message. Aucune validation manuelle n'est requise.
Oui. L'API est un simple appel HTTP POST en JSON. Elle est compatible avec tous les frameworks d'agents IA qui supportent les tool calls HTTP : LangChain, CrewAI, AutoGen, Semantic Kernel, Claude MCP, ChatGPT function calling, et tout framework personnalisé.
L'API utilise un Bearer Token dans le header HTTP Authorization. Stockez ce token dans les variables d'environnement de votre application (jamais en dur dans le code). Chaque token est unique et peut être régénéré à tout moment si compromis.
Le tarif est identique à l'envoi classique : à partir de 0,049€ HT par SMS, sans abonnement ni engagement. Vous achetez des crédits à la carte et votre agent les consomme au fil des envois. Les crédits n'ont pas de date d'expiration.
À découvrir également
Pour une documentation technique complète de tous les endpoints, consultez notre page API SMS Vert Pro qui détaille l'ensemble des fonctionnalités disponibles pour l'intégration dans vos applications.
Si vous développez sous WinDev, WebDev ou WinDev Mobile, notre composant WinDev SMS vous permet d'envoyer des SMS directement depuis vos logiciels métier sans écrire de requêtes HTTP.
confiance