Une HTTP API (REST) et SMPP pour connecter vos systèmes à la plateforme e-MC, ainsi qu'une API Phone Number Checker. Les aperçus ci-dessous montrent leur structure avec des valeurs fictives ; l'URL de base, les identifiants et la documentation complète sont transmis lors de l'intégration.
L'API REST d'e-MC envoie vos SMS depuis votre serveur et en restitue le statut de livraison. Voici la structure d'un envoi, avec des valeurs fictives.
POST {{baseUrl}}/sms
Authorization: Basic YOUR_ENCODED_CREDENTIALS
Content-Type: application/json
{
"from": "YOUR_SENDER_ID",
"to": "229XXXXXXXXX",
"content": "Your verification code is 482913"
}HTTP 200
{
"data": {
"Success": "Please save this id",
"messageId": "YOUR_MESSAGE_ID"
}
}GET {{baseUrl}}/sms/YOUR_MESSAGE_ID/status
Authorization: Basic YOUR_ENCODED_CREDENTIALS
{
"data": {
"msgid": "YOUR_MESSAGE_ID",
"status": "DELIVERED",
"destination_addr": "229XXXXXXXXX",
"created_at": "YYYY-MM-DD HH:MM:SS",
"status_at": "YYYY-MM-DD HH:MM:SS"
}
}{{baseUrl}} — URL de base fournie par e-MC lors de l'intégration. Toutes les valeurs affichées sont fictives.
L'API e-PNC valide un numéro de téléphone international et renvoie, en un seul appel, son pays, son opérateur et son type de ligne. Elle s'appelle depuis votre backend, par exemple avant d'envoyer un OTP.
POST {{baseUrl}}/[resource]
x-api-key: YOUR_API_KEY
Content-Type: application/json
{
"phone": "+229XXXXXXXXX"
}HTTP 200
{
"valid": true,
"phone_e164": "+229XXXXXXXXX",
"phone_local": "229XXXXXXXXX",
"country_code": "BJ",
"country": "Benin",
"network": "MTN",
"type": "mobile",
"recommended_action": "proceed"
}HTTP 200
{
"valid": false,
"reason": "invalid_number"
}{{baseUrl}} — URL de base fournie par e-MC. Le chemin de la ressource figure dans la documentation. Toutes les valeurs affichées sont fictives.
Pensée pour les applications web, mobiles et métiers : votre code appelle l'API au moment où un événement doit déclencher un SMS (inscription, paiement, alerte).
Protocole standard de connexion système à système avec un centre de messages courts. Il s'adresse aux plateformes et aux systèmes de messagerie, aux entreprises qui disposent déjà d'une infrastructure SMPP et aux volumes importants.
Illustration : maquette indicative, non contractuelle.
| Critère | HTTP API (REST) | SMPP |
|---|---|---|
| Connexion | Requêtes HTTP émises par votre application | Session continue de système à système |
| Usage typique | Applications web, mobiles et métiers : OTP, alertes, notifications | Plateformes d'envoi, revendeurs, trafic important |
| Envoi de SMS | Oui | Oui |
| Rapports de livraison | Oui | Oui |
| SMS entrants | Oui | Oui |
| Vérification de numéro | Oui, avec l'API e-PNC | Oui, avec l'API e-PNC |
| Compte et documentation | Fournis sur demande | Fournis sur demande |
Par HTTP API (REST) ou par SMPP, vers l'Afrique et l'international.
Collectez le statut de chaque message.
Avec l'API Phone Number Checker (e-PNC) : validité, pays, opérateur et type de ligne.
Récupérez les SMS entrants de vos contacts.
Destinataire, expéditeur et texte, par HTTP API ou par SMPP.
e-MC choisit la route vers l'opérateur du destinataire selon le routage configuré.
Chaque message reçoit un statut et, en cas d'échec, un code d'erreur.
Le statut arrive par rapport de livraison ; les réponses des destinataires remontent sous forme de SMS entrants.
Les aperçus de cette page sont volontairement simplifiés : les paramètres complets, les formats de réponse et les exemples de code figurent dans la documentation fournie avec le compte.
L'accès à la plateforme passe par un compte dédié, ouvert après échange avec notre équipe.
Les comptes HTTP API et SMPP sont ouverts sur demande, en fonction de votre cas d'usage et de votre volume mensuel estimé.
Vos identifiants de connexion et la documentation technique vous sont transmis à l'ouverture du compte. La méthode d'authentification y est détaillée.
Un test de l'API SMS peut être mis en place sur demande, avant le passage en production.
Un message passe par plusieurs états avant d'être délivré ou rejeté. En cas d'échec, un code d'erreur en précise la cause. Extrait de la référence, actuellement en cours de relecture.
| Code | Groupe | Nom | Description |
|---|---|---|---|
| 0 | OK | NO_ERROR | No Error |
| 1 | HANDSET ERROR | EC_UNKNOWN_SUBSCRIBER | Unknown Subscriber |
| 5 | HANDSET ERROR | EC_UNIDENTIFIED_SUBSCRIBER | Unidentified Subscriber |
| 6 | HANDSET ERROR | EC_ABSENT_SUBSCRIBER_SM | Absent Subscriber |
| 9 | HANDSET ERROR | EC_ILLEGAL_SUBSCRIBER | Illegal Subscriber |
| 10 | OPERATORS_ERRORS | EC_BEARER_SERVICE_NOT_PROVISIONED | Bearer Service Not Provisioned |
Les exemples de cette page montrent la structure de nos APIs.
Par le formulaire de contact, en décrivant votre cas d'usage.
Nous validons avec vous le service adapté, vos pays de destination et votre volume mensuel estimé.
Un compte test est mis en place sur demande pour valider votre intégration.
Vous raccordez vos applications en HTTP API ou en SMPP, avec l'assistance de notre équipe.
Vous lancez vos envois et suivez chaque message grâce aux rapports de livraison.
Oui. Un test de l'API SMS peut être mis en place sur demande, pour valider votre projet avant de vous engager. Utilisez le formulaire en choisissant « Demander un compte test ».
Une HTTP API (REST) et une connexion SMPP.
Les comptes HTTP API et SMPP, ainsi que la documentation, sont fournis sur demande. Contactez-nous en précisant votre cas d'usage.
Oui, avec le SMS bidirectionnel : il peut s'appuyer sur un short code, un numéro long ou un numéro virtuel. Voir la page dédiée.
Notre équipe vous assiste pour l'interopérabilité avec vos bases de données et votre système d'information. Décrivez votre architecture, nous vous disons quel mode de connexion convient.