Tout ce qu'il faut savoir pour intégrer FastNotify dans votre application, expliqué simplement.
FastNotify est une plateforme SMS professionnelle qui permet aux développeurs d'intégrer l'envoi de messages texte dans leurs applications grâce à une API REST simple et sécurisée.
Ce guide explique, sans code complexe, comment fonctionne l'API FastNotify et les étapes à suivre pour l'intégrer dans n'importe quelle application.
Ce guide est destiné aux développeurs web, mobile ou backend qui souhaitent ajouter des fonctionnalités SMS dans leurs applications existantes.
Envoyez des messages texte personnalisés à vos clients avec leur nom et informations.
Générez et envoyez des codes de vérification à usage unique pour sécuriser vos utilisateurs.
Envoyez des alertes de commande, livraison ou paiement automatiquement.
Envoyez des milliers de SMS personnalisés en une seule requête.
Déclenchez une séquence complète de SMS automatiques (OTP + messages) en une seule requête API.
L'API FastNotify fonctionne selon le modèle REST. Imaginez l'API comme un guichet de service : votre application fait une demande, le guichet traite la demande et vous donne une réponse.
| Étape | Votre application fait... | FastNotify répond... |
|---|---|---|
| 1 | Envoie une requête HTTP POST vers l'URL de l'API | Reçoit la requête et vérifie votre identité |
| 2 | Fournit votre clé API dans l'en-tête | Vérifie votre clé et votre solde SMS |
| 3 | Envoie les données (numéro, message) | Transmet le SMS via le réseau téléphonique |
| 4 | Attend la réponse JSON | Retourne le résultat avec le statut d'envoi |
Pour utiliser l'API FastNotify, vous devez vous identifier avec une clé API unique. Cette clé joue le rôle de mot de passe pour accéder à l'API.
Connectez-vous sur FastNotify → Cliquez sur "🔑 Ma clé API" dans le menu → Copiez votre clé.
// En-tête à inclure dans chaque requête
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
Ne partagez jamais votre clé API publiquement (GitHub, forum, etc.). Si votre clé est compromise, régénérez-en une nouvelle depuis votre dashboard FastNotify.
Un endpoint est l'adresse URL à laquelle vous envoyez vos requêtes. Chaque fonctionnalité de FastNotify a son propre endpoint.
| Endpoint | Méthode | Description |
|---|---|---|
| /api/sendsms.php | POST | Envoyer un SMS simple à un numéro |
| /api/sendotp.php | POST | Générer et envoyer un code OTP |
| /api/settings.php | POST | Envoyer une notification prédéfinie |
| /api/template.php | POST | Envoyer un SMS via un modèle |
| /api/sendbulksms.php | POST | Envoyer des SMS en masse |
| ✨ /api/autoflow.php | AUTO | Séquence SMS automatique — OTP + messages configurables en 1 requête |
Tous les endpoints commencent par : https://fastnotify.online
Exemple : https://fastnotify.online/api/sendsms.php
Voici les étapes à suivre pour intégrer FastNotify dans votre application, du début à la fin.
Rendez-vous sur la page d'accueil, choisissez un plan adapté, inscrivez-vous et payez via MTN MoMo ou Orange Money.
Connectez-vous au dashboard → "🔑 Ma clé API" → Copiez et conservez votre clé dans un endroit sécurisé.
Dashboard → "📖 Documentation API" → identifiez l'endpoint dont vous avez besoin et consultez les paramètres.
URL de base + clé API + endpoint ciblé. Stockez la clé dans une variable d'environnement, jamais dans le code source.
POST avec le header Authorization et les données JSON (numéro, message). Vérifiez la réponse.
success: true → SMS envoyé. success: false → lisez le champ error.
// Réponse succès
{ "success": true, "message_id": "SMxxxxxx", "sms_restants": 487 }
// Réponse erreur
{ "success": false, "error": "Solde SMS insuffisant" }
Voici les scénarios les plus courants d'intégration de FastNotify dans une application.
Le client valide sa commande → votre app récupère son numéro → appelle FastNotify → le client reçoit un SMS de confirmation instantanément.
L'utilisateur entre son numéro → votre app appelle /api/sendotp.php → FastNotify génère et envoie le code → l'utilisateur entre le code pour valider.
Préparez votre liste → rédigez votre message avec variables {nom} → appelez /api/sendbulksms.php → FastNotify personnalise et envoie chaque SMS.
Créez vos modèles dans FastNotify → appelez /api/template.php avec l'ID et le numéro → message prédéfini envoyé automatiquement.
L'endpoint AutoFlow est la fonctionnalité la plus puissante de FastNotify. En une seule requête API, il déclenche automatiquement une séquence complète de SMS : d'abord un OTP de vérification, puis les messages que vous configurez dans l'ordre de votre choix.
Au lieu d'appeler 3 ou 4 endpoints séparément, AutoFlow fait tout d'un coup : OTP → Bienvenue → Confirmation → Notification. C'est idéal pour les flux d'inscription ou d'onboarding de nouveaux utilisateurs.
| Paramètre | Type | Description |
|---|---|---|
phone | string | Numéro du destinataire au format international (+237XXXXXXXXX) |
nom | string | Nom du client — remplace automatiquement {nom} dans tous les messages |
sequence | array | Liste ordonnée des actions à exécuter après l'OTP automatique |
delai_secondes | integer | Délai avant chaque action (0 par défaut) — pour espacer les SMS |
Voici comment un développeur utilise AutoFlow lors de l'inscription d'un utilisateur sur son application :
Votre application récupère son nom et son numéro de téléphone.
En envoyant le numéro, le nom et la séquence souhaitée dans une seule requête POST.
Code à 6 chiffres envoyé immédiatement pour vérifier le numéro du client.
Vous vérifiez le code — si valide, l'inscription est confirmée.
Message de bienvenue après 2 secondes, puis votre template de confirmation après 5 secondes.
// Requête AutoFlow — 1 seul appel API pour tout déclencher
POST https://fastnotify.online/api/autoflow.php
Authorization: Bearer VOTRE_CLE_API
Content-Type: application/json
{
"phone": "+237672237297",
"nom": "Jean Dupont",
"sequence": [
// Étape 2 : Notification de bienvenue après 2 secondes
{
"type": "notification",
"notif_type": "bienvenue",
"delai_secondes": 2
},
// Étape 3 : Template personnalisé après 5 secondes
{
"type": "template",
"template_id": 1,
"delai_secondes": 5,
"variables": { "montant": "5000" }
},
// Étape 4 : SMS libre personnalisé
{
"type": "sms",
"message": "Bonjour {nom}, votre compte est maintenant actif !"
}
]
}
// Rapport complet de la séquence exécutée
{
"success": true,
"message": "Flux AutoFlow exécuté",
"rapport": {
"total_etapes": 4,
"envoyes": 4,
"echecs": 0,
"telephone": "+237672237297",
"nom": "Jean Dupont"
},
"resultats": [
{ "etape": 1, "type": "otp", "statut": "envoyé" },
{ "etape": 2, "type": "notification", "statut": "envoyé" },
{ "etape": 3, "type": "template", "statut": "envoyé" },
{ "etape": 4, "type": "sms", "statut": "envoyé" }
]
}
Utilisez delai_secondes pour espacer vos messages. Un délai de 2 à 5 secondes entre chaque SMS évite de submerger l'utilisateur et améliore l'expérience globale. Exemple conseillé : OTP immédiat → Bienvenue après 3s → Confirmation après 10s.
Lorsqu'une requête échoue, FastNotify retourne un code HTTP accompagné d'un message explicatif.
| Code HTTP | Signification | Que faire ? |
|---|---|---|
| 200 | ✅ Succès | Le SMS a été envoyé avec succès. |
| 400 | Requête invalide | Vérifiez que tous les paramètres requis sont présents et correctement formatés. |
| 401 | Non autorisé | Votre clé API est manquante ou incorrecte. Vérifiez-la dans votre dashboard. |
| 403 | Solde insuffisant | Votre solde SMS est épuisé. Rechargez votre compte depuis la page Facturation. |
| 404 | Endpoint introuvable | L'URL de l'endpoint est incorrecte. Vérifiez la documentation API. |
| 500 | Erreur serveur | Problème côté serveur. Réessayez dans quelques minutes ou contactez le support. |
✅ Correct : +237612345678 ❌ Incorrect : 612345678 00237612345678 +237 612 345 678
Si vous rencontrez des difficultés lors de l'intégration de l'API FastNotify, voici les ressources disponibles :