Table of Contents

Exemple d'utilisation du systeme de notifications par sms de free

prérequis

  1. Calaos
  2. Etre un client free mobile
  3. activer l'option (gratuit) dans son compte free mobile

Utilisation

source universfreebox

L’envoi du SMS se fait en appelant le lien suivant : https://smsapi.free-mobile.fr/sendmsg avec les paramètres suivants :
- user : votre login
- pass : votre clé d’identification générée automatiquement par notre service
- ms : le contenu du SMS encodé sous forme d’url (Percent-encoding)

Exemple : Envoyer le message "Hello World !" sur votre mobile :

https://smsapi.free-mobile.fr/sendmsg?user=XXXXXXXX&pass=XXXXXXXXXXXXXX&msg=Hello%20World%20!

Vous pouvez également, si vous le préférez, envoyer les paramètres en POST. Dans ce cas, le contenu du message n’a pas besoin d’être encodé.

Le code de retour HTTP indique le succès ou non de l’opération :
- 200 : Le SMS a été envoyé sur votre mobile.
- 400 : Un des paramètres obligatoires est manquant.
- 402 : Trop de SMS ont été envoyés en trop peu de temps.
- 403 : Le service n’est pas activé sur l’espace abonné, ou login / clé incorrect.
- 500 : Erreur côté serveur. Veuillez réessayez ultérieurement.

dans calaos installer, on crée une règle avec la condition souhaitée et en action on ajoute une Action Script, dans l'editeur d'action script on ajoute

function urlencode(str)
   if (str) then
      str = string.gsub (str, "\n", "\r\n")
      str = string.gsub (str, "([^%w ])",
         function (c) return string.format ("%%%02X", string.byte(c)) end)
      str = string.gsub (str, " ", "%%20")
   end
   return str    
end

local user = "username"
local pass = "password"
local msg = "le message à envoyer en fonction de la règle"

calaos:requestUrl("https://smsapi.free-mobile.fr/sendmsg?user="..user.."&pass="..pass.."&msg="..urlencode(msg))

return true

check, ok, fermer, tester