Skip to main content

How to Integrate Spottune Sensors with URL API Calls

Spottune Sensors is a feature within the Spottune Cloud, that enables external platforms to trigger predefined audio actions via API calls.

Updated over a month ago

Through URL calling, third-party systems such as POS platforms, building management tools, queue management, or digital signage can initiate actions in the audio environment β€” such as starting playlists, adjusting volume levels, or switching content zones β€” based on real-time events.

This guide will show you how to create a Sensor Action and integrate URL calling.

Step-by-Step Guide: Creating a Sensor Action

Step 1: Open Landing Page
Log in to your Spottune Cloud HQ account and go to the main dashboard.

Step 2: Go to Sensors
From the menu, select Sensors.
[Image: Spottune Cloud dashboard with "Sensors" highlighted.]

Step 3: Add Sensor
Click Add Sensor to register a new sensor in the system.
[Image: Cloud interface showing "Add Sensor" button.]

Step 4: Go to Routines
Navigate to the Routines section.
[Image: Menu with "Routines" highlighted.]

Step 5: Add Routine Group
Click Add Routine Group to create a new group for your routines.

Step 6: Add Sensor Routine
Expand the new group and click Add New Routine.

  • Select Add Sensor Trigger.

  • Choose the sensor from your list.

Step 7: Add Action
Expand the routine, then click Add Action.
Select the desired action (e.g., play playlist, adjust volume, switch zones).
[Image: Cloud interface showing routine creation with action options.]


Step-by-Step Guide: Integrating URL Calling

Step 1: Open Landing Page
Log in to your Spottune Cloud account.

Step 2: Go to Sensors
From the menu, select Sensors.

Step 3: Show API URL
Click Show API URL to display the unique integration link.

Step 4: Copy API URL
Copy the URL provided.
[Image: Example of a generated API URL in the Cloud interface.]

Step 5: Integrate API into External System
Paste and configure the copied API URL into the desired external tool (e.g., POS, signage, or building management).


⚠️ Important Note
Always test the integration in a safe environment before rolling it out to live customer setups, to ensure the triggers and actions behave as expected.

Did this answer your question?