Premiers pas
Choisir votre produit
Section intitulée « Choisir votre produit »Le portail regroupe les contrats publics des services BEFIANA. Commencez avec SMS pour envoyer des messages, préparer des programmations et suivre leur livraison. Consultez la version documentée et sa disponibilité avant vos essais.
Les guides généraux vous aident à préparer l’accès et à comprendre les réponses. Les formats de clés, permissions et limites sont précisés pour chaque produit ; le contrat actuellement documenté est SMS v2.
Préparer votre organisation
Section intitulée « Préparer votre organisation »Pour SMS :
- Connectez-vous à BEFIANA Cloud et choisissez l’organisation qui réalisera les envois.
- Installez et activez SMS. Une installation en attente ne suffit pas pour envoyer.
- Vérifiez vos crédits et préparez un nom d’expéditeur utilisable.
- Créez une clé API avec les permissions nécessaires. Conservez son secret côté serveur.
- Suivez le quickstart SMS pour envoyer un message et consulter son statut.
Un appel réel peut consommer des crédits. Utilisez un destinataire autorisé et un texte adapté à votre essai.
Comprendre les adresses
Section intitulée « Comprendre les adresses »Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.
| Service | Base API | Usage |
|---|---|---|
| SMS v2 | https://api.befiana.cloud/api/sms/v2/ | Contrat organisationnel documenté dans ce portail |
| SMS v1 | https://api.befiana.cloud/api/smsko/v1/ | Intégrations existantes, avec leur guide de migration |
Le préfixe /api/ n’est pas une API produit à lui seul. Un identifiant ou une clé SMS ne doit pas être supposé compatible avec un autre service.
L’interface du portail est traduite. Les champs, valeurs de statut, codes d’erreur et messages JSON SMS v2 restent en anglais.
Préparer les reprises
Section intitulée « Préparer les reprises »Avant un envoi, sauvegardez l’opération métier, son corps et sa clé d’idempotence. À réception, conservez l’identifiant du message ou du lot. Une acceptation ne signifie pas une livraison.
Les recettes Node.js et Python montrent ce parcours. Les pages authentification, erreurs HTTP et codes d’erreur SMS vous aident à diagnostiquer un refus.