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 :

1. Soit en appelant ifttt_NomDuWebHook dans un trigger de IFTTT
2. 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) :

1. 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
2. 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 :

1. 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
2. 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 :

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

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

1. Soit en l'appelant depuis une autre applet avec : ifttt_pushover#Titre de ma notification#Contenu du message de ma notification
2. 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"})