Homewizard: Comment envoyer des notification SMS avec Jeedom ?

Avec la box Homewizard, vous avez la possibilité d’envoyer des notifications électroniques gratuites vers votre smartphone en utilisant le Cloud du constructeur.

Par contre, les notifications par SMS sont payantes.

L’article décrit une méthode pour envoyer des notifications par SMS gratuitement en interfaçant HomeWizard avec Jeedom.

Pourquoi envoyer des notifications ?

La notification permet de vous prévenir d’un évènement qui vient de se produire dans votre maison, comme par exemple, une température trop basse ou une détection de présence alors que personne n’est censé être là.

Le « système domotique » vous envoie une notification. Cette notification peut être:

  • Electronique : La box domotique contacte le Cloud du constructeur de la box, et le Cloud contacte l’application Android ou iOS qui est sur votre smartphone et une notification sonore et visuel se produit pour vous prévenir.
  • SMS : La box domotique envoie directement un SMS.

Pourquoi envoyer un SMS ?

La notification électronique a ses limites car elle nécessite:

  • d’abord un Smartphone…
  • sur lequel l’application constructeur de la box est installée
  • et ensuite que le smartphone soit connecté sur Internet.

Ce n’est pas toujours le cas, surtout en vacances sur des zones non ou peu couvertes par les opérateurs téléphoniques.

Avec le SMS, un simple portable « sans internet » suffit pour être prévenu.

Comment ?

Comme indiqué au début de l’article, avec Homewizard, vous pouvez envoyer des notifications et des SMS, mais pour les SMS c’est payant (Voir article: Comment mettre en place les alertes avec la box HomeWizard ?)

Pour le SMS, l’idée est d’exploiter le plugin SMS de Jeedom pour envoyer une notification par SMS.

Il existe 2 plugins gratuits dans le market Jeedom:

  • Le plugin SMS
  • Le plugin freebox sms

C’est sur ce dernier que je vais faire la démonstration étant chez Free pour le mobile et le fixe.

Pour cela, je vous propose une démarche est en 5 étapes:

  • Créer un équipement avec le plugin SMS
  • Créer un scénario utilisant le plugin SMS
  • Écrire la commande API
  • Créer un objet « Switch IP » dans Homewizard
  • Créer une tâche utilisant le switch IP

Principe de fonctionnement

La tâche dans la box Homewizard est par exemple le déclenchement d’un capteur de présence connecté à la box HomeWizard. Cette tâche envoie une commande « Switch IP » utilisant l’API Jeedom. Cette commande API fait appel au scénario qui a son tour fait appel à l’équipement plugin SMS qui envoie in fine le SMS.

Il aurait été aussi possible d’utiliser seulement une commande API appelant l’équipement plugin SMS plutôt que le scénario.

Toutefois, l’utilisation du scénario est plus pratique. Le message du SMS est stocké dans le scénario lui-même plutôt que dans la commande API de l’équipement: C’est ainsi plus facile de modifier le contenu du message dans le scénario par la suite si nécessaire.

Mise en application

Créer un équipement avec le plugin SMS

En premier lieu, il faut installer le plug-in FreeSMS depuis le menu « Général/Plugin » de Jeedom:

Plugin FreeSMS

Et ensuite le menu Plugins/Communication/FreeSMS:

Plugin Free SMS

Cliquer sur ajouter (+):

Configuration du plugin Free SMS

Il s’agit de mettre un nom à l’équipement et ensuite de cliquer sur « Ajouter un utilisateur FreeSms ». Il y a 3 champs à remplir:

  •  Nom : nom  que vous souhaitez lui attribuer
  •  user : Identifiant à récupérer chez Free Mobile (C’est bien indiqué dans la documentation du plugin)
  • key : Clé d’identification affichée dans l’ espace abonné Free Mobile (C’est bien indiqué dans la documentation du plugin)

Une fois les 3 champs renseignés, un bouton « Tester » vous permet de tester la commande en recevant un SMS sur votre portable.

Avant de quitter l’interface du plugin, il faut bien penser à cliquer le bouton « Activer » Oui.

Remarque: Il y a d’autres champs utiles à renseigner mais non obligatoires.

