API SMS

Vous avez besoin d'utiliser une API SMS ? Automatiser l'envoi de vos SMS via des requêtes personnalisées est facile avec les packs SMS LWS !

Utiliser une API SMS

Les SMS sont utilisés dans de nombreuses campagnes de communication et de promotion. Leur rapidité d'envoi et la réactivité de leurs destinataires en font un moyen de communication efficace. Avec notre offre SMS, il vous suffit d’avoir une connexion internet pour envoyer des messages. Vous pouvez personnaliser votre nom d'expéditeur et de choisir le type de SMS à envoyer : en différé, SMS flash, envoi massif, envoi de sms en nombre...

LWS fournit gratuitement une API SMS qui vous permet d'automatiser l'envoi de tout type de SMS depuis votre site, une tâche planifiée, un simple formulaire… Les scripts fournis simplifient l'envoi de SMS multiples.

Envoyer des SMS via une API
Fonctionnement API d'envoi SMS

API SMS : 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 le biais de cette méthode, vous n'aurez besoin que de vos identifiants SMS (reçus lors de la livraison de votre commande).

Personnalisez les requêtes que nous vous fournissons procédez à l'automatisation de l'envoi de vos SMS professionnels : indiquez le type de contenu, votre ID expéditeur, les numéros de téléphone de vos contacts enregistrés, votre message et lancez le script ! Notre API permet d'envoyer un grand nombre de SMS en peu de temps.

API SMS : Fonction Envoyer des 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.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE

Les paramètres sont les suivants :

  • SMS_API_KEY : Il s'agit de votre clé API accessible dans la rubrique "SMS API" de votre espace SMS
  • DESTINATAIRE : Il s'agit du numéro de téléphone du destinataire au format international
  • SenderID : Il s'agit de votre identifiant expéditeur
  • VOTRE_MESSAGE : contenu du SMS

Réponse Success au format JSON

// 20220303115207
// https://sms.lws.fr/sms/api?action=send-sms&api_key=SMS_API_KEY=&to=DESTINATAIRE&from=SenderID&sms=VOTRE_MESSAGE

{
"code": "ok",
"message": "Successfully Send",
"balance": "XX",
"user": "XXXXX"
}

Descriptif du retour :

  • 2 premières lignes : Représente la date d'envoi du SMS et indique l'url appelée.
  • code : Retour ok si l'envoi s'est bien déroulé sinon retourne un id d'erreur
  • message : Information sur le succès ou l'erreur de l'envoi SMS
  • balance : Le solde restant de SMS après envoi
  • user : Votre nom d'utilisateur

Exemple d'utilisation de l'API en PHP

Envoyer un SMS via l'API en PHP

<?php
/* Url de l'API */ $gateway_url = "https://sms.lws.fr/sms/api"; /* Action appelé */ $action = "send-sms"; /* Clé API */ $apiKey = "Votre clé API"; /* Numéro vers lequel sera envoyé le SMS * Format International - exemple 33600000000 */ $to = "33600000000"; /* SenderID qui sera affiché sur le téléphone portable. */ $senderID = "Votre SenderID"; /* Encode le message en version SMS qui sera envoyé */ $message = urlencode("Votre rendez-vous du 13 avril à 10h30 a bien été validé."); // Prepare le tableau de données pour la requête API $data = array('action' => $action, 'api_key' => $apiKey, 'to' => $to, 'from' => $senderID, 'sms' => $message, ); // Envoie la requête API via cURL $ch = curl_init($gateway_url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); $get_data = json_decode($response, true); /* On traite le retour. * get_data['code'] récupére un code selon la réussite ou l'erreur de l'API * get_data['Message'] récupére le message Success ou explication de l'erreur. */ if($get_data['code'] === 'ok'){ /* La suite de votre script en cas de succès d'envoi */ } else { echo 'Code Erreur : '.$get_data['code'].' -- '.$get_data['message']; /* La suite de votre script en cas d'erreur d'envoi */ } ?>