Siri & Widgets

“Hey Siri, open the gate”

The TapHome control unit establishes a secure connection with its cloud server, allowing users to remotely control user-defined devices via URL requests in real time. This integration enables quick actions without the need to open the TapHome app or even unlock the phone (for example, via Siri).

Security Measures

Every web request must include a security token. This token prevents unauthorized access. It is important to:

• Never disclose this token on the internet.
• Never send it via unsecured communication channels.
• If you suspect it has been compromised, immediately change the security token.

Activating TapHome API on Core

To activate the TapHome API:

1. Open Settings on your TapHome Core.
2. Go to Publish Devices.
3. Add a new interface: TapHome API.
4. Define which devices you want to control in this way. Remember that anyone with your security token can control these devices.
5. Open a device from the list. Examples of URL requests for common actions will be displayed.
   • Example: Pressing a button to open the garage door: https://api.taphome.com/api/TapHomeApi/v1/setDeviceValue/5?token=abcdef01-2345-6789-0abc-def012345678&valueTypeId=52&value=1
6. Click the URL to copy it to the clipboard.

You can find more technical details about modifying the URL in the TapHome API documentation.

iOS: Siri Shortcuts

To set up a Siri shortcut:

1. Open (or install) the Shortcuts app from Apple.
2. Select Create Shortcut.
3. Choose Add Action.
4. In the first section, select Web.
5. Under Web Requests, select Get Contents of URL.
6. Paste the URL you copied from the TapHome app (Settings → Publish Devices → TapHome API) into the URL field.
7. Name the shortcut (for example, “Open the gate”).
8. Save it.
9. You can test the shortcut by pressing the play button in the bottom-right corner or by saying “Hey Siri,” followed by the name of your shortcut (for example, “Hey Siri, open the gate”).

Android: Custom Widgets

To create a custom widget on Android:

1. Download a third-party app that supports sending HTTP requests, such as HTTP Request Shortcuts.
2. In the app, create a New Shortcut.
3. Set its name and choose an icon.
4. In the Basic Request Settings, select the GET method and paste the URL copied from the TapHome app.
5. (Optional) You can change Response Handling to Toast Response (errors only) for clearer feedback.
6. In the context menu, select Place on Home Screen.
7. Your new shortcut will now appear on your phone’s home screen.