Envoi automatisé de SMS par HTTP

Notre HTTP API vous permet d'intégrer facilement l'envoi SMS dans vos logiciels, applications ou sites internet toute en bénéficiant de toutes les options de note plateforme SMS.


Configuration requise :

 php >=5.6
 

Étapes :

  • Se connecter à votre compte SMS depuis notre plateforme https://smsplus.tn/websms/, activer l'accès API en générant votre propre clé API puis télécharger le fichier CLASS "Class_NetPlus_API.php" qui doit être renseigné comme suit :
    require_once 'Class_NetPlus_API.php';
    use NETPLUSSMSNETPLUSSMSAPI;
     $apikey = 'mettre votre API_KEY ici';      
     
  • Mettre votre entête (nom d'expéditeur) devant le paramètre "$from".
     $from = 'votre entête ici';  
     
  • Le numéro du destinataire. Le numéro doit commencer par le code pays (ex : 216 pour la Tunisie ; 33 pour la France)
     $destination = 'le numéro de votre destinataire';  
     
  • API url
      $url = 'https://smsplus.tn/websms/netplus/api';  
     
  • Le texte de votre message
      $sms = 'Votre message ici';  
     
  • La requête de votre message
      $s_body = array(
    'apikey' => $apikey,
    'to' => $destination,
    'from' => $from,
    'sms' => $sms,
    );      
     
  • Requête API
      $user = new NETPLUSSMSAPI();  
     
  • Envoyer votre SMS via API
      $response = $user->send_sms($s_body, $url);  
     
  • 2 Ways : Réception SMS
      $get_in=$user->get_in($apikey,$url);  
     
  • Réponse
    La réponse de notre API est au forma          json   :
      {"statut":"message":"Envoyé avec succès"}  

 


Exemple d'intégration en PHP

<?php
/* Vous pouvez exécuter cet exemple en 3 façons différentes:
*
* 1. Enregistrez ces lignes de code sous le nom "exemple.php" puis exécutez, avec la ligne de commande,
*  le fichier "exemple.php".
*
 * 2. Téléchargez le fichier "exemple.php" sur un espace d'hébergement (mon-site-web.com) puis chargez
* le fichier php dans un navigateur Web : mon-site-web.com/exemple.php
*
 * 3. Installez un serveur local comme WAMP, MAMP ou XAMPP. Téléchargez le fichier "exemple.php" dans la
* racine Web puis chargez "localhost:8888/exemple.php" dans un navigateur Web.
 */
// Étape 1: Accéder à votre compte SMS depuis notre plateforme https://smsplus.tn/websms/, activer l'accès
// API en générant votre propre clé API puis télécharger le fichier CLASS "Class_NetPlus_API.php" que doit être
// renseigné comme suit :
require_once 'Class_NetPlus_API.php';
use NETSPLUSSMSNETPLUSSMSAPI;
$apikey = 'mettre votre APIKEY ici';
// Étape 2: Changez l'entête, ci-dessous, par celui qui vous convient : votre nom d'enseigne.
$from = 'NetPlus';
// Étape 3: Indiquer le numéro de téléphone mobile de votre destinataire.
$destination = '21621000000';
// Étape 4: Adresse URL de notre HTTP API.
$url = 'https://smsplus.tn/websms/netplus/api';
// Le texte de votre message
$sms = 'Votre message ici';
// Création d'une requête SMS
$s_body = array(
'apikey' => $apikey,
'to' => $destination,
'from' => $from,
'sms' => $sms,
);
// Étape 5: Une nouvelle requête API
 $user = new NETPLUSSMSAPI();
 // Étape 6: Envoyer un SMS
$response = $user->send_sms($s_body, $url);
p_r($response);
// Étape 7: Obtenir une réponse
$response=json_decode($response);
// Afficher un message de confirmation sur l'écran
echo 'MSG: '.$response->message;
//Étape 8: Consulter votre boîte de réception
$get_in=$user->get_in($apikey,$url);
 ?>


Réponse de la requête HTTP POST

Statut

Message

ok

Envoi avec succès

100

Mauvaise demande

101

Mauvaise action

102

Authentification échouée

103

Numéro de téléphone invalide

104

La couverture de l'opérateur n'est pas activée

105

Solde insuffisant

106

 Nom d'expéditeur non valide

107

 Invalide SMS Type

108

 Passerelle non activée

109

 Date/heure de planification non valide

110

 Media url requis

111

 Le message contient des mots non autorisés