API SMS : intégrez l’envoi de SMS à vos applications
Notifications, alertes, codes de vérification, campagnes et conversations : pilotez tous vos SMS depuis votre site, votre application ou votre logiciel métier, avec une API REST documentée.
- API REST, spécification OpenAPI 3.0
- Requêtes signées HMAC-SHA256
- Accusés de réception par webhook
# CK = Client Key, AK = Auth Key
TS=$(date +%s000)
SIG=$(printf '%s' "$CK$TS" \
| openssl dgst -sha256 -hmac "$AK" \
| cut -d' ' -f2)
curl https://api.smsreflex.com/api/messages \
-H "X-Auth-Ck: $CK" \
-H "X-Auth-Ak: $AK" \
-H "X-Auth-Ts: $TS" \
-H "X-Auth-Signature: $SIG" \
--data-urlencode "To=33612345678" \
--data-urlencode "From=MABOUTIQUE" \
--data-urlencode "MessageText=Commande prête !"
Ce que vous pouvez faire avec l’API
Les mêmes fonctionnalités que la plateforme en ligne, accessibles depuis votre code.
-
Envoi de SMS et statut
Envoyez un SMS en une requête, avec l’expéditeur de votre choix (11 caractères), puis suivez son statut de livraison.
POST /api/messages -
Codes de vérification (OTP)
Générez et envoyez un code de 4 à 8 chiffres, valable de 2 à 60 minutes, puis vérifiez celui saisi par l’utilisateur.
POST /api/verification/send -
Webhooks
Recevez les accusés de réception et les événements de votre compte directement sur votre serveur.
POST /api/store-webhook -
Campagnes
Créez vos campagnes, importez vos listes de contacts en CSV et suivez leurs statistiques d’envoi.
POST /api/new-campaigns -
Conversations (Time2chat)
Consultez les conversations bidirectionnelles de votre compte et répondez à vos contacts par API.
POST /api/chat/reply -
URL courtes et suivi des clics
Générez des liens courts pour vos SMS et mesurez les clics, jour par jour ou clic par clic.
POST /api/shorturls -
Contacts et désinscriptions
Listez vos contacts par statut et mettez à jour leur statut, notamment les désinscriptions (STOP).
GET /api/contacts/list -
Statistiques et crédits
Obtenez vos volumes par statut, comptez les segments d’un message avant envoi et consultez votre solde de crédits.
GET /api/stats
Des SMS déclenchés par vos applications
Notifications transactionnelles
Confirmation de commande, expédition, rappel de rendez-vous : déclenchées par votre logiciel, au bon moment.
Alertes
Incident, seuil dépassé, changement de statut : un SMS part dès que votre système détecte l’événement.
Authentification à deux facteurs
Codes OTP pour l’inscription, la connexion ou la validation d’une opération sensible.
Marketing automatisé
Campagnes et relances pilotées depuis votre CRM ou votre boutique en ligne, avec suivi des clics.
Démarrer en trois étapes
-
Créez votre compte
Ouvrez votre compte SMS Reflex et choisissez un forfait incluant l’accès API.
-
Récupérez vos clés
Votre Client Key et votre Auth Key servent à signer chaque requête.
-
Envoyez votre premier SMS
Suivez la documentation : chaque route est décrite avec ses paramètres et des exemples de réponses.
Questions fréquentes sur l’API SMS
Comment s’authentifier auprès de l’API SMS Reflex ?
Chaque requête est signée avec 4 en-têtes HTTP : votre Client Key (X-Auth-Ck), votre Auth Key (X-Auth-Ak), un horodatage en millisecondes (X-Auth-Ts) et une signature HMAC-SHA256 calculée avec votre Auth Key (X-Auth-Signature).
Quel forfait donne accès à l’API ?
L’accès API est inclus dans le forfait 2200 Plan France. Pour des volumes plus importants, contactez-nous pour une offre sur mesure.
Peut-on envoyer des codes de vérification (OTP) ?
Oui. L’API génère un code de 4 à 8 chiffres, l’envoie par SMS en français, anglais, espagnol ou italien, le conserve de 2 à 60 minutes, puis vérifie le code saisi par l’utilisateur.
Comment connaître le statut de livraison d’un SMS ?
Interrogez l’état d’un message avec son identifiant, ou configurez un webhook pour recevoir les accusés de réception automatiquement sur votre serveur.
Peut-on personnaliser l’expéditeur des SMS ?
Oui, avec un nom d’expéditeur alphanumérique de 11 caractères maximum (par exemple le nom de votre marque).
Où trouver la documentation complète ?
La documentation de référence (OpenAPI 3.0) est publique sur api.smsreflex.com : chaque route y est décrite avec ses paramètres, ses réponses et des exemples.
Un projet d’intégration SMS ?
Décrivez-nous votre besoin : volumes, usages, contraintes techniques. Nous revenons vers vous avec une proposition adaptée.