Tap Relay — Help

Tap Relay turns your Flic 2 Bluetooth button into a one-tap webhook trigger. Press the button, and the app instantly fires an HTTPS POST to the endpoint you configure. No hub needed — just your iPhone and a cell signal.

Getting Started

Get a Flic 2 Button

You'll need a Flic 2 Bluetooth button. Tap Relay does not work with the original Flic 1.

Scan Your QR Code

Your service provider or admin will give you a QR code containing your webhook configuration. Tap Scan QR on the dashboard to scan it. This sets up your webhook URL, credentials, and button pairing in one step.

Pair Your Button

After scanning, tap Pair Button. Press and hold your Flic button for 6 seconds until the LED blinks. The app will discover and connect to it.

Test It

Once connected, tap Send Test on the dashboard. You should see a delivery confirmation in the event log. You're all set.

Understanding the Dashboard

Connection Status

Connected — Button is paired and active
Searching — Looking for your button (stay within ~15 feet)
Disconnected — Button not found; tap Reconnect

Event Log

Shows your recent button presses with timestamps and delivery status. Each entry includes the click type (single, double, or hold) and whether the webhook was delivered successfully.

Click Types

Your Flic button supports three actions, each sent as a different event to your webhook:

Troubleshooting

Button won't pair

Make sure Bluetooth is enabled in iOS Settings
Hold the Flic button for 8+ seconds to factory reset it, then try again
Ensure the button isn't connected to another phone or the official Flic app
Stay within 3 feet during initial pairing

Webhook not delivering

Check that your URL starts with https://
Verify your auth token and client ID are correct in Settings
Make sure you have cellular or Wi-Fi connectivity
Try the Send Test button to isolate the issue
Check the event log — entries without a delivery timestamp indicate failed sends

Button disconnects frequently

Flic 2 range is ~60 feet in open air, less through walls
Keep your iPhone within reasonable range of the button
The app will auto-reconnect when the button comes back in range
Avoid force-quitting the app — it needs to run in the background for Bluetooth

App not responding in background

Do not force-quit Tap Relay from the app switcher
Disable Low Power Mode for best reliability
Go to iOS Settings > Tap Relay and ensure Bluetooth is allowed
The app uses Core Bluetooth State Restoration to persist connections even after iOS suspends it

How to clear my data

Go to Settings in the app and tap Clear All Data. This removes your webhook credentials from Keychain and deletes all event history. Your button will also be unpaired.

User Help

What is Tap Relay?