Créer un scénario utilisant le plugin SMS

Supposons que nous ayons mis un capteur de présence dans la salle à manger et que nous souhaitions créer un scénario « presence_dans_la_salle » qui enverrait un message sms « Présence dans la salle » à l’équipement « Portable_Fabrice ».

Pour faire cela, il faut utiliser le menu Général/Scénarios et cliquer sur « Ajouter »:

Ajout d'un scénario

Choisir l’option « Avancée » et cliquer sur « D’accord »:

Créer un scénario

Il est à noter en haut à gauche l’ID du scénario qui sera nécessaire pour appeler le scénario par API (ID:10).

Il faudra donner un nom au scénario, ici « Presence_dans_la_salle » et cliquer sur « Ajouter Bloc » et choisir « Action » dans le menu déroulant:

4-Ajouter-element

cela donne:

3-Ajout-Action

Cliquez sur « Ajouter action »:

5-Selectionner-commande

Sélectionnez l’équipement plugin SMS appelé dans l’exemple « Portable_Fabrice » et cliquer sur « Valider »:

6-Parametrage-action

Renseignez le titre et le message de l’action.

Cliquer sur « Sauvegarder ».

A partir de ce moment, vous pouvez tester le scénario en cliquant sur le bouton « Exécuter » en haut. Si tout est bien paramétré, vous devriez recevoir le message de l’action par SMS, dans l’exemple « Présence dans la salle ».

Votre scénario est prêt. Il faut bien noter l’ID du scénario pour la commande API à créer dans la box, ici la box Homewizard.

Ecrire la commande API

La commande API utilisé est une commande http qui permet à n’importe quel objet connecté de pouvoir piloter Jeedom. Sa syntaxe est la suivante:

http://#IP_JEEDOM#/core/api/jeeApi.php?apikey=#APIKEY#&type=scenario&id=#ID#&action=#ACTION#

#IP_JEEDOM# correspond à votre url d’accès à Jeedom. Il s’agit (sauf si vous êtes connecté à votre réseau local) de l’adresse internet que vous utilisez pour accéder à Jeedom depuis l’extérieure.

#API_KEY# correspond à votre clé API, propre à votre installation. Pour la trouver il faut aller dans le menu « Général », puis « Administration » et « Configuration », en activant le mode Expert vous verrez alors une ligne Clef API.

#ID# correspond à l’id de votre scénario. L’ID se trouve sur la page des scénarios: Ici 10 dans notre exemple.

Exemple pour #IP_JEEDOM# 192.168.0.13,  #API_KEY# 12345678 et ID 10:

http://192.168.0.13/core/api/jeeApi.php?apikey=12345678&type=scenario&id=10#&action=Presence_salle

A ce stade, si vous tapez cette url dans votre navigateur sur votre ordinateur, Jeedom va envoyer un SMS que vous recevrez sur votre portable.

Le paramétrage coté Jeedom est terminé, il reste à paramétrer coté HomeWizard, l’action qui enverra la commande http sur Jeedom quand le capteur de présence connecté à la Box HomeWizard est déclenché.

 

Créer un objet « Switch IP » dans Homewizard

Pour créer le « switch IP », il faut utiliser le menu « Objets connectés » puis ajouter un périphérique et choisir « switchs et lights » puis switch IP:

switchIP

Donnez un identifiant (dans l’exemple sms-jdom-salle), choisir le type « http get » et dans url indiquez la commande API. Dans l’exemple c’est :

http://192.168.0.13/core/api/jeeApi.php?apikey=12345678&type=scenario&id=10#&action=Presence_salle

 

Créer une tâche utilisant le switch IP

Ensuite, il faut aller dans le menu « Tâches » puis cliquer sur « Créer une nouvelle tâche », puis périphérique:

Tache-SI

Sur le volet « Alors », choisir le Switch IP à paramétrer à ON:

Tache-Alors

La configuration est terminée.

N’hésitez pas à laisser un message si il y a un point d’incompréhension ou si j’ai pu oublier une information.

 

Une réflexion au sujet de « Homewizard: Comment envoyer des notification SMS avec Jeedom ? »

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée.