How tile URLs work
The URL encoded in each tile always includes the tile’s unique ID:Registering your app for tile URLs
To make the phone launch your app when a tile is scanned or tapped, register your app to handle the tile domain using universal links (iOS) or deep links (Android). See this guide for how to set that up in Android and iOS. Nexudus already generates theapple-app-site-association and assetlinks.json files for the tiles domain, so you only need to configure your app’s identifiers with Nexudus:
The same values are available through the REST API under the
MobileApp.iOS.*, MobileApp.Android.*, and AutomationTiles.SharedSecret keys — see Get business settings.
Executing a tile action from your app
Once your app has the tile ID from the URL, it can trigger the tile’s configured action by calling the tile execution endpoint on your location’s domain.1. Get a bearer token for the customer
Use the Get a bearer token endpoint with the customer’s email and password:2. Call the tile execution endpoint
Pass the token in theAuthorization header:
Geofenced tiles
If a tile is geofenced, the request must include the customer’s location and a signature proving it came from your app:- latitude and longitude — the customer’s current position
- signature — the SHA256 hash of
{tileId}|{latitude}|{longitude}|{secret}, where{secret}is the automation tiles shared secret configured for the location
- Use the tile ID in lowercase. The tile URL shows the ID in uppercase, but the server signs with the lowercase form, so hashing the uppercase ID from the URL will fail.
- If you haven’t set a shared secret for the location, the server falls back to the customer’s account creation date as the secret, formatted as
yyyy-MM-ddTHH:mm:ss. Set an explicit shared secret so your app doesn’t have to look up each customer’s registration date.
Related pages
- Automation Tiles — how tiles behave in the Members Portal, including the execution endpoint
- Manage automation tiles — creating and configuring tiles in the dashboard
- White-label Passport setup — getting a branded app on the App Store and Google Play