API SMS HTTP / HTTPS · Pour développeurs

L’API SMS qui connecte vos applications à vos clients.

Q: Peut-on personnaliser l’expéditeur des SMS ?

Oui. Le paramètre from affiche le nom de votre entreprise, jusqu’à 11 caractères non accentués, parmi les noms autorisés pour votre compte. Certains pays ou opérateurs n’acceptent pas d’expéditeur personnalisé : il est alors remplacé au moment de l’envoi.

Q: Comment envoyer des SMS marketing et transactionnels avec l’API ?

Le paramètre obligatoire iscom indique la nature du message. Un SMS transactionnel (iscom=N : confirmation, rappel, alerte, code) part à toute heure. Un SMS commercial (iscom=Y) est envoyé du lundi au vendredi de 8 h à 20 h et le samedi de 10 h à 15 h, à l’heure locale du destinataire, et doit se terminer par la mention STOP sms-s.top qui gère automatiquement les désinscriptions. Comprendre le STOP SMS.

Q: Que se passe-t-il si l’API ne répond pas ?

Prévoyez une bascule automatique : si une requête vers api.textinghouse.com reste sans réponse, renvoyez-la immédiatement vers le serveur de secours api2.textinghouse.com. Cette redondance assure la continuité de vos envois.

Intégrez l’envoi de SMS professionnels à votre site web, CRM, ERP ou logiciel métier. Une API SMS HTTP simple, des notifications automatisées et un suivi précis de chaque message.

Tester l’API gratuitement Voir la documentation

Sans abonnement Sans engagement Paiement à l’usage

envoi-sms.example● HTTPS sécurisé

<?php// Test gratuit : destinataire 999 (aucun SMS réel envoyé)$data = [  'user'  => getenv('TH_USER'),  'pass'  => getenv('TH_PASS'),  'cmd'   => 'sendsms',  'to'    => '999',  'txt'   => 'Test API SMS TextingHouse',  'iscom' => 'N'];$ch = curl_init('https://api.textinghouse.com/http/v1/do');curl_setopt_array($ch, [  CURLOPT_POST => true,  CURLOPT_POSTFIELDS => http_build_query($data),  CURLOPT_RETURNTRANSFER => true]);echo curl_exec($ch); // ID:... ou ERR:...curl_close($ch);

// Node.js 18+ (module ES) · test gratuit au 999const params = new URLSearchParams({  user: process.env.TH_USER,  pass: process.env.TH_PASS,  cmd: 'sendsms',  to: '999',  txt: 'Test API SMS TextingHouse',  iscom: 'N'});const res = await fetch('https://api.textinghouse.com/http/v1/do', {  method: 'POST',  body: params});console.log(await res.text()); // ID:... ou ERR:...

# Test gratuit : destinataire 999curl -X POST 'https://api.textinghouse.com/http/v1/do' \  --data-urlencode 'user=VOTRE_IDENTIFIANT' \  --data-urlencode 'pass=VOTRE_MOT_DE_PASSE' \  --data-urlencode 'cmd=sendsms' \  --data-urlencode 'to=999' \  --data-urlencode 'txt=Test API SMS TextingHouse' \  --data-urlencode 'iscom=N'# Réponse : ID:... ou ERR:...

RÉPONSE DE L’APIID:5d726149a129c829e8c23f7b✓ Accepté

SMS pris en chargeIdentifiant renvoyé par l’API

0 €d’abonnement

API HTTPSen POST ou en GET

Test au 999gratuit, sans SMS réel

Callbacks JSONstatuts et réponses SMS

Une API, de multiples possibilités

Toutes les fonctionnalités de l’API SMS pour votre logiciel.

Du SMS transactionnel à la communication client, l’API SMS TextingHouse vous donne les fonctions utiles pour automatiser vos échanges, sans complexifier votre développement. Toutes les fonctionnalités de la plateforme sont disponibles par l’API.

Envoi automatique de SMS

Déclenchez confirmations, rappels, alertes ou codes de vérification depuis votre site web, votre application ou votre outil de gestion.

Accusés de réception

Recevez les statuts définitifs de vos SMS par callback JSON (webhook) ou interrogez l’API avec getstatus.

Réponses SMS remontées

Recevez les réponses de vos destinataires sur une URL dédiée, lorsque la destination et le type d’expéditeur le permettent.

Expéditeur personnalisé

Affichez le nom de votre entreprise (11 caractères) à la place d’un numéro, selon les règles du pays de destination.

Gestion des STOP SMS

Les désinscriptions aux SMS commerciaux sont collectées automatiquement grâce à la mention STOP sms-s.top.

Consultation du crédit

Interrogez votre solde depuis votre application avec la commande getcredit et gardez le contrôle des consommations.

Votre propre identifiant

Associez votre référence interne à chaque SMS avec climsgid pour rapprocher envois, statuts et réponses.

Sécurité des accès

Connexion HTTPS sur le port 443, identifiants dédiés à l’API et verrouillage des envois sur l’adresse IP de votre serveur.

Continuité de service

Un serveur de secours, api2.textinghouse.com, prend le relais si le point d’accès principal ne répond pas.

À savoir : les réponses SMS (MO) sont disponibles selon le pays et l’opérateur. Un nom d’expéditeur personnalisé empêche la réponse directe du destinataire. Les conditions techniques précises figurent dans la documentation de l’API SMS.

Démarrer est simple

De votre inscription à votre premier SMS envoyé par API.

Une intégration légère dans votre environnement et une documentation qui détaille chaque paramètre de l’API SMS.

Créez votre compte

Inscrivez-vous gratuitement et récupérez vos identifiants API sur la page « Paramètres » de votre interface TextingHouse.

Connectez votre application

Appelez le point d’accès HTTPS avec vos paramètres encodés, en POST ou en GET, depuis le langage de votre choix.

Testez, puis envoyez

Utilisez le destinataire 999 pour tester gratuitement toute la chaîne d’envoi, puis passez en production.

Pour les développeurs

Une API SMS HTTP. Du code clair. Des SMS intégrés à vos outils.

Pas de SDK propriétaire à installer : envoyez une requête HTTPS avec les champs attendus et récupérez l’identifiant du message. Exemples d’API SMS en PHP, Node.js, Python ou cURL, prêts à adapter.

Point d’accès : https://api.textinghouse.com/http/v1/do
POST ou GET, paramètres encodés (URL-encoded), connexion HTTPS
Commandes sendsms, getstatus et getcredit
Réponses en texte simple : ID:… ou ERR: code | description
Callbacks JSON pour les statuts définitifs (DLR) et les réponses SMS (MO)

Lire la documentation Spécification OpenAPI

integration-api-sms

# Python 3 · bibliothèque requestsimport osimport requestsr = requests.post(    "https://api.textinghouse.com/http/v1/do",    data={        "user": os.environ["TH_USER"],        "pass": os.environ["TH_PASS"],        "cmd": "sendsms",        "to": "999",  # test gratuit        "txt": "Test API SMS TextingHouse",        "iscom": "N",        "climsgid": "CMD-2026-0412",  # votre identifiant    },    timeout=10,)print(r.text)  # ID:... ou ERR:...

# Statut d'un SMS à partir de son identifiantcurl 'https://api.textinghouse.com/http/v1/do' \  --get \  --data-urlencode 'user=VOTRE_IDENTIFIANT' \  --data-urlencode 'pass=VOTRE_MOT_DE_PASSE' \  --data-urlencode 'cmd=getstatus' \  --data-urlencode 'api_id=5d726149a129c829e8c23f7b'# Réponse : 3  (3 = délivré)

# Callback DLR : TextingHouse appelle votre URLPOST https://www.votre-domaine.fr/sms/dlrContent-Type: application/json{  "apimsgid": "5d726149a129c829e8c23f7b",  "climsgid": "CMD-2026-0412",  "status": "3"}# Votre script répond simplement par un code HTTP 2XX

# Callback MO : réponse d'un destinatairePOST https://www.votre-domaine.fr/sms/reponsesContent-Type: application/json{  "apimsgid": "5d726149a129c829e8c23f7b",  "climsgid": "CMD-2026-0412",  "from": "33600000000",  "txt": "Oui, je confirme",  "date": "2026-10-29T13:09:16Z"}

Les paramètres essentiels de l’API SMS

Commande sendsms. Les paramètres sont sensibles à la casse ; l’authentification se fait avec user et pass.

Paramètre	Statut	Rôle
`cmd`	Obligatoire	Commande : `sendsms` (envoi), `getstatus` (statut) ou `getcredit` (crédit).
`to`	Obligatoire	Numéro du destinataire au format international, sans « + » (ex. 33612345678). `999` pour un test gratuit.
`txt`	Obligatoire	Texte du SMS, encodé. Jusqu’à 160 caractères GSM 03.38 par SMS.
`iscom`	Obligatoire	`N` : SMS transactionnel, envoyé à toute heure. `Y` : SMS commercial, avec horaires encadrés et mention `STOP sms-s.top`.
`from`	Facultatif	Nom d’expéditeur personnalisé (11 caractères a-z, A-Z, 0-9), parmi les noms autorisés pour votre compte.
`climsgid`	Facultatif	Votre identifiant interne (32 caractères maximum), repris dans les statuts et les réponses.

API SMS professionnelle

Le bon SMS, au bon moment, depuis vos applications.

Intégrez l’envoi de SMS automatiques dans vos processus pour informer vos clients, vos utilisateurs ou vos équipes au moment où cela compte.

E-commerce

Confirmation de commande, avis d’expédition, colis prêt à retirer ou produit de nouveau disponible.

SMS pour les commerces

Prise de rendez-vous

Confirmations, rappels la veille et changements d’horaire envoyés automatiquement depuis votre agenda.

SMS pour la santé

CRM et ERP

Relances, notifications métier et messages déclenchés par les workflows de vos logiciels.

SMS dans HubSpot

Alertes et codes

Alertes de service, codes de vérification et informations urgentes envoyés à toute heure.

SMS logistique et transport

Pas de développeur sous la main ? Envoyez vos SMS depuis HubSpot, connectez vos outils avec Zapier ou utilisez l’extension SMS pour vos envois manuels.

Tarification claire

Une API SMS gratuite.
Vous ne payez que vos SMS.

Aucun coût d’accès à l’API, aucun abonnement, aucun engagement. Vous achetez des crédits selon vos besoins : le prix d’un SMS dépend de sa destination, parmi plus de 150 pays, et du volume acheté. Les tests au 999 sont gratuits.

Envoi de SMS vers la France

dès 0,050 € HT

Consulter les tarifs SMS Prix par SMS selon destination et volume.

Questions fréquentes

Tout savoir sur notre API SMS.

Les réponses essentielles avant d’intégrer une passerelle SMS HTTP à votre application.

Qu’est-ce qu’une API SMS et à quoi sert-elle ?

Une API SMS est une interface qui permet à un site web, un logiciel métier, un CRM ou un ERP de déclencher l’envoi de SMS par programmation. Avec l’API SMS HTTP de TextingHouse, vos applications envoient automatiquement des confirmations, rappels, alertes ou codes, et récupèrent le statut de chaque message.

L’API SMS TextingHouse est-elle gratuite ?

L’accès à l’API est gratuit, sans abonnement ni engagement. Seuls les SMS réellement envoyés sont facturés, au tarif de leur destination et selon le volume de crédits acheté. Les envois de test au numéro 999 ne sont pas facturés. Voir les tarifs SMS.

Comment tester gratuitement l’envoi de SMS par API ?

Créez votre compte, puis envoyez un message au destinataire spécial 999. L’API le traite comme un vrai SMS : elle renvoie un identifiant, accepte votre identifiant interne, répond aux demandes de statut et remonte un accusé de réception « délivré », sans qu’aucun SMS ne soit remis à un opérateur. Vous pouvez aussi débloquer 10 SMS réels pour valider votre intégration.

Quels langages de programmation peut-on utiliser ?

Tous ceux qui savent envoyer une requête HTTP : PHP, JavaScript et Node.js, Python, Java, C#, Go, Ruby, mais aussi des outils no-code ou un simple cURL. Aucun SDK n’est nécessaire : l’API reçoit des paramètres encodés en POST ou en GET via HTTPS et répond en texte simple.

Comment recevoir les accusés de réception (DLR) des SMS ?

Indiquez une URL de callback dans les paramètres de votre compte API. TextingHouse y envoie une requête HTTP POST au format JSON dès qu’un SMS atteint un statut définitif (délivré, expiré, non délivrable…). Vous pouvez aussi interroger l’API avec la commande getstatus à partir de l’identifiant du message ou de votre propre identifiant climsgid.

Les destinataires peuvent-ils répondre aux SMS envoyés par l’API ?

Oui, selon le pays et l’opérateur. Les réponses (SMS MO) sont transmises en JSON sur l’URL de votre choix. Attention : lorsqu’un nom d’expéditeur personnalisé est utilisé, les destinataires ne peuvent pas répondre.

Peut-on personnaliser l’expéditeur des SMS ?

Oui. Le paramètre from affiche le nom de votre entreprise, jusqu’à 11 caractères non accentués, parmi les noms autorisés pour votre compte. Certains pays ou opérateurs n’acceptent pas d’expéditeur personnalisé : il est alors remplacé au moment de l’envoi.

Comment envoyer des SMS marketing et transactionnels avec l’API ?

Le paramètre obligatoire iscom indique la nature du message. Un SMS transactionnel (iscom=N : confirmation, rappel, alerte, code) part à toute heure. Un SMS commercial (iscom=Y) est envoyé du lundi au vendredi de 8 h à 20 h et le samedi de 10 h à 15 h, à l’heure locale du destinataire, et doit se terminer par la mention STOP sms-s.top qui gère automatiquement les désinscriptions. Comprendre le STOP SMS.

Combien de caractères peut contenir un SMS envoyé par API ?

Un SMS contient jusqu’à 160 caractères de l’alphabet GSM 03.38. Au-delà, le message est découpé en plusieurs SMS et chaque partie est décomptée. Tout savoir sur le SMS long.

Que se passe-t-il si l’API ne répond pas ?

Prévoyez une bascule automatique : si une requête vers api.textinghouse.com reste sans réponse, renvoyez-la immédiatement vers le serveur de secours api2.textinghouse.com. Cette redondance assure la continuité de vos envois.

Quelle différence entre une API SMS HTTP et une connexion SMPP ?

L’API HTTP convient à la grande majorité des intégrations : sites web, applications et logiciels métier. Pour les agrégateurs et éditeurs à fort trafic, TextingHouse met aussi à disposition des connexions dédiées (SMPP, XML, FTP) ou une connexion sur mesure. Contactez-nous pour en discuter.

Pour aller plus loin

Guides pour réussir votre intégration SMS.

GuideAPI SMS : quels critères prendre en compte ?Lire l’article →AvantagesAPI SMS : quels avantages pour votre entreprise ?Lire l’article →Automatisation6 scénarios de SMS automatisés pour fidéliser vos clientsLire l’article →

Votre projet commence ici

Prêt à intégrer le SMS à vos applications ?

Créez gratuitement votre compte et réalisez votre premier test d’API SMS au 999, sans engagement.

Créer mon compte API Parler à notre équipe