Envoyer des SMS
avec n8n
Une URL, votre token API, et vos workflows n8n envoient des SMS, suivent leur remise et vérifient des codes OTP. Sans nœud à installer, sans une ligne de code.
n8n est un outil d'automatisation qui relie vos applications entre elles. Un formulaire rempli, une commande validée ou une ligne ajoutée dans un tableur y déclenchent une suite d'actions. Ajouter l'envoi de SMS à ces enchaînements permet de prévenir un client, un technicien ou vous-même au bon moment, sans intervention humaine.
SMS Vert Pro se branche sur n8n par son serveur MCP hébergé. Le nœud MCP Client, fourni avec n8n, suffit. Il n'y a pas de nœud communautaire à installer, et votre compte, vos crédits et vos rapports restent ceux de votre espace client habituel.
Pourquoi envoyer vos SMS depuis n8n ?
- Sans code, il suffit de glisser un nœud et d'y coller une URL et votre token pour que le SMS parte
- Relié à vos outils, l'envoi part d'un CRM, d'une boutique en ligne, d'un formulaire, d'un agenda ou d'un tableur
- Chaque appel renvoie des données prêtes à l'emploi (identifiant de campagne, solde, statut) pour enchaîner la suite
- La connexion fonctionne avec n8n Cloud comme en auto-hébergé, puisque notre serveur est accessible en HTTPS
- Le même serveur sert aux workflows classiques et aux agents IA
Vous n'avez pas encore choisi votre fournisseur de SMS ? Notre comparatif des fournisseurs d'API SMS vous aide à trancher avant de construire vos workflows.
Deux façons de connecter SMS Vert Pro à n8n
| Usage | Nœud n8n | Quand le choisir |
|---|---|---|
| Workflow classique | MCP Client |
Le SMS part toujours de la même façon quand un événement survient, comme une confirmation de commande, un rappel ou une alerte. |
| Agent IA | AI Agent + MCP Client Tool |
Un modèle d'IA décide lui-même s'il faut écrire un SMS, à qui, et avec quel texte. |
Dans les deux cas, vous aurez besoin d'un compte SMS Vert Pro et de votre token API V2, que vous générez depuis votre espace client. Nos essais ont été menés sur n8n 2.22, et toute version récente qui propose le nœud MCP Client convient.
Envoyer un SMS dans un workflow n8n
Ajoutez le nœud MCP Client
Dans votre workflow, ajoutez un nœud MCP Client à l'endroit où le SMS doit partir.
Collez l'adresse du serveur
Dans MCP Endpoint URL, indiquez https://www.smsvertpro.com/mcp/. Laissez le transport sur HTTP Streamable.
Ajoutez votre token
Dans Authentication, choisissez Bearer Auth, puis créez un identifiant contenant votre token API V2. Vous ne le saisirez qu'une fois, puisque tous vos nœuds SMS le réutilisent.
Choisissez l'outil et le message
Dans Tool, choisissez send_sms. Passez Input Mode sur JSON et indiquez le destinataire, le texte et l'expéditeur.
Exemple de paramètres, avec le numéro repris d'un nœud précédent :
{
"to": ["{{ $json.telephone }}"],
"message": "Bonjour, votre commande est prête. Vous pouvez venir la retirer.",
"sender": "MaSociete"
}
Les numéros s'écrivent au format international, sans le signe plus : 33612345678 pour un mobile français. L'expéditeur compte 11 caractères au maximum, lettres et chiffres.
Le nœud renvoie les données de l'envoi, directement utilisables par les nœuds suivants :
{
"structuredContent": {
"ok": true,
"status": "SEND_OK",
"campaign_id": "camp_1234_1790587594_3908",
"credits": 1278,
"nbsms": 1,
"date": "2026-09-28 11:26:34"
}
}
Suivre la remise du SMS
Ajoutez un nœud Wait de quelques secondes, puis un second nœud MCP Client avec l'outil get_delivery_report. Il reprend l'identifiant de campagne renvoyé par l'envoi :
{{ JSON.stringify({ campaign_id: $('Envoyer le SMS').item.json.structuredContent.campaign_id }) }}
Le rapport indique pour chaque destinataire le statut du SMS (DELIVERED quand il est reçu), l'heure d'envoi et l'heure de remise.
Réagir à un échec
Chaque réponse contient un champ ok. Un nœud IF sur {{ $json.structuredContent.ok }} sépare les envois réussis des échecs (solde insuffisant, numéro invalide, expéditeur refusé). En cas d'échec, status précise la raison, et vous pouvez prévenir votre équipe par email ou dans votre messagerie interne.
Caractères autorisés dans vos SMS
Par défaut, les SMS partent dans l'alphabet standard des téléphones (GSM-7). Les accents courants passent tels quels (é, è, à, ù). Le « ç » minuscule et les accents circonflexes sont remplacés par leur lettre simple (ç devient c, ê devient e), et votre message garde ses 160 caractères par SMS. Seuls les émojis sont refusés.
Avant d'envoyer un texte construit à partir de vos données, l'outil count_sms_parts vérifie qu'il ne contient pas d'émoji et indique le nombre de SMS consommés, sans rien envoyer ni débiter.
Donner le SMS à un agent IA n8n
Le nœud AI Agent de n8n pilote un modèle d'IA qui choisit lui-même ses actions. Pour lui confier l'envoi de SMS, branchez-lui un nœud MCP Client Tool :
Ajoutez un agent IA
Ajoutez un nœud AI Agent et reliez-lui le modèle d'IA de votre choix.
Branchez l'outil SMS
Dans ses outils, ajoutez MCP Client Tool avec l'adresse https://www.smsvertpro.com/mcp/.
Connectez votre compte
Choisissez Bearer Auth avec votre token API V2, ou MCP OAuth2. Avec OAuth2, vous vous connectez à votre compte SMS Vert Pro et vous autorisez l'accès, sans copier de token.
Limitez les outils
Dans Tools to Include, ne gardez que les outils utiles à votre agent, par exemple send_sms, count_sms_parts et check_credits.
L'agent comprend alors des consignes comme « Si le client signale une panne urgente, envoie un SMS au technicien d'astreinte avec l'adresse et le problème ». Il rédige le message, vérifie qu'il tient en un SMS et l'envoie.
Limiter les outils exposés est une bonne pratique, car un agent chargé de prévenir un technicien n'a pas besoin d'annuler des campagnes ni de lire votre liste de désabonnés. Pour aller plus loin sur ce sujet, consultez notre page sur les agents IA qui envoient des SMS.
Les outils SMS disponibles dans n8n
| Outil | Rôle | Données renvoyées |
|---|---|---|
send_sms |
Envoie un SMS immédiat ou programmé à un ou plusieurs numéros | campaign_id, credits, nbsms |
get_delivery_report |
Rapport de remise d'une campagne | statut par destinataire |
check_credits |
Solde de crédits SMS | credits |
count_sms_parts |
Nombre de SMS consommés par un texte, sans rien envoyer | gsm7, parts, credits_per_recipient |
cancel_sms |
Annule un envoi programmé et recrédite le compte | status, credits |
get_responses |
Réponses reçues sur une campagne | liste des réponses |
generate_otp |
Envoie un code à usage unique par SMS | status |
verify_otp |
Vérifie le code saisi par l'utilisateur | valid |
get_blacklist |
Numéros désabonnés (STOP) | liste des numéros |
verify_number |
Contrôle le format des numéros d'une liste de contacts | numéros mal formatés |
Les codes à usage unique permettent par exemple de confirmer un numéro de téléphone à l'inscription, directement depuis un workflow. Le principe est détaillé sur notre page SMS OTP.
Modèles de workflows à importer
Ces trois workflows sont prêts à l'emploi. Téléchargez le fichier, puis dans n8n ouvrez un nouveau workflow et choisissez Import from File. Il reste à sélectionner votre identifiant Bearer Auth dans chaque nœud SMS, et à remplacer le numéro et l'expéditeur d'exemple.
| Workflow | Déroulé | Fichier |
|---|---|---|
| Envoyer un SMS et suivre sa remise | Envoie un SMS, attend 30 secondes, puis récupère le rapport de remise. | Télécharger |
| SMS de confirmation depuis un formulaire | Reçoit les données d'un formulaire web (prénom et téléphone), envoie un SMS de confirmation personnalisé et sépare les réussites des échecs. | Télécharger |
| Alerte de solde bas | Chaque matin à 9 h, consulte votre solde et vous envoie un SMS s'il reste moins de 500 crédits. | Télécharger |
Notre modèle de campagne SMS depuis Google Sheets est aussi publié dans la galerie officielle de n8n. Il lit vos contacts dans une feuille, personnalise chaque message, écarte les numéros désinscrits, envoie la campagne puis note le statut de remise sur chaque ligne.
Le modèle de rappels de rendez-vous depuis Google Agenda y est également publié. Il envoie un SMS de rappel dans les 24 heures qui précèdent chaque rendez-vous de votre agenda, lit la réponse du client et met l'événement en vert s'il confirme, en rouge s'il annule, avec une alerte par SMS pour vous prévenir. Pour recevoir les réponses, l'expéditeur doit rester notre numéro court 36XXX.
Le modèle de vérification d'un numéro par code SMS complète la série. Relié à votre formulaire d'inscription ou de commande, il envoie un code à usage unique au numéro saisi, contrôle le code que tape votre visiteur et note chaque numéro vérifié dans une feuille Google Sheets.
Pour d'autres idées d'enchaînements (rappels de rendez-vous, suivi de livraison, relances), notre guide pour automatiser l'envoi de SMS passe en revue les scénarios les plus courants par secteur.
Questions fréquentes
Non. Les nœuds MCP Client et MCP Client Tool sont fournis avec n8n. Il suffit de leur donner l'adresse de notre serveur et votre token API.
Oui. Notre serveur est accessible sur Internet en HTTPS, et n8n l'appelle de la même façon, qu'il tourne sur n8n Cloud, sur votre serveur ou sur votre poste. Il faut simplement une version récente de n8n, qui propose le nœud MCP Client.
Le même prix qu'un envoi depuis votre espace client. Un SMS consomme vos crédits habituels, sans supplément ni abonnement. Nos prix sont détaillés sur la page tarifs SMS.
Le token API est le plus simple. Vous le copiez une fois depuis votre espace client, et il fonctionne avec les deux nœuds. Si vous le renouvelez, l'ancien cesse aussitôt de fonctionner.
OAuth2 évite de manipuler le token. Vous vous connectez à votre compte SMS Vert Pro et vous autorisez n8n, qui reçoit un accès limité dans le temps et le prolonge seul tant que vous l'utilisez.
Oui, avec les mêmes règles que depuis votre espace client, c'est-à-dire la mention STOP en fin de message pour les SMS commerciaux et le respect des horaires d'envoi. Les numéros désabonnés sont écartés automatiquement, et l'outil get_blacklist permet de les retirer aussi de vos fichiers.
Tout outil capable d'appeler un serveur MCP distant peut utiliser la même adresse. Sinon, notre API SMS REST en JSON s'appelle depuis n'importe quel module de requête HTTP, avec le même token.
À découvrir également
Serveur MCP SMS hébergé
Le fonctionnement du serveur utilisé par n8n, sa sécurité et sa configuration dans Claude, ChatGPT ou Cursor.
Guide d'intégration IA
Une vue d'ensemble des façons de relier l'envoi de SMS à l'intelligence artificielle.
Agent IA et SMS
Les cas d'usage d'un agent qui écrit lui-même aux clients, et les frameworks compatibles.
API SMS
Si vous préférez intégrer l'envoi directement dans votre code, chaque fonction y est détaillée.
Besoin d'aide avec n8n ?
01 60 04 51 65
confiance
s'appuient sur SMS Vert Pro pour leurs rappels, leurs confirmations et leurs campagnes SMS.