Vous cherchez une solution pour la gestion de notifications instantanées, d’envois de messages transactionnels, de gestions de codes de validation sécurisés, de gestion de vos campagnes marketing. Et tout cela sans complications techniques ?
Vous êtes au bon endroit (surtout si vous développez en Node.js). Le SDK IKODDI transforme ces besoins complexes en quelques lignes de code simples.
IKODDI est votre plateforme de communication multicanale B2B développée par KREEZUS permettant aux entreprises d’effectuer des campagnes marketing via WhatsApp, SMS et Mail, d’envoyer des messages transactionnels, de distribuer du crédit mobile (Airtime) et des forfaits internet, et de gérer des codes OTP sécurisés. Notre SDK Node.js rend l’intégration encore plus rapide.
Pourquoi utiliser le SDK Node.js d'IKODDI ?
Parce que votre temps de développement compte. Le SDK vous donne accès aux fonctionnalités essentielles IKODDI avec un minimum de code.
Ce que vous pouvez faire :
- Envoi de SMS : Messages transactionnels, notifications, alertes, campagnes marketing.
- Distribution de crédit mobile : Airtime et forfaits internet en masse pour vos collaborateurs ou clients.
- Gestion des OTP : Codes d’authentification sécurisés sans gérer la complexité technique.
Vous ne travaillez pas en Node.js ? Pas de problème. Notre API REST complète reste accessible pour tous les langages.
Cas d'usage
Le SDK IKODDI répond à des besoins concrets sur le terrain :
- Sécurisez vos applications avec des codes OTP qui arrivent en quelques secondes.
- Distribuez du crédit et des forfaits internet à vos équipes dans les zones reculées, même sans connexion permanente.
- Notifiez vos clients automatiquement pour les rappels de paiement, les confirmations de commande ou les changements de service.
Commencez en 4 étapes simples
L’intégration d’IKODDI suit un processus clair que nous avons optimisé avec des centaines d’entreprises.
Étape 1 : Créez votre compte gratuitement
Rendez-vous sur ikoddi.com et inscrivez-vous. L’inscription est gratuite et vous recevez 500 FCFA de crédit SMS pour tester la plateforme immédiatement.
Identifiez ensuite votre besoin principal : envoi de SMS en masse, distribution d’Airtime, ou intégration d’OTP pour sécuriser vos applications.
Étape 2 : Récupérez vos clés d’API
Une fois connecté, générez vos clés d’API depuis votre tableau de bord (section Paramètres > Clés d’API).
Exemple de clés API disponible : « Envoyer des sms », « Envoyer du airtime », « Demander et vérifier un OTP », « Lire les APP OTP »
Important pour la sécurité : Chaque clé peut avoir des permissions spécifiques. Créez une clé uniquement pour l’envoi de SMS, une autre pour l’Airtime, selon vos besoins. Ce principe de moindre privilège protège vos systèmes.
Étape 3 : Testez dans l’environnement de staging
IKODDI met à votre disposition un environnement de test séparé pour développer sereinement avant le passage en production.
Notre équipe technique vous accompagne gratuitement pendant cette phase :
- Analyse de vos besoins d’intégration
- Support technique durant le développement
- Tests conjoints dans l’environnement staging
- Validation avant la mise en production
Étape 4 : Passez en production
Une fois vos tests validés, basculez vers l’environnement de production. Notre support reste disponible pour vous accompagner.
Installation et premiers pas avec le SDK
Le SDK IKODDI est disponible sur npm. L’installation prend quelques secondes.
Installation :
npm install ikoddi-client-sdkConfiguration initiale :
import { Ikoddi } from "ikoddi-client-sdk";
// Initialisation du client IKODDI
const ikoddiClient = new Ikoddi()
.withApiKey("VOTRE_CLE_API")
.withGroupId("VOTRE_GROUP_ID");
// Pour les tests, ajoutez l'URL de staging
// .withApiBaseURL("https://api.staging.ikoddi.com/api/v1/groups/")Envoi de SMS : Simple et direct ion et premiers pas avec le SDK
Envoyer des SMS devient une opération en quelques lignes. Que ce soit pour des notifications transactionnelles ou des campagnes marketing, le SDK gère tout.
Exemple concret :
import { Ikoddi } from "ikoddi-client-sdk";
const ikoddiClient = new Ikoddi()
.withApiKey("VOTRE_CLE_API")
.withGroupId("VOTRE_GROUP_ID");
// Envoi de SMS
await ikoddiClient.sendSMS(
["22670123456", "22670234567"], // Numéros destinataires
"IKODDI", // Nom de l'expéditeur
"Votre commande est confirmée ! Suivez-la sur notre site.", // Message
"Confirmation commandes" // Nom de la campagne
);Paramètres disponibles :
numbers: Liste des numéros destinatairesfrom: Nom de l’expéditeur (votre marque)message: Contenu du messagesmsBroadcast: Nom de la campagne pour le suiviphoneCode: Code pays (226 par défaut pour le Burkina Faso)isoCode: Code ISO du pays (BF par défaut)
Distribution d'Airtime : Rechargez vos collaborateurs automatiquement / SVA
La distribution de crédit mobile et de forfaits internet se programme facilement. Idéal pour les dotations mensuelles, les récompenses clients, la création d’un nouveau service à valeur ajoutée (revente) avec génération de revenu.
Récupération des forfaits disponibles :
// Liste des forfaits internet disponibles
const forfaits = await ikoddiClient.internetPlans();
console.log(forfaits);Envoi d’Airtime :
// Envoi de crédit mobile
await ikoddiClient.sendAirtime(
["22670123456"], // Numéros destinataires
"11101", // Référence opérateur (11101=Orange, 12131=Moov, 13160=Telecel)
"1000", // Montant en FCFA
"Dotation mensuelle" // Nom de la transaction
);
// Envoi de forfait internet
await ikoddiClient.sendAirtime(
["22670123456"],
"REF_FORFAIT", // Référence obtenue via internetPlans()
"2000",
"Forfait data collaborateurs"
);Exemples de références opérateurs :
- Orange Burkina :
11101 - Moov Burkina :
12131 - Telecel Burkina :
13160
Pour les forfaits internet, utilisez la référence obtenue via internetPlans().
Service OTP : Sécurisez vos applications sans complexité
Le service OTP d’IKODDI est un différenciateur majeur. La plateforme gère entièrement la génération, l’envoi et la validation des codes. Vous vous concentrez sur votre application.
Configuration depuis l’interface IKODDI :
Avant d’utiliser les OTP, créez une application OTP dans votre tableau de bord IKODDI. Vous pouvez configurer :
- La longueur du code (4, 6, 8 chiffres)
- La durée de validité (1 à 30 minutes)
- Le type de caractères (chiffres, lettres, majuscules, caractères spéciaux)
- Le contenu du message SMS personnalisé
Fonctionnalité pour les tests : La liste blanche vous permet de définir des numéros qui recevront toujours le même code OTP fixe. Idéal pour vos tests automatisés sans consommer de SMS.
Implémentation dans votre code :
import { Ikoddi } from "ikoddi-client-sdk";
// Initialisation avec l'ID de votre application OTP
const ikoddiClient = new Ikoddi()
.withApiKey("VOTRE_CLE_API")
.withGroupId("VOTRE_GROUP_ID")
.withOtpAppId("VOTRE_OTP_APP_ID");
// 1. Envoi du code OTP
const otpResponse = await ikoddiClient.sendOTP("22670123456");
console.log(otpResponse);
// Retourne : {"status":0, "otpToken":"TOKEN_UNIQUE"}
// L'utilisateur reçoit son code par SMS
// 2. Vérification du code saisi par l'utilisateur
const verification = await ikoddiClient.verifyOTP({
identity: "22670123456",
otp: "123456", // Code saisi par l'utilisateur
verificationKey: otpResponse.otpToken
});
console.log(verification);
// Retourne : {"status":0, "message":"OTP Matched for 22670123456"}Pourquoi ce service change tout :
Vous n’avez plus à gérer la génération aléatoire des codes, leur stockage temporaire, leur expiration, ni la validation. IKODDI s’en charge. Vous gagnez du temps de développement et réduisez les risques de failles de sécurité.
Gestion des environnements : Staging et Production
Le SDK facilite le basculement entre environnements de test et de production.
Environnement de staging :
const ikoddiClient = new Ikoddi()
.withApiKey("VOTRE_CLE_API_TEST")
.withGroupId("VOTRE_GROUP_ID")
.withApiBaseURL("https://api.staging.ikoddi.com/api/v1/groups/");Environnement de production :
const ikoddiClient = new Ikoddi()
.withApiKey("VOTRE_CLE_API_PROD")
.withGroupId("VOTRE_GROUP_ID");
// L'URL de production est utilisée par défautRessources complémentaires
Documentation complète : Consultez le SDK sur GitHub : github.com/kreezus/ikoddi-nodejs-sdk
Package npm : npmjs.com/package/ikoddi-client-sdk
Support technique : L’équipe KREEZUS vous accompagne gratuitement pendant votre intégration : contact-ikoddi@kreezus.com.
Devenez autonome avec IKODDI
L’objectif d’IKODDI est simple : vous rendre totalement autonome dans la gestion de vos communications. Le SDK Node.js vous donne le contrôle complet sur vos notifications, vos campagnes et vos services d’authentification.
Vous développez sur une plateforme sécurisée, optimisée pour l’Afrique de l’Ouest, avec une équipe locale qui comprend vos défis.
Prêt à intégrer IKODDI dans votre application ?
Créez votre compte gratuit sur ikoddi.com, récupérez vos 500 FCFA de crédit SMS, et commencez à coder dès maintenant.
