:format(webp))
SMS API: How to Integrate SMS Sending into Your Application
Tant que vous envoyez quelques dizaines de messages par mois depuis une interface web, tout va bien. Mais dès que le SMS devient un rouage de votre produit, un code de connexion à envoyer en une seconde, une confirmation de commande déclenchée par un paiement, une alerte remontée par un capteur, l’envoi manuel n’est plus tenable.
C’est là qu’intervient l’API SMS. Elle permet à votre application de parler directement à la passerelle d’envoi : votre code déclenche, le message part, le statut revient. Sans intervention humaine, à n’importe quelle heure, à n’importe quel volume.
On vous explique tout : ce qu’est une API SMS, ce qu’il faut préparer avant de commencer, et comment intégrer l’envoi dans votre application, étape par étape, avec des exemples concrets.
Qu’est-ce qu’une API SMS ?
Une API SMS, aussi appelée passerelle SMS, est l’interface qui relie votre système au réseau des opérateurs. Votre application envoie une requête contenant un numéro, un texte et un expéditeur ; la passerelle se charge de l’acheminement, puis renvoie un statut de livraison.
On parle de messagerie application-to-person, par opposition aux messages échangés entre deux personnes : ici, l’émetteur est un système, pas un pouce sur un clavier.
Concrètement, une API SMS couvre trois fonctions :
L’envoi : votre application transmet le message, la passerelle l’achemine vers l’opérateur du destinataire.
La réception : les réponses de vos clients remontent vers votre application via des webhooks.
Le suivi : chaque message renvoie un statut (livré, en attente, échec) que vous pouvez exploiter dans vos logs et vos tableaux de bord.
Pour découvrir la documentation, les bibliothèques disponibles et l’environnement de test, rendez-vous sur notre page dédiée à l’API SMS et à la passerelle SMS.
Prérequis avant d’intégrer une passerelle SMS
Quelques éléments à réunir avant d’écrire la première ligne :
Un compte sur une plateforme d’envoi. Vérifiez qu’elle expose une API envoi SMS documentée en REST et qu’elle propose des routes directes opérateurs, gage de délivrabilité. Notre plateforme de SMS professionnel couvre les deux.
Vos identifiants d’API. Un nom d’utilisateur et une clé, à conserver côté serveur uniquement.
Un expéditeur (Sender ID). Un nom alphanumérique pour la notoriété de marque, ou un numéro dédié si vous voulez recevoir des réponses.
Un endpoint HTTPS. Nécessaire seulement si vous souhaitez recevoir les webhooks de statut et les messages entrants.
Comment intégrer l’API SMS étape par étape
Étape 1 : récupérer vos identifiants d’API SMS
Depuis votre tableau de bord, générez votre clé d’API. C’est elle qui authentifie chaque requête. Ne l’exposez jamais côté client, ni dans un navigateur, ni dans une application mobile : vos appels doivent toujours partir de votre serveur.
Étape 2 : appeler l’endpoint d’envoi SMS en cURL, Python ou PHP
L’envoi se fait par une requête HTTP POST, avec un corps au format JSON. Voici l’exemple le plus simple, en cURL :
curl -X POST "https://rest.clicksend.com/v3/sms/send" \
-u "YOUR_USERNAME:YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"messages": [
{
"from": "MyBrand",
"to": "+447700900123",
"body": "Your login code is 4821."
}
]
}'Le même appel se transpose sans difficulté dans votre langage. En API SMS Python, la bibliothèque requests suffit :
import requests
payload = {"messages": [{
"from": "MyBrand",
"to": "+447700900123",
"body": "Good news: your order is on its way."
}]}
response = requests.post(
"https://rest.clicksend.com/v3/sms/send",
auth=("YOUR_USERNAME", "YOUR_API_KEY"),
json=payload,
)
print(response.status_code, response.json())Et pour un envoi de SMS PHP, avec cURL :
$payload = json_encode(["messages" => [[
"from" => "MyBrand",
"to" => "+447700900123",
"body" => "Your appointment is confirmed for tomorrow at 2pm.",
]]]);
$ch = curl_init("https://rest.clicksend.com/v3/sms/send");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_USERPWD => "YOUR_USERNAME:YOUR_API_KEY",
CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
CURLOPT_POSTFIELDS => $payload,
CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch);Ces exemples sont donnés à titre illustratif. Reportez-vous toujours à la documentation officielle pour les noms de champs, les formats et les codes retour exacts.
Étape 3 : traiter la réponse de l’API
L’API renvoie un statut par message. Vérifiez systématiquement le code retour et enregistrez l’identifiant de message : il vous servira à rapprocher chaque envoi du statut de livraison qui remontera ensuite.
Étape 4 : configurer les webhooks de statut et de réception
Pour une intégration complète, configurez deux webhooks côté plateforme. Le premier reçoit les statuts de livraison : le message est-il bien arrivé ? Le second reçoit les messages entrants, si vous activez le SMS bidirectionnel pour permettre à vos clients de répondre.
Votre endpoint reçoit alors les événements en temps réel, et votre application se met à jour toute seule.
⚠ Attention toutefois : une API SMS sert avant tout aux messages transactionnels, attendus par le destinataire. Dès que vous l’utilisez pour envoyer des messages promotionnels, l’opt-in préalable de chaque destinataire devient obligatoire en France, au même titre que pour n’importe quelle campagne marketing. |
Les cas d’usage les plus fréquents d’une API d’envoi de SMS
Usage | Type de message | Ce que l’API apporte |
|---|---|---|
SMS OTP et 2FA | Transactionnel | Sécuriser les connexions en temps réel |
Confirmations et suivis | Transactionnel | Rassurer le client, désengorger le support |
Alertes système | Notification | Prévenir instantanément en cas d’incident |
Rappels de rendez-vous | Transactionnel | Réduire nettement les absences |
Campagnes programmées | Marketing | Déclencher des envois depuis votre CRM |
Pour sécuriser les connexions de vos utilisateurs, notre solution d’authentification à deux facteurs et de codes OTP par SMS s’intègre en quelques minutes via cette même API. Et pour les notifications de service ou les alertes envoyées à une liste entière, la diffusion de SMS prend le relais.
Bonnes pratiques d’intégration d’une API SMS
Une intégration qui fonctionne en développement ne tient pas toujours en production. Quelques réflexes à adopter dès le départ :
Sécurisez vos identifiants. Stockez la clé d’API dans un coffre de secrets ou une variable d’environnement, jamais dans le code versionné.
Gérez les erreurs et les reprises. Prévoyez une logique de retry avec temporisation en cas d’échec réseau, en veillant à ne pas dupliquer les envois.
Normalisez les numéros. Le format international E.164 (+33…) évite une grande partie des échecs de livraison.
Choisissez le bon expéditeur. Nom alphanumérique pour un envoi sans réponse attendue, numéro dédié pour une conversation.
Surveillez la délivrabilité. Exploitez les statuts de livraison pour détecter les numéros invalides et les échecs récurrents.
Restez sur un segment. 160 caractères en GSM, 70 en Unicode. Au-delà, le message est scindé et chaque partie facturée.
De l’envoi unitaire à l’envoi de SMS en masse par API
Le même endpoint accepte un tableau de messages, ce qui permet de passer d’un envoi unitaire à l’envoi de SMS en masse sans changer d’architecture. Vos confirmations quotidiennes et vos campagnes de plusieurs milliers de destinataires empruntent le même chemin.
Si vos équipes non techniques ont aussi besoin d’envoyer, sachez que l’API cohabite avec l’envoi de SMS en ligne depuis le navigateur, et même avec l’envoi de SMS depuis une boîte mail. Un seul compte, plusieurs portes d’entrée.
Intégrez votre API SMS et tous vos envois au même endroit
ClickSend est une plateforme de messagerie mondiale à laquelle font confiance des développeurs et des entreprises de tous les secteurs. Que vous envoyiez des codes de vérification, des notifications applicatives ou des campagnes complètes, tout se pilote depuis un seul endroit :
Une API REST documentée, avec bibliothèques et environnement de test
Des webhooks pour les statuts de livraison et les messages entrants
Le reporting de livraison en temps réel
Des pratiques d’envoi conformes intégrées d’origine
Un envoi mondial avec des options d’expéditeur local
Intégrer l’envoi de SMS dans votre application prend rarement plus d’une après-midi : un appel POST pour envoyer, deux webhooks pour recevoir. Le reste, c’est de la finition, et c’est ce qui fait la différence entre une intégration qui marche et une intégration qui tient.
👉 Créer mon compte gratuit et accéder à mon API SMS dès aujourd’hui.
FAQ : intégration de l’API SMS
Quel langage utiliser pour intégrer une API SMS ?
N’importe lequel capable d’émettre une requête HTTP. Les intégrations les plus courantes sont l’API SMS Python et l’envoi de SMS PHP, mais JavaScript, Java, C# et Ruby fonctionnent tout aussi bien. L’API étant REST, l’intégration se résume à un appel POST authentifié, quel que soit votre environnement technique.
Comment recevoir les réponses à mes SMS via l’API ?
Via un webhook de réception. Vous fournissez à la plateforme une URL HTTPS sur votre serveur, qui reçoit chaque message entrant en temps réel. Il faut pour cela activer le SMS bidirectionnel et disposer d’un numéro apte à recevoir des réponses.
Comment savoir si un SMS envoyé par API a bien été livré ?
L’API renvoie un premier statut à l’envoi, puis un webhook de statut confirme la remise effective. En enregistrant l’identifiant de message, vous rapprochez chaque envoi de son statut final dans vos propres logs.
Qu’est-ce que la messagerie SMS application-to-person ?
C’est l’envoi de SMS déclenché par un système (application, serveur, back-office) plutôt que saisi manuellement. Codes OTP, alertes et confirmations en sont les usages typiques, précisément ceux que couvre une API SMS.
Une API SMS permet-elle aussi d’envoyer du RCS ?
Oui sur les plateformes qui gèrent les deux canaux. Vous pouvez alors envoyer un message enrichi via la messagerie RCS avec repli automatique en SMS sur les appareils non compatibles, sans multiplier les intégrations.