SMS : vue d’ensemble

Intégrer SMS à votre application

SMS v2 permet d’envoyer un message à un mobile malgache, de programmer un envoi ou un lot, puis d’en consulter le résultat. Le contrat utilise JSON et des réponses en anglais. Les guides et descriptions sont disponibles en français et en anglais.

Base du produit : https://api.befiana.cloud/api/sms/v2/.

L’authentification utilise une clé organisationnelle bf_sms_ dans Authorization: Bearer <key>. La clé détermine l’organisation. Ce contrat d’authentification concerne SMS v2 ; il ne définit pas celui des autres produits BEFIANA.

Choisir une opération

Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.

Besoin	Opération	Guide
Envoyer maintenant	POST /messages/ sans send_at	Envoi immédiat
Programmer un message	POST /messages/ avec send_at	Programmation
Programmer plusieurs destinataires	POST /message-batches/	Lots
Consulter un résultat	GET /messages/{message_id}/	Statuts
Consulter les crédits ou gérer un contact	GET /balance/, POST /contacts/	Crédits et contacts

Tous les chemins du tableau sont relatifs à la base du produit.

Les règles à connaître

• Un message contient au plus deux segments SMS.
• Une clé d’idempotence est obligatoire à la création d’un message ou d’un lot.
• Les envois programmés réservent leurs crédits dès l’admission.
• Une acceptation HTTP 201 ou 202 ne prouve pas la livraison.
• Les noms d’expéditeur se gèrent dans Cloud.
• Le suivi proposé repose sur la consultation de l’API. Aucun webhook client ni endpoint OTP spécialisé ne fait partie du contrat.

Commencez par votre premier SMS, puis suivez le parcours d’intégration. Les contraintes exactes restent dans la référence.

Vous utilisez déjà v1 ?

Les routes historiques restent sous /api/smsko/v1/. Consultez la migration pour adapter authentification, champs et suivi. Une ancienne clé est refusée en v2, même si elle a été rattachée à une organisation.