SMS Gateway

Démarrage rapide SMS

Envoyez des codes OTP, des alertes et des SMS transactionnels dans plus de 190 pays. Chaque message retourne un accusé de réception afin que vous sachiez qu'il est arrivé.

Tester sans vrais SMS ? Utilisez le Mode bac à sable — aucun vrai message envoyé, codes OTP prévisibles et aucune facturation.

1Envoyer un SMS

Envoyez en POST le numéro du destinataire et le texte du message. Le champ from définit l'ID expéditeur visible par l'utilisateur (la prise en charge par l'opérateur varie selon le pays).

POST/api/v1/connect-hub/sms

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/sms \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "Your verification code is 482951. Valid for 10 minutes.",
    "from": "Novauth"
  }'

200 OK — Réponse

json

{
  "messageId": "a3f2c1d0-4e5b-6c7d-8e9f-0a1b2c3d4e5f",  // save for delivery check
  "from":      "Novauth",
  "to":        "+14155552671"
}

Longueur du texte : Les SMS sont limités à 160 caractères par segment. Les messages jusqu'à 4 096 caractères sont acceptés — ils sont automatiquement divisés en segments concaténés et réassemblés sur le terminal.

2Vérifier le statut de livraison

Interrogez l'endpoint SDR (SMS Delivery Report) pour vérifier que le message a atteint le terminal. Vérifiez peu après l'envoi — la livraison typique est inférieure à 5 secondes.

GET/api/v1/connect-hub/sms/{messageId}/sdr

bash

curl https://api.novauth.com/api/v1/connect-hub/sms/a3f2c1d0-.../sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Signaler le résultat de vérification

Une fois que votre utilisateur a soumis le code reçu, envoyez le résultat en POST à l'endpoint webhook pour clore l'enregistrement SMS et consigner le résultat.

POST/api/v1/connect-hub/sms/webhook

bash

# Report the verification outcome from your backend
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id":     "a3f2c1d0-...",
    "status": "Success"
  }'

Référence API

POST/smsEnvoyer un message SMS

GET/sms/{messageId}/sdrObtenir le rapport de livraison SMS

POST/sms/webhookSignaler le résultat de vérification

POST/sms/sdrLister tous les enregistrements SMS (paginé)

Corps de la requête — POST /sms

tostringrequiredTéléphone du destinataire au format E.164

textstringrequiredContenu du message (1–4 096 caractères)

fromstringoptionalID expéditeur ou numéro (dépend de l'opérateur)

Lister tous les enregistrements SMS

bash

# Paginated list of all SMS records
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "rows_per_page": 20,
    "sort_by": "created_at",
    "sort_direction": "DESC"
  }'