{"id":174,"date":"2017-05-01T22:35:07","date_gmt":"2017-05-01T20:35:07","guid":{"rendered":"http:\/\/les3zam.info\/cabrablog\/?p=174"},"modified":"2018-01-16T21:57:09","modified_gmt":"2018-01-16T19:57:09","slug":"utilisation-dune-dune-api-web-denvoi-de-sms-depuis-jeedom","status":"publish","type":"post","link":"http:\/\/cabrastudio.eu\/cabrablog\/?p=174","title":{"rendered":"Utilisation d&rsquo;une API Web d&rsquo;envoi de SMS depuis Jeedom"},"content":{"rendered":"<p>J&rsquo;ai cherch\u00e9 une solution simple pour envoyer des SMS d&rsquo;alerte ou d&rsquo;info depuis Jeedom. Il y a d\u00e9j\u00e0 pas mal de solutions propos\u00e9es soit via un compte Free soit via GSM ( cl\u00e9 3G, Modem, T\u00e9l\u00e9phone ). Comme je n&rsquo;ai rien de tout cela j&rsquo;ai cherch\u00e9 un service web d&rsquo;envoi de SMS simple \u00e0 coupler avec Jeedom et avec un tarif acceptable.<\/p>\n<p>J&rsquo;ai essay\u00e9\u00a0une 5 ou 6\u00a0services de ce type. Puis j&rsquo;ai r\u00e9duit ma liste \u00e0\u00a0trois (messageBird, nexmo, OVHTelecom) que j&rsquo;ai vraiment\u00a0utilis\u00e9 avec\u00a0Jeedom. En final\u00a0j&rsquo;ai\u00a0gard\u00e9 OVHTelecom SMS.<\/p>\n<p>OVH avait pour moi le bon compromis, prix \/ API.<\/p>\n<p>Cot\u00e9 tarif : OVH n&rsquo;est pas le mois cher mais ils ont un pack de 100 SMS pour 8\u20ac40. Mon objectif est d&rsquo;envoyer des alarmes qui je l&rsquo;esp\u00e8re ne se d\u00e9clencheront jamais. J&rsquo;ai pr\u00e9vu d&rsquo;envoyer un SMS de test par semaine pour \u00eatre certain que la fonction est toujours active donc avec 100 SMS le tiens 18 mois. C&rsquo;est donc moins qu&rsquo;un abonnement \u00e0 2\u20ac. Les autres service sont un peu moins chers mais les pack sont beaucoup plus gros donc il faut investir plus des ann\u00e9es.<\/p>\n<p>Autre avantage pour moi d&rsquo;OVH c&rsquo;est que c&rsquo;est en France et que je l&rsquo;utilise d\u00e9j\u00e0 pour d&rsquo;autres services.<\/p>\n<p>L&rsquo; API d&rsquo;OVH est simple \u00e0 utiliser mais la configuration du compte un peu longue &#8230; je l&rsquo;ai d\u00e9taill\u00e9 ici.<\/p>\n<p>&nbsp;<\/p>\n<h2>Configuration d&rsquo;un compte OVH pour SMS<\/h2>\n<p>D&rsquo;abord ouvrir un compte sur\u00a0<a href=\"https:\/\/www.ovhtelecom.fr\/sms\/\">https:\/\/www.ovhtelecom.fr\/sms<\/a><\/p>\n<p>Pour envoyer des SMS avec API vous avez besoin de\u00a0:<\/p>\n<ul>\n<li>N\u00b0 de compte OVH SMS<\/li>\n<li>Nom d&rsquo;utilisateur \u00a0API<\/li>\n<li>mot de passe de l&rsquo;utilisateur API<\/li>\n<li>nom expediteur<\/li>\n<\/ul>\n<p>\u00ab\u00a0<strong>N\u00b0 de compte OVH SMS<\/strong>\u00a0\u00bb \u00a0c&rsquo;est ici sur la page d&rsquo;accueil en haut et sur la gauche dans le menu:<\/p>\n<p><a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Compte-e1493665338621.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-178\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Compte-300x211.png\" alt=\"\" width=\"300\" height=\"211\" \/><\/a><\/p>\n<p><strong>Nom d&rsquo;utilisateur API et son mot de passe<\/strong>, il faut le cr\u00e9er via le menu utilisateurs API (cercle vert) puis sur Action \/ Ajouter \u00a0vous donner un nom et un mot de passe:<\/p>\n<p><a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-179\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI-1024x378.png\" alt=\"\" width=\"640\" height=\"236\" srcset=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI-1024x378.png 1024w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI-300x111.png 300w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI-768x284.png 768w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/CompteAPI.png 1039w\" sizes=\"(max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<p>Ensuite <strong>Exp\u00e9diteur<\/strong>, il y a un par d\u00e9faut cr\u00e9\u00e9 avec le compte mais vous pouvez en cr\u00e9er plusieurs autres. Par contre il faut plusieurs heures\/jours pour qu&rsquo;ils soient valid\u00e9s donc utilisable ( \u00a0status = &lsquo;Activ\u00e9&rsquo; ):<a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Expediteur.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-180\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Expediteur.png\" alt=\"\" width=\"788\" height=\"295\" srcset=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Expediteur.png 788w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Expediteur-300x112.png 300w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Expediteur-768x288.png 768w\" sizes=\"(max-width: 788px) 100vw, 788px\" \/><\/a><\/p>\n<p>Voila vous avez tout ce qu&rsquo;il faut pour envoyer un SMS depuis Jeedom.<\/p>\n<p>Example : Alert lorsque la temp\u00e9rature de mon cong\u00e9lateur remonte au dessus de -10<\/p>\n<ul>\n<li>N\u00b0 de compte OVH SMS \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 = <strong>sms-JB007-7<\/strong><\/li>\n<li>Nom d&rsquo;utilisateur \u00a0API \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0= \u00a0<strong>jeedomAPI<\/strong><\/li>\n<li>mot de passe de l&rsquo;utilisateur API \u00a0 \u00a0 \u00a0 \u00a0= <strong>PASSXXXXXX<\/strong><\/li>\n<li>nom exp\u00e9diteur \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0= <strong>jeedom<\/strong><\/li>\n<li>t\u00e9l\u00e9phone du destinataire \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0= 0607007007 donc format international =\u00a0<strong>0033607007007<\/strong><\/li>\n<li>Titre SMS \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0= <strong>Alert-Jeedom<\/strong><\/li>\n<li>Message \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 = <strong>Temp.\u00a0congel = -9.8<\/strong><\/li>\n<\/ul>\n<p>L&rsquo;URL aura cette forme :<\/p>\n<hr \/>\n<p>https:\/\/www.ovh.com\/cgi-bin\/sms\/http2sms.cgi?&amp;account=<strong>sms-JB007-7<\/strong>&amp;login=<strong>jeedomAPI<\/strong>&amp;password=<strong>PASSXXXXXX<\/strong>&amp;from=<strong>jeedom<\/strong>&amp;to=<strong>0033607007007<\/strong>&amp;contentType=text\/xml&amp;message=%22<strong>Alert-Jeedom<\/strong>%0d<strong>Temp.\u00a0congel = -9.8<\/strong>%22<strong>&amp;noStop=1<\/strong><\/p>\n<hr \/>\n<p><strong>%22<\/strong>\u00a0: correspondent aux caract\u00e8re \u00a0\u00bb<\/p>\n<p><strong>%0d<\/strong>\u00a0: correspond \u00e0 un saut de ligne<\/p>\n<p><strong>noStop=1 \u00a0\u00a0<\/strong>tr\u00e8s\u00a0important force\u00a0l&rsquo;envoi\u00a0imm\u00e9diat, quelque soir heure. Ces API sont\u00a0souvent utilis\u00e9es pour envoyer des messages marketing qui ne peuvent pas \u00eatre envoy\u00e9s le soir et la nuit.<\/p>\n<h2>Utilisation de l&rsquo;API SMS OVH dans <a href=\"http:\/\/www.jeedom.com\">Jeedom<\/a><\/h2>\n<p>J&rsquo;ai utilis\u00e9 le plugins Script de Jeedom pour appeler API d&rsquo;OVH. ce plugins officiel permet d&rsquo;appeler des scripts Python\/Shell\/PHP\/.. mais aussi des appels\u00a0HTTP. Si ce n&rsquo;est pas fait il vous faudra donc installer le plugins Script depuis le Market puis l&rsquo;activ\u00e9. Depuis le plugins qui est disponible dans le groupe programmation il faut \u00ab\u00a0Cr\u00e9er un commande script\u00a0\u00bb comme ceci :<\/p>\n<p>&nbsp;<\/p>\n<p><a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-188 size-full\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1.png\" alt=\"\" width=\"1327\" height=\"218\" srcset=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1.png 1327w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1-300x49.png 300w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1-768x126.png 768w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/ScriptJeedom-1-1024x168.png 1024w\" sizes=\"(max-width: 1327px) 100vw, 1327px\" \/><\/a><\/p>\n<p>type Script \u00a0<strong>HTTP \u00a0<\/strong>type :<strong> Action <\/strong>avec<strong> Message.\u00a0<span style=\"color: #ff0000;\">T<\/span><\/strong><b><span style=\"color: #ff0000;\">r\u00e8s important<\/span> le timeout doit\u00a0\u00eatre \u00e0 5 secondes mini <\/b>et la\u00a0r\u00e9p\u00e9tition \u00e0 2.<b> <\/b>Par d\u00e9faut le timeout est de deux secondes ce qui est trop\u00a0court dans\u00a0certain cas pour l&rsquo;API d&rsquo;OVH. Si le timeout est atteint sans que l&rsquo;API est r\u00e9pondue Jeedom va r\u00e9essayer l&rsquo;envoi, r\u00e9sultat vous aller recevoir plusieurs SMS pour rien. Avec 5s je n&rsquo;ai jamais plus eu\u00a0de probl\u00e8me.<\/p>\n<p>Les scripts action avec message re\u00e7oivent deux valeurs le <strong>#title#<\/strong> et le #<strong>message<\/strong>#.<\/p>\n<p>Donc l&rsquo;URL devient :<\/p>\n<hr \/>\n<p>https:\/\/www.ovh.com\/cgi-bin\/sms\/http2sms.cgi?&amp;account=<strong>sms-JB007-7<\/strong>&amp;login=<strong>jeedomAPI<\/strong>&amp;password=<strong>PASSXXXXXX<\/strong>&amp;from=<strong>jeedom<\/strong>&amp;to=<strong>0033607007007<\/strong>&amp;contentType=text\/xml&amp;message=<span style=\"color: #993300;\"><strong>#title#<\/strong><\/span>%0d<strong><span style=\"color: #993300;\">#message#<\/span>&amp;noStop=1<\/strong><\/p>\n<hr \/>\n<p>Dans un \u00e9cran Jeedom cela donne ceci :<\/p>\n<p><a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/SendSMS.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-185\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/SendSMS.png\" alt=\"\" width=\"392\" height=\"245\" srcset=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/SendSMS.png 392w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/SendSMS-300x188.png 300w\" sizes=\"(max-width: 392px) 100vw, 392px\" \/><\/a><\/p>\n<p>Vous pouvez faire le test saisir un titre et un message et faire vous devez recevoir le SMS dans les secondes qui suivent. Vous pouvez voir sur le tableau de suivie d&rsquo;OVH si le message est bien partie, Menu SMS puis Historique des envoi.\u00a0Si vous n&rsquo;avez pas mis le noStop=1 votre SMS va\u00a0apparaitre dans les SMS planifi\u00e9s.<\/p>\n<p>&nbsp;<\/p>\n<h2>Envoi d&rsquo;un SMS depuis un sc\u00e9nario JEEDOM<\/h2>\n<p>Rien de sp\u00e9cial il suffit d&rsquo;appeler votre commande depuis une action du sc\u00e9nario :<\/p>\n<p><a href=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-186\" src=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario.png\" alt=\"\" width=\"1207\" height=\"741\" srcset=\"http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario.png 1207w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario-300x184.png 300w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario-768x471.png 768w, http:\/\/cabrastudio.eu\/cabrablog\/wp-content\/uploads\/2017\/05\/Scenario-1024x629.png 1024w\" sizes=\"(max-width: 1207px) 100vw, 1207px\" \/><\/a><\/p>\n<p>Voila une premi\u00e8re utilisateur de l&rsquo;API SMS OVH dans Jeedom. Comme je l&rsquo;ai expliqu\u00e9 au d\u00e9but de l&rsquo;article j&rsquo;ai fait les m\u00eames tests ave nexmo et messageBird j&rsquo;ai encore les URL compatibles Jeedom pour ceux qui seraient int\u00e9ress\u00e9.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>J&rsquo;ai cherch\u00e9 une solution simple pour envoyer des SMS d&rsquo;alerte ou d&rsquo;info depuis Jeedom. Il y a d\u00e9j\u00e0 pas mal de solutions propos\u00e9es soit via un compte Free soit via GSM ( cl\u00e9 3G, Modem, T\u00e9l\u00e9phone ). Comme je n&rsquo;ai&hellip; <a href=\"http:\/\/cabrastudio.eu\/cabrablog\/?p=174\" class=\"more-link\">Continuer la lecture <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[13,16],"tags":[],"_links":{"self":[{"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/posts\/174"}],"collection":[{"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=174"}],"version-history":[{"count":12,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/posts\/174\/revisions"}],"predecessor-version":[{"id":262,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=\/wp\/v2\/posts\/174\/revisions\/262"}],"wp:attachment":[{"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=174"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=174"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/cabrastudio.eu\/cabrablog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=174"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}