Introduction

Lisoloo est l’API d’envoi de SMS en masse exposée par la plateforme Bloonio. Elle accepte un destinataire unique ou une liste de plusieurs milliers, envoie immédiatement ou à une date planifiée, et rapporte l’état de livraison de façon synchrone (via GET /status/{id}) et asynchrone (via le callback_url que vous fournissez à chaque requête, ou le webhook configuré sur votre clé API).

Comment les pièces s’assemblent

Trois acteurs :

Le backend de votre application détient la clé api_key à long terme. C’est le seul endroit qui connaît le secret.
L’API Lisoloo à $BASE_URL/api/v1/lisoloo/sms-api valide la clé à chaque requête, met le SMS en file vers la connexion opérateur sous-jacente, et émet les accusés de livraison.
Votre endpoint webhook reçoit les mises à jour à mesure que le message progresse dans le cycle pending → processing → sent → delivered.

La surface API est volontairement réduite — quatre endpoints — donc la majeure partie de cette documentation porte sur la forme des requêtes, la sémantique de planification, et la signification des accusés.

Ce que vous obtenez

Un endpoint, trois modes d’envoi. POST /send gère les envois instantanés, planifiés et récurrents. Le champ sending_type bascule entre les modes ; la forme du corps varie selon scheduled_dates / recurring_schedule. Voir Types d’envoi.
Cycle de vie stable. Chaque message passe par pending → processing → sent → delivered, avec failed comme état terminal. Voir Cycle de vie d’un message.
Accusés via webhooks. Enregistrez un webhook_url sur votre clé API (avec authentification HTTP Basic optionnelle) et la passerelle enverra un POST à chaque changement d’état. Voir Présentation des webhooks.
Tarification multi-destinataire. Envoyez vers N numéros en un seul appel ; vous payez par destinataire × par segment SMS. Voir Limites de caractères.
Sandbox par défaut. Des URLs de base sandbox et production séparées sont affichées sur le Bloonio dev portal à côté de chaque clé API. Chaque exemple sur ce site suppose que vous avez exporté la bonne dans BASE_URL. Voir Environnements.

À qui s’adresse cette documentation

Ces documents supposent que vous êtes un développeur backend intégrant le SMS dans votre propre application. Vous devez être à l’aise avec HTTP, JSON et au moins l’un de cURL, Python, JavaScript ou PHP — chaque exemple sur ce site est fourni dans les quatre langages.

Si vous cherchez le tableau de bord, le parcours d’onboarding marchand ou la facturation — tout cela se trouve dans l’application Bloonio, pas ici.

Où aller ensuite

Démarrage rapide Envoyez votre premier SMS depuis cURL, Python, JavaScript ou PHP en moins de cinq minutes.

Authentification Le fonctionnement de l'en-tête app-key et comment le protéger.

Référence API Chaque endpoint, paramètre, schéma et réponse — pilotée par la spec OpenAPI.

Webhooks Recevez les accusés de livraison de façon asynchrone sur votre propre serveur.