Vous avez besoin d'envoyer des SMS en masse ? d'utiliser une API SMS ? |
Vous avez besoin d'envoyer des SMS en masse ? d'utiliser une API SMS ?
Les
SMS sont maintenant associés à de nombreuses campagnes de communication et de promotion de par la rapidité de leur envoi et la réactivité de leurs destinataires.
Avec notre
offre SMS, il vous suffit d’avoir une connexion internet pour envoyer des messages. Vous avez la possibilité de personnaliser l’expéditeur et de choisir le type de SMS à envoyer : en différé, SMS flash, envoi massif...
LWS fournit gratuitement une
API SMS, ce qui vous permettra d'automatiser tout type d'envoi de SMS depuis votre site, une tâche planifiée, un simple formulaire ...
Principe de fonctionnement
Si vous possédez un compte SMS chez LWS, vous pouvez émettre des SMS depuis votre navigateur web préféré, directement depuis l'url, à l'aide de wget, d'un fopen en php ...
Pour envoyer un SMS par cette méthode il vous faudra juste vos identifant SMS ( que vous avez reçus à la livraison de votre commande).
Fonction Envoyer un SMS
Pour envoyer un SMS, c'est simple et rapide, il suffit d'envoyer une requête HTTPS avec ses paramètres à l'adresse suivante :
https://sms.lws-hosting.com/api/sendsms/USERNAME/PASSWORD/CONTENT_TYPE/EXPEDITEUR/DESTINATAIRE/MESSAGE
Les paramètres doivent être séparé par des '/' et sont les suivants :
- USERNAME : votre adresse email qui sert aussi pour l'interface web
- PASSWORD : votre mot de passe sms
- CONTENT_TYPE : type de contenu de la réponse : xml, text ou json
- EXPEDITEUR : numéro de l'expéditeur au format international. Attention : l'expéditeur doit être enregistré dans votre liste d'expéditeurs
- DESTINATAIRE : numéro du destinataire au format international
- MESSAGE : contenu du SMS
Voici les réponses :
Pour les 3 formats pour les réponses qui sont de la forme suivante :
En "xml" (Succès) :
<?xml version="1.0" encoding="UTF-8" ?><response><status>SUCCESS</status><message>Envoi du sms en cours.</message></response>
En "xml" (Erreur) :
<?xml version="1.0" encoding="UTF-8" ?><response><status>ERROR</status><message>MESSAGE D'ERREUR</message></response>
En "text" (Succès):
SUCCESS Envoi du sms en cours.
En "text" (Erreur) :
ERROR MESSAGE D'ERREUR
En "json" (Succès) :
{"status":"SUCCESS","message":"Envoi du sms en cours."}
En "json" (Erreur) :
{"status":"ERROR","message":"MESSAGE D'ERREUR"}
Fonction nombre de credits disponibles
Pour savoir le nombre de crédit SMS disponibles pour votre compte, c'est simple et rapide, il suffit d'envoyer une requête HTTPS avec ses paramètres à l'adresse suivante :
https://sms.lws-hosting.com/api/checkcredits/USERNAME/PASSWORD/CONTENT_TYPE
Les paramètres doivent être séparé par des '/' et sont les suivants :
- USERNAME : votre adresse email qui sert aussi pour l'interface web
- PASSWORD : votre mot de passe sms
- CONTENT_TYPE : type de contenu de la réponse : xml, text ou json
Voici les réponses :
Pour les 3 formats pour les réponses qui sont de la forme suivante :
En "xml" (Succès) :
<?xml version="1.0" encoding="UTF-8" ?><response><status>SUCCESS</status><message>292.23</message></response>
En "xml" (Erreur) :
<?xml version="1.0" encoding="UTF-8" ?><response><status>ERROR</status><message>MESSAGE D'ERREUR</message></response>
En "text" (Succès):
SUCCESS
292.23
En "text" (Erreur) :
ERROR
MESSAGE D'ERREUR
En "json" (Succès) :
{"status":"SUCCESS","message":"297.32"}
En "json" (Erreur) :
{"status":"ERROR","message":"MESSAGE D'ERREUR"}
Exemple d'utilisation de l'api en PHP
Exemple 1 en php pour envoyer un SMS :
<?php
function sms_lws($username,$password,$message,$expediteur,$destinataire)
{
$message = urlencode($message);
$sms=@file("https://sms.lws-hosting.com/api/sendsms/$username/$password/text/$expediteur/$destinataire/$message");
if ($sms[0] != 'Error') {
echo 'votre sms est envoye';
} else {
echo 'Erreur:'.$sms[0].$sms[1];
}
}
sms_lws("xxxxxx@xxxx.fr","votrePasswordxxxxxx", bonjour mon premier message","33619XXXXXXXX","33619XXXXXXXX") ;
?>
Exemple 2 en php pour envoyer un SMS :
<?php
$text = 'envois de mon premier sms par LWS';
$url = 'https://sms.lws-hosting.com/api/sendsms/' .
'xxxx@xxxx.fr/'.
'xxxx/'.
'text/' .
'33619xxxxxx/'.
'33619xxxxxx/'.
'/'. urlencode('$text') .;
$response = @file_get_contents($url);
if ($response != 'Error') {
echo 'votre sms est envoye';
} else {
echo 'Erreur:'.$response;
}
?>
Exemple 3 en php pour savoir votre nombre de crédit SMS de votre compte :
<?php
function smscredit_lws($username,$password)
{
$sms=@file("https://sms.lws-hosting.com/api/checkcredits/$username/$password/text");
if ($sms[0] != 'Error') {
echo "votre credit sms lws est de $sms[1] Euros";
} else {
echo 'Erreur:'.$sms[0].$sms[1];
}
}
smscredit_lws("xxxx@xxxxx.fr","xxxxxxx") ;
?>