Développeurs :
envoyer SMS via API (HTTPS, JSON, Bearer).

Du premier POST à la réception des webhooks : prérequis, étapes, extrait de code et pièges à éviter.

Documentation API Tester l’API gratuitement →
send-sms-api.sh
// openapi — aperçu   "paths": {   "/v1/messages": { "post": {} },   "/v1/messages/{id}": { "get": {} } }
✓ POST /v1/messages
1. Intro (problème)

Envoyer SMS via API : le problème à résoudre

Vous devez déclencher un SMS depuis un backend sans interface manuelle, en gardant traçabilité, idempotence et gestion d’erreurs claire. Ce guide fixe le socle commun à tout message transactionnel.

Lecture liée : OTP API SMS · cas notifications livraison SMS.

2. Prérequis

Prérequis pour envoyer SMS via API

  • Compte Novixo et clé API (sandbox ou prod)
  • Numéro destinataire au format E.164
  • Endpoint HTTPS exposé pour les webhooks (recommandé)
  • Secrets stockés côté serveur — jamais dans le navigateur

Solutions · Intégrations.

3. Étapes

Étapes : envoyer SMS via API Novixo

  1. Créer ou révoquer les clés depuis la console.
  2. Construire le JSON channel, to, body (ou template validé).
  3. POST avec Authorization: Bearer … et éventuellement Idempotency-Key.
  4. Traiter la réponse 2xx et persister l’identifiant message.
  5. Valider les webhooks de statut (signature, idempotence).
4. Code

Code : exemple envoyer SMS via API (cURL)

Remplacez la clé et le numéro de test sandbox.

cURL
curl -sS -X POST "https://api.novixo.fr/v1/messages" \
  -H "Authorization: Bearer $NOVIXO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: livraison-ABC123" \
  -d '{
    "channel": "sms",
    "to": "+33601020304",
    "body": "Votre colis est en route. Suivi: https://exemple.fr/suivi/ABC"
  }'
5. Bonnes pratiques

Bonnes pratiques — envoyer SMS via API

  • Journaliser corrélation user_id / commande_id sans données sensibles dans le corps.
  • Respecter le consentement et le STOP pour les contenus promotionnels (ici : transactionnel).
  • Limiter la longueur et prévoir la concaténation GSM-7 / UCS-2.
6. Erreurs à éviter

Erreurs à éviter quand on envoie un SMS via API

  • Exposer la clé dans une app mobile ou un repo public
  • Ignorer les codes 429 sans backoff exponentiel
  • Dupliquer les envois sans clé d’idempotence sur les retries

Détails des codes : documentation API.

7. CTA tester API

Tester l’API : envoyer SMS via API en sandbox

Tester l’API gratuitement → Documentation
FAQ

FAQ — envoyer SMS via API

Comment envoyer un SMS via API en HTTPS ?

Créez une clé API côté console, appelez l’endpoint messages en POST avec Content-Type application/json, Authorization Bearer et un corps contenant le canal sms, le destinataire E.164 et le texte. Récupérez l’identifiant message pour corréler les webhooks.

Quelle différence entre sandbox et production pour envoyer SMS via API ?

La sandbox limite les numéros et les volumes pour vos tests ; les en-têtes et le schéma JSON restent alignés sur la production afin de limiter les écarts de code.

Où trouver les exemples officiels pour envoyer SMS via API ?

La documentation centralise les exemples Node, Python, PHP et cURL ; cette page résume le flux minimal. Pour l’OTP, enchaînez vers le guide OTP API SMS.

Parcours Novixo

Solutions, intégrations, contact et sandbox

Solutions Intégrations Contact Tester l’API

Retour hub guides techniques

← Guides techniques

Contact