assistant-ifttt

assistant-ifttt

Ce plugin de assistant-plugins permet d'enclencher une action WebHooks sur IFTTT.

Installation

Si vous n'avez pas installé assistant-plugins, alors il faut le faire, et sélectionner ifttt comme plugin.

Si vous avez déjà installé assistant-plugins, et que vous souhaitez ajouter ce plugin, alors :

• Pour Windows, télécharger install_ifttt.bat dans le répertoire assistant-plugins, puis l'exécuter en double-cliquant dessus.
• Pour Linux/MacOS, ouvrir une console dans le répertoire assistant-plugins et taper :
  npm install assistant-ifttt@latest --save --loglevel error && npm run-script postinstall

Configuration

Se rendre dans le maker WebHooks de IFTTT et le configurer. Une clé (key) vous sera alors donnée (qui ressemble à dph-Wyhz1Zxlw89WZchMAV).

Éditer le fichier configuration.json du répertoire assistant-plugins afin d'y mettre la clé dans la section concernant le plugin ifttt. Exemple :

{
  ...
  {
    "plugins": {
      "ifttt": {
        "key":"dph-Wyhz1Zxlw89WZchMAV"
      }
    }
  }
}

Utilisation

Vous pouvez relier des plugins ensembles en déclenchant des actions sur IFTTT.

Deux façons de l'utiliser :

• Soit en appelant ifttt_NomDuWebHook dans un trigger de IFTTT
• Soit en l'appelant depuis un autre plugin avec this.plugins.ifttt.action("NomDuWebHook")

Il est également possible de passer 3 paramètres (comme indiqué sur https://ifttt.com/maker_webhooks puis bouton Documentation) :

• Soit en utilisant le mot clé # dans l'appel. Par exemple : ifttt_NomDuWebHook#Param 1#Mon Param 2#Mon 3ème param dans un trigger de IFTTT
• Soit en l'appelant depuis un autre plugin avec this.plugins.ifttt.action("NomDuWebHook", {value1:"Param 1", value2:"Mon Param 2", value3:"Mon 3ème Param"})

Exemples

Un exemple concret sera plus parlant. Supposons qu'on veuille dire OK Google, éteins toutes les lumières dans X minutes.

On procédera ainsi :

• Création d'un applet WebHooks IFTTT qui se déclenche sur la commande AllLightsOff et qui va se connecter à Philipps Hue pour éteindre toutes les lampes
• Création d'un applet Google Assistant (Say a phrase with both a number and a text ingredient) avec la phrase de déclenchement : "éteins toutes les lumières dans # $"
  Cet applet enverra à Pushbullet une note avec le titre "Assistant" et le message : wait_\{\{NumberField\}\} \{\{TextField\}\}|ifttt_AllLightsOff

Si on décortique la commande envoyée à Pushbullet :

• wait_\{\{NumberField\}\} \{\{TextField\}\} → cela déclenche le plugin assistant-wait qui permet de mettre un timer de NumberField TextField (par exemple "3 minutes")
• | → le pipe permet de distinguer les différentes commandes
• ifttt_AllLightsOff → cela déclenche le plugin assistant-ifttt qui va mettre en route le WebHook AllLightsOff créé à l'étape 1 et donc éteindre toutes les lumières

Un autre exemple, pour s'envoyer une notification via le service PushOver on va créer un WebHook IFTTT :

• Nom du Webhook : pushover
• Il va enclencher une action PushOver de type Pushover Notification
• Dans Title on met Value1 en cliquant sur Add Ingredient
• Dans Message on met Value2 en cliquant sur Add Ingredient

Maintenant, deux façons de déclencher une notification PushOver :

• Soit en l'appelant depuis une autre applet avec : ifttt_pushover#Titre de ma notification#Contenu du message de ma notification
• Soit en l'appelant depuis un autre plugin avec : this.plugins.ifttt.action("pushover", {value1:"Titre de ma notification", "value2":"Contenu du message de ma notification"})