Depuis hier, 11 juin 2014, l’opérateur de téléphonie mobile Free propose à ses abonnés une nouvelle fonction permettant de recevoir gratuitement des SMS via une API hébergée sur leurs serveurs. C’est une fonction très intéressante pour l’envoi d’alerte dans les installations domotique ou les objets connectés.

Merci Free, et encore merci !

Activer la fonction

La fonction est désactivée par défaut. Elle doit être activée dans votre espace abonné disponible sur http://mobile.free.fr

Une fois activée, une clé d’identification est générée. Elle doit être utilisée en conjonction avec votre mot de passe de compte pour utiliser l’API.

Cette API est très simple à utiliser, et surtout bien expliquée en sélectionnant le bouton d’information du panneau.

L’URL à utiliser ( incluant votre clé et votre mot de passe ) peut être directement copié de ce panneau pour réaliser le premier essai :

L’accès à l’API est sécurisé (https), heureusement !

L’option d’envoi de SMS de l’eedomus

L’eedomus,  avec l’option Premium, propose déjà la fonction d’envoi de SMS vers n’importe quel opérateur de téléphonie mobile. Le nombre de SMS est limité à 30 par mois ce qui est largement suffisant pour des messages d’alerte. Depuis une règle, plusieurs destinataires peuvent être avertis.

Ces alertes sont totalement intégrées au fonctionnement de la box, que ce soit au niveau de chaque périphérique que des règles. Elles sont facilement activées avec une case à cocher.

Alerte SMS pour un périphérique

Alerte SMS dans une règl

SMS illimités Free dans votre eedomus

Le passage à l’illimité sur l’envoi du SMS permet d’en envoyer plusieurs par jour à titre d’information plutôt que de se limiter à des messages d’alerte. Cela ne fonctionnera cependant que pour votre propre ligne Free mobile. Il faudra également passer systématiquement par la programmation de règles pour leur envoi.

Néanmoins la programmation est assez simple. Elle passera par l’appel d’un actionneur http. Il est possible d’utiliser un seul actionneur pour plusieurs comptes free mobile, mais pour plus de clarté, je préfère créer un actionneur par compte. La configuration de ces actionneurs a déjà été décrite dans le précédent article Donner de la voix à sa domotique,vous pouvez donc vous référer à celui-ci pour plus de détails :

 +    +  

La liste de valeurs du périphérique va contenir l’URL et les paramètres envoyés :

J’ai choisi cette fois-ci d’utilser les variables [VAR1] et [VAR2] pour stocker le code d’identification et le mot de passe, ils sont donc à rentrer dans l’onglet Configuration

Une nouvelle valeur est à ajouter pour chaque type de message à envoyer. Les paramètres sont :

• Description : nom qui sera affiché lors de la programmation des règles
• URL : https://smsapi.free-mobile.fr/sendmsg
• Type : GET
• Paramètres : ?user=[VAR1]&pass=[VAR2]&msg=Texte du message

J’ai découvert que les caractères accentués passent sans problème, vous pouvez donc entrer directement votre texte, espaces et accents compris.

Il est également possible d’intégrer la valeur d’un périphérique dans le message. J’envoie par exemple la température intérieure de ma maison avec les paramètres suivants :

• Paramètres : ?user=[VAR1]&pass=[VAR2]&msg=La température intérieure est de [LAST_VALUE PERIPH_ID=88094] degrés

88094 est le code API de ma sonde de température dans l’eedomus. Ce code s’affiche dans le panneau de configuration de chaque périphérique si l’API eedomus a été préalablement activée