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, une ligne ajoutée dans un tableur 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 : vous glissez un nœud, vous collez une URL et votre token, et le SMS part
- Relié à vos outils : CRM, boutique en ligne, formulaire, agenda ou tableur déclenchent l'envoi
- Réponses exploitables : chaque appel renvoie des données prêtes à l'emploi (identifiant de campagne, solde, statut) pour enchaîner la suite
- n8n Cloud ou auto-hébergé : la connexion fonctionne dans les deux cas, puisque notre serveur est accessible en HTTPS
- Workflows classiques et agents IA : le même serveur sert aux deux usages
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 : confirmation de commande, rappel, 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 : 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 : 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, ce qui permet de 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 (é, è, à, ù), mais pas le « ç » minuscule, les accents circonflexes ni les emojis : un message qui en contient est refusé.
Avant d'envoyer un texte construit à partir de vos données, l'outil count_sms_parts vérifie qu'il passe 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 : vous vous connectez alors à 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 : 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 | Ce qu'il fait | 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 | Ce qu'il fait | 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 |
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 : 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 : 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
Le fonctionnement du serveur utilisé par n8n, sa sécurité et sa configuration dans Claude, ChatGPT ou Cursor sont décrits sur la page du serveur MCP SMS hébergé.
Pour une vue d'ensemble des façons de relier l'envoi de SMS à l'intelligence artificielle, consultez notre guide d'intégration IA. Et si vous préférez intégrer l'envoi directement dans votre code, la documentation de notre API SMS détaille chaque fonction.
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.