Novae SMS — API SMS pour la Côte d’Ivoire

é passe, ç casse

Un seul caractère peut doubler la facture. Vous le saurez avant.

Un SMS tient en 160 caractères — tant que tout reste dans la table GSM-7. Les accents courants y sont : é, è, à, ù passent sans surcoût. Mais le ç minuscule n’y est pas. Ni ê, ni â, ni ô. Un seul de ces caractères bascule tout le message en UCS-2 : 70 caractères par segment au lieu de 160.

« Merci pour ça. » suffit à faire passer un message d’un segment à deux — et la ligne double sur votre facture. La plupart des plateformes vous le facturent sans vous le dire. preview vous le dit avant l’envoi, et nomme le caractère fautif.

POST /v1/messages/preview — n’envoie rien, ne débite rien

"…livrée sous 48h. Merci a tous."
→ encoding "GSM7"  segments 1  prix 15 F

"…livrée sous 48h. Merci pour ça."
→ encoding "UCS2"  segments 2  prix 30 F
  blockingChars ["ç"]  ← le fautif est nommé

Le chemin d’un message

Débité à l’acceptation, remboursé si le réseau n’a rien vu.

Un message rejeté ou en échec interne est recrédité automatiquement. L’écriture apparaît dans votre registre — un accusé rejoué ne rembourse jamais deux fois.

Envoyer un SMS

curl https://api-sms.novae.ci/v1/messages \
  -H "Authorization: Bearer sk_live_…" \
  -H "Idempotency-Key: cmd-48127" \
  -d '{ "to": "07 07 12 34 56", "from": "NOVAE",
       "body": "Votre code est 481203", "category": "otp" }'

← 202 Accepted
{ "id": "8934ab6d…", "status": "queued",
  "segments": 1, "encoding": "GSM7", "priceMilli": 15000 }

L’en-tête Idempotency-Key est obligatoire. Si votre requête part deux fois — timeout, réessai, redémarrage — la seconde renvoie la réponse d’origine sans réenvoyer ni redébiter. Une même clé avec un corps différent est refusée : c’est une erreur d’intégration, pas un doublon.

Le statut se suit sur GET /v1/messages/:id : en file, soumis, délivré, ou remboursé — avec le code d’erreur exact quand il y en a un.

Ce que la plateforme garantit

Des règles simples, tenues par construction.

Un registre, pas un compteur

Chaque mouvement est une écriture immuable portant le solde résultant : rechargement, débit, remboursement, régularisation. Votre solde n’est que la somme de ces lignes. En cas de litige, il y a une trace — pas une estimation.

Les numéros ivoiriens, correctement

07 07 12 34 56, +225…, 00225… : tout est normalisé en E.164, l’opérateur résolu avant l’envoi. Les numéros d’avant la migration 2021 sont refusés plutôt que facturés dans le vide.

Les OTP ne font jamais la queue

Envois marketing et transactionnels sont dépilés séparément. Une campagne de 500 000 messages ne peut pas, par construction, retarder un code de connexion.

Garde-fous contre la fraude

Liste blanche de destinations, plafonds de dépense horaire et journalier, limite d’envois vers un même numéro. Le trafic artificiellement gonflé est le premier poste de perte sur l’OTP : les contrôles s’appliquent avant le débit, pas dans un rapport le lendemain.

Tarifs

Prépayé, au segment,
sans abonnement.

Le segment est l’unité facturée : 160 caractères en GSM-7, 70 en UCS-2. preview donne le compte exact avant l’envoi.

15 F CFA / segment

Réseau Orange Côte d’Ivoire, autres opérateurs en cours
Dégressif au volume, sur devis
Rechargement Mobile Money ou virement
Aucun frais de mise en service, aucun engagement

Accès anticipé

La plateforme ouvre progressivement.

Nous intégrons les premiers clients un par un, le temps de valider les routes opérateur et les expéditeurs déclarés. Décrivez votre usage — volume mensuel estimé, type de messages, délai souhaité — et nous revenons vers vous avec un accès et une grille.

Écrire à l’équipe

Le prix exact,avant l’envoi.