diff --git a/source/_integrations/ifttt.markdown b/source/_integrations/ifttt.markdown index dd93693c497..f09114a7786 100644 --- a/source/_integrations/ifttt.markdown +++ b/source/_integrations/ifttt.markdown @@ -62,11 +62,7 @@ ifttt: ``` `key` is your API key which can be obtained by viewing the **Settings** of the [Webhooks applet](https://ifttt.com/services/maker_webhooks/settings). It's the last part of the URL (e.g., https://maker.ifttt.com/use/MYAPIKEY) you will find under **My Applets** > **Webhooks** > **Settings**. - -

- -Property screen of the Maker Channel -

+![Property screen of the Maker Channel.](/images/integrations/ifttt/finding_key.png) Once you have added your key to your `configuration.yaml` file, restart your Home Assistant instance. This will load up the IFTTT integration and make a service available to trigger events in IFTTT. @@ -88,18 +84,29 @@ ifttt: ### Testing your trigger -You can use **Developer Tools** to test your [Webhooks](https://ifttt.com/maker_webhooks) trigger. To do this, open the Home Assistant sidebar, click on Developer Tools, and then the **Services** tab. Fill in the following values: +You can use **Developer Tools** to test your [Webhooks](https://ifttt.com/maker_webhooks) trigger. To do this, open the Home Assistant sidebar, click on **Developer Tools** -> **Services** tab. Select `IFTTT: Trigger` as the service and fill in the following values: -Field | Value ------ | ----- -domain | `ifttt` -service | `trigger` -Service Data | `{"event": "EventName", "value1": "Hello World"}` +{% configuration_basic %} +event: + description: The name of the event to send. + required: true + type: string +value1: + description: Generic field to send data via the event. + required: false + type: string +value2: + description: Generic field to send data via the event. + required: false + type: string +value3: + description: Generic field to send data via the event. + required: false + type: string +{% endconfiguration_basic %} -

- When your screen looks like this, click the 'call service' button. -

+![Testing service.](/images/integrations/ifttt/testing_service.png) By default, the trigger is sent to all the API keys from `configuration.yaml`. If you want to send the trigger to a specific key use the `target` field: @@ -112,19 +119,22 @@ Service Data | `{"event": "EventName", "value1": "Hello World", "target": "YOUR_ The `target` field can contain a single key name or a list of key names. -### Setting up a recipe +### Setting up an applet -Press the *New applet* button and search for *Webhooks*. +Press the *Create* button and *Add* on **If This**. Search for *Webhooks*. +![Create applet.](/images/integrations/ifttt/create_applet.png) -

- -Choose "Webhooks" as service. -

+Choose *Webhooks* service. +![Choose "Webhooks" service.](/images/integrations/ifttt/setup_service.png) + +Select *Receive a web request*. +![Receive a web request.](/images/integrations/ifttt/choose_webhook_trigger.png) -

- You need to setup a unique trigger for each event you sent to IFTTT. -

+![You need to setup a unique trigger for each event you sent to IFTTT.](/images/integrations/ifttt/setup_trigger.png) + +Add the *Then That* action. The below example sends a notification to the IFTTT mobile app and adds `value1` to the message: +![Example notification "then that" action.](/images/integrations/ifttt/setup_then_that.png) {% raw %} diff --git a/source/images/integrations/ifttt/choose_webhook_trigger.png b/source/images/integrations/ifttt/choose_webhook_trigger.png new file mode 100644 index 00000000000..5c75d4e1c86 Binary files /dev/null and b/source/images/integrations/ifttt/choose_webhook_trigger.png differ diff --git a/source/images/integrations/ifttt/create_applet.png b/source/images/integrations/ifttt/create_applet.png new file mode 100644 index 00000000000..af220544a06 Binary files /dev/null and b/source/images/integrations/ifttt/create_applet.png differ diff --git a/source/images/integrations/ifttt/setup_then_that.png b/source/images/integrations/ifttt/setup_then_that.png new file mode 100644 index 00000000000..132e7e31f4b Binary files /dev/null and b/source/images/integrations/ifttt/setup_then_that.png differ diff --git a/source/images/integrations/ifttt/setup_trigger.png b/source/images/integrations/ifttt/setup_trigger.png index 12b4e42fe03..21c2e673a78 100644 Binary files a/source/images/integrations/ifttt/setup_trigger.png and b/source/images/integrations/ifttt/setup_trigger.png differ diff --git a/source/images/integrations/ifttt/testing_service.png b/source/images/integrations/ifttt/testing_service.png index fb8aa883859..5c49c29b35c 100644 Binary files a/source/images/integrations/ifttt/testing_service.png and b/source/images/integrations/ifttt/testing_service.png differ