skip to Main Content
+229 97796861 miroirdubenin@gmail.com ESPACE CLIENT
Notre API SMS marketing au Bénin.

AUTOMATISATION DES PROCESS

L’envoi automatique de SMS depuis les applications, sites web et logiciels se fait grâce à l’intégration de notre API. Vous êtes une entreprise qui a besoin d’alerter un client sur une disponibilité de service, ou juste pour un rappel d’échéance?

INTEGRATION SIMPLE ET RAPIDE

Nous aimons l’efficacité dans la simplicité. Cela se traduit aussi dans nos process. La facilité de prise en main de notre API est un atout notable, nous y avons veiller. De la documentation, des exemplaires de codes et un service technique sont disponible pour vous permettre une intégration facile et rapide.

SENDER ID : NOM EXPEDITEUR PERSONNALISE

Comme support de marque, nous vous permettons de personnaliser le nom d’émetteur de vos messages. Vous utiliserez le nom de votre entreprise (au lieu d’un numéro de téléphone) comme émetteur de vos messages. Vous pouvez utiliser jusqu’à 11 caractères alphanumériques.

GESTION DES ACCUSES DE RECEPTION

Après chaque campagne, récupérer les accusés de réceptions. Suivez les états des SMS (délivré, encours, non délivré et autres); générer des rapports par campagnes et exportez les.

Développeur

Le webservice permet aux utilisateurs d’envoyer des messages par http via leur application. Pour accéder à vos statistiques et à vos données de facturation, vous pouvez les consulter sur votre compte à l’aide de vos identifiants de connexion sur http://gateway.sms-digit.com

CECI N'EST QU'UN EXEMPLE

ACCÉDER A VOTRE ESPACE CLIENT POUR LES PARAMÈTRES D’INTÉGRATION API

DES MISES A JOUR MAJEURES ONT ÉTÉ EFFECTUÉES

DEMANDE D'ENVOI DE SMS

Pour envoyer des SMS via l’API, il faut lancer une requête http vers l’adresse ci-dessous, en utilisant certains paramètres (texte à envoyer, téléphone numéro, destinataire, expéditeur, etc.), et nous enverrons une confirmation de réponse que tout s’est bien passé, ou une réponse d’erreur si elle n’a pas Les options de configuration disponibles, l’URL à appeler et le les paramètres pris en charge seront détaillés ci-dessous. Pour créer l’URL, le client doit effectuer un appel GET à l’adresse suivante:

http://gateway.sms-digit.com/fr/api/sendsms

username: le nom d’utilisateur que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

password: le mot de passe que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

signature: la signature que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

text: c’est le message à envoyer. Un sms vaut 153 caractères pratiques. Vous ne pouvez envoyer que trois pages de sms au maximum donc 459 caractères à la fois.

to: c’est le numéro de téléphone mobile du destinataire du message. Il est au format international c’est-à-dire suivi de l’indicatif du pays. Exemple: 22963355598 ou 22896434247

from: c’est le destinataire du message. Il est d’au plus 11 caractères alphanumériques.

date: Pour des envois en différé, vous spécifiez la date d’envoi au format suivant: YYYY-MM-DD.

time: Pour des envois en différé, vous spécifiez l’heure d’envoi en UTC au format suivant: HH:II:SS

Exemple:

http://gateway.sms-digit.com/fr/api/sendsms?username=sms@sms-digit.com&password=xxxxxxx&to=22990909090&text=ceci-est-un-test&from=smsclub&date=2018-12-31&time=23:59:59

RÉPONSE DU SERVEUR

{ 
  "code":"200", 
  "status":"success", 
  "signature":"vdkrrof33etzvld50al0mcn6S27jeezo", 
  "smsCount":1, 
  "text":"dsf", 
  "from":"df", 
  "to":"22963355598", 
  "messageid":"151802348450967924", 
  "observation":[true,"0: Accepted for delivery"] 
}

code: c’est le code de soumission de la requête. Il est 200 en cas de succès et 400 en cas d’erreur.

status: indique le status de la requête soumise. Il peut être failure ou success.

observation: indique les raisons du status de la requête.

signature: la signature utilisée pour la soumission de la requête

smsCount: le nombre de pages que le sms fait.

text: le text du message soumission.

to: le destinataire du message.

from: c’est le destinataire du message. Il est d’au plus 11 caractères alphanumériques.

messageid: c’est l’identifiant unique de soumission du message. C’est cet id qui est utilisé pour recevoir l’accusé de recéption du message.

 

SCRIPT PHP
les messages sont soumis au smsc par requête http. Le script php ci-dessous en est un exemple.

$sendsmsurl_prefix = "http://gateway.sms-digit.com/fr/api/sendsms";
$curl = curl_init();
$sendsmsurl_params = array( 
                           "username" => "votre email",
                           "password" => "votre password", "signature" => "votre signature",
                           "from" => "expéditeur du message", 
                           "to" => "destinataire du message", 
                           "text" => "message à envoyer" 
                   );
$sendsmsurl = $sendsmsurl_prefix."?".http_build_query($sendsmsurl_params);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); 
curl_setopt($curl, CURLOPT_URL, $sendsmsurl); 

curl_exec($curl); 
curl_close($curl);

ACCUSE DE RECEPTION

Vous pouvez recevoir l’accusé de réception de vos messages envoyés par la requête http

http://gateway.sms-digit.com/fr/api/delivery

avec les paramètres suivants:
username: le nom d’utilisateur que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

password: le mot de passe que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

signature: la signature que vous avez généré dans la rubrique gestion utilisateur de votre compte ou celui que votre gestionnaire de compte vous a fourni

messageid: c’est l’id unique du message envoyé. Cet id est renvoyé en réponse lors de la soumission du message.

Exemple:

http://gateway.sms-digit.com/fr/api/delivery?username=sms@sms-digit.com&password=xxxxxxx&messageid=151802348450967924

le serveur retourne une réponse en json au format suivant:

{
        "code":"200",
        "status":"success",
        "messageid":"151820123556397994",
        "messagestatus":"3",
        "dlr_date":"2018-01-01",
        "dlr_time":"10:01:55",
        "observation":"Message delivered to next instance"
    }

code: c’est le code de soumission de la requête. Il est 200 en cas de succès et 400 en cas d’erreur.

status: indique le status de la requête soumise. Il peut être failure ou success.

messageid: c’est l’id unique du message.

messagestatus: c’est le code du statut du message. Il peut prendre les valeurs suivantes:

1: Le message a été soumis au SMSC, il s’agit d’une notification intermédiaire et non d’un résultat final
2: Le message n’a pas pu être remis au destinataire
3: Message envoyé au combiné ou à la prochaine instance
observation: indique les raisons du status du message.

SCRIPT PHP
Exemple de script php pour obtenir l’accusé de réception

$sendsmsurl_prefix = "http://gateway.sms-digit.com/fr/api/delivery";
    $curl = curl_init();
    $sendsmsurl_params = array(
                            "username"  => "votre unsername",
                            "password"  => "votre password",
                            "signature" => "votre signature",
                            "messageid" => "identifiant unique du message obtenu à la soumission",       
                        );
    $sendsmsurl = $sendsmsurl_prefix."?".http_build_query($sendsmsurl_params);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_URL, $sendsmsurl);

    curl_exec($curl);
    curl_close($curl);

CONNECTIVITE DE LA ROUTE
Vous pouvez vérifier la connectivité de votre route par la requête http suivante:

http://gateway.sms-digit.com/fr/api/check?username=sms@sms-digit.com&password=xxxxxxx

Le serveur retourne une réponse en json au format suivant:

{
        "code":"200",
        "balance":"17.699",
        "status":"success"
    }

code: c’est le code de soumission de la requête. Il est 200 en cas de succès et 404 en cas d’erreur.

status: indique le status de la requête soumise. Il peut être failure ou success.

balance: c’est le solde de votre compte en EUR.

NB: En cas de code 404, alors il y a une erreur soit dans le username, le password ou la signature

SCRIPT PHP
Exemple de script php pour la vérification de la route

$sendsmsurl_prefix = "http://gateway.sms-digit.com/fr/api/check";
    $curl = curl_init();
    $sendsmsurl_params = array(
                            "username"  => "votre unsername",
                            "password"  => "votre password",
                            "signature" => "votre signature",
                        );
    $sendsmsurl = $sendsmsurl_prefix."?".http_build_query($sendsmsurl_params);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_URL, $sendsmsurl);

    curl_exec($curl);
    curl_close($curl);

SUPPORT
Pour toutes vos requêtes, notre équipe technique est à votre service 24h/24. N’hésitez pas à nous écrire au miroirdubenin@gmail.com

Back To Top