Skip to content

Latest commit

 

History

History
37 lines (36 loc) · 4.99 KB

HomeKit Notifications with Make.md

File metadata and controls

37 lines (36 loc) · 4.99 KB
Raw

How to setup Make (Integromat) webhook notifications for HomeKit

Items required:

  • Account with Make (free) available to create at https://www.make.com
  • Integromat app (free) on the device in which you want to receive notifications - this is still the app Make is using right now, it may change to a Make app later
  • HomeKit home hub for the notifications to be triggered, but can still work in other situations as well

Setup Make Scenario & Link Device to Make Account

  1. While logged into Make.com, click / tap on the plus button to create a new scenario https://imgur.com/u5uU900
  2. Click / Tap the plus symbol in the new scenario to add items and search the list for webhook
  3. Select "Custom webhook"
  4. Now that the webhook item is available to receive traffic, we have to setup the webhook parameters.
  5. Tap / Click the add button in the webhook item's window that appeared
  6. Give the webhook some name you prefer i.e. My HomeKit Webhook)
  7. Tap / Click Save
  8. You will see that the webhook has been created and the URL is shown in the window as well as a copy address to clipboard button available (save this somewhere like a note so you can use it easily in your automations / shortcuts. We will get to that part soon.)
  9. Tap / Click OK
  10. Tap / Click the node on the right side to add another node to the scenario
  11. Search the list for iOS and select "Apple iOS"
  12. Select Send a Push Notification
  13. Now the iOS device needs to be added to your Make account
  14. Tap / Click the Add button
  15. Now would be the time to tap the App Store button to install Integromat unless you already have the app installed.
  16. Once in Integromat, make sure you login with the same account as you use on Make and go to the scanner to scan the QR code (or enter the code manually) to register your device to your account and provide a name for the device (this is a manually entered name that must match between the Integromat app and the Make scenario
  17. In the webhook "notification" advanced options, enable "Get request headers" and "JSON pass-through"
  18. If on Mobile device, you will need to collapse some of the option items to see the button to OK / Save the changes
  19. Now we can setup the data structure that the webhook will receive. Thanks to their easy process, we can do this quickly with a shortcut. I preferred to set it up with a form entry named "item" and then the value for "item" is what the notification displays. This allows for customized notifications to be sent easily.
    1. Using the webhook URL we copied earlier, we will now create a shortcut.
    2. Create a new shortcut and add a "Get Contents of URL" action using the webhook url as the address, the method needs to be set to "POST" and the Request Body set to "Form"
    3. Add a new field to the Request Body with the name of "item" and the value can be whatever message you like for this initial test (later, this will be the relevant message you want displayed)
    4. Going back to Make, you can tap / click the button in your webhook window to determine the data structure. After tapping / clicking that, it will wait for the data to be delivered
    5. In your shortcut, press the play button in and you should see the result say "Accepted"
    6. Looking back at Make, you should now see a "Successfully Determined" message, indicating that the webhook now knows your data structure
  20. In the Apple iOS mode of the scenario, we can now ensure the device name is selected and enter the information desired into the notification fields. You should see a red / maroon colored item named "item" because we made it learn the data we are sending. Tap / Click that when entering text into the Title of the notification
  21. Click OK and save the Scenario
  22. You can press the run button on the Scenario to test it and it will wait for data, you can use the shortcut again to see the notification delivered on your device
  23. The final step is to enable the Scenario so it will always be on. Tap / Click the toggle switch and you should be good to go. Any notifications you want to see, just need a Get Contents of URL action with the webhook URL added and the form data we used earlier. TIP: you can tap the upper left of the action used in the example shortcut and paste it into your HomeKit automations to make it easier