Spottune Cloud · Sensores y API
Sensores y llamadas URL (API): automatiza el audio desde otros sistemas
Un sensor es un disparador que otro sistema activa por internet con una simple URL: cuando pasa algo en su negocio, Spottune responde con una acción de audio. Unos 6 minutos en Cloud HQ; la conexión del otro sistema la hace su proveedor de software.
Los Sensores son una función de Spottune Cloud que permite a sistemas externos disparar acciones de audio predefinidas mediante llamadas a una URL (API). Así el sistema de sonido deja de ser una isla y reacciona a lo que ocurre en el negocio en tiempo real. El fabricante menciona estos casos: la caja o punto de venta (POS), la gestión del edificio (BMS o domótica), los sistemas de turnos o filas, la señalización digital y botones inteligentes. Ejemplos de uso: subir la música cuando aumenta el flujo de personas, bajar el volumen durante una llamada, sincronizar el sonido con lo que muestran las pantallas o lanzar un aviso cuando el sistema de turnos llama a un cliente.
Funciona en tres piezas: el sensor (el disparador, creado en Cloud HQ), una rutina con disparador de tipo sensor (qué acción ocurre y en qué zona) y la URL de API que Cloud HQ le entrega y que el sistema externo llama cada vez que ocurre el evento.
Parte A: crear el sensor y la rutina que dispara
Se hace en Cloud HQ, una vez por cada evento que quiera automatizar.
Ingrese a Cloud HQ
Entre a cloud.spottune.io con su usuario y contraseña. Se abre la página principal con el menú de la cuenta.
Abra Sensors
En el menú, haga clic en Sensors. Verá los sensores ya creados en la cuenta (o una lista vacía).
Cree el sensor
Haga clic en Add Sensor y registra el nuevo sensor. Póngale un nombre que diga qué evento representa, por ejemplo «POS caja 1 – venta» o «Turnero – llamada». El sensor aparece en la lista.
Ve a Routines
Haga clic en Routines. Verá los grupos de rutinas de la cuenta.
Cree o elija un grupo de rutinas
Haga clic en Add Routine Group, escriba un nombre (por ejemplo «Sensores – Laureles») y confirma. También puede usar un grupo que ya exista. Haga clic sobre el grupo para expandirlo.
Agregue una rutina con disparador de sensor
Con el grupo expandido, haga clic en Add New Routine. Como disparador elige Add Sensor Trigger y seleccione en la lista el sensor que creó en el paso 3. Confirme. La rutina aparece dentro del grupo.
Agregue la acción
Haga clic sobre la rutina para expandirla y luego en Add Action. Elija en la lista lo que debe pasar cuando el sensor se dispare (por ejemplo, iniciar una playlist, cambiar el volumen, reproducir un anuncio o cambiar el contenido de una zona) y la zona: Zona 1, Zona 2 o ambas. Confirme. Una rutina admite varias acciones.
Asigne el grupo al Stream de la sede
Ve a Locations, haga clic en la rueda de ajustes del Stream, entre a Manage Routines, marque el grupo y guarde con SAVE CHANGES. El grupo aparece en la columna Routines junto al Stream (recargue la página si no lo ve). Sin este paso la rutina no se ejecuta en esa sede.
Parte B: obtener la URL de API e integrarla
La URL es el «botón» que el sistema externo pulsa. Cloud HQ la genera; usted la copia y se la entrega a quien administra ese sistema.
Abra Sensors
En Cloud HQ, haga clic en Sensors en el menú.
Muestra la URL de API
Haga clic en Show API URL. Cloud HQ muestra el enlace único de integración de su sensor.
Copia la URL
Copia la URL completa (botón de copiar o seleccionándola). Guárdela en un lugar seguro: esa URL identifica su cuenta y su sensor.
Entrégala al sistema externo
Pásase la URL a quien administra el POS, el sistema de turnos, la domótica o las pantallas, para que la configure como la llamada que se hace cada vez que ocurre el evento (por ejemplo, al cerrar una venta o al llamar un turno). En la sección siguiente hay un ejemplo genérico de esa llamada.
Pruebe en un entorno seguro antes de usarla con clientes
Es la recomendación expresa del fabricante: dispara la URL fuera del horario de atención o con una acción inofensiva (un pequeño cambio de volumen) y confirme que la rutina responde como espera. Solo entonces conéctela al evento real.
Ejemplo de llamada desde el sistema externo
El sistema externo solo tiene que abrir la URL (una petición HTTP) cada vez que ocurra el evento. Este ejemplo es genérico y use un marcador en lugar de la URL real; reemplázalo por la URL que copiaste en Cloud HQ.
curl "https://LA-URL-QUE-COPIASTE-EN-CLOUD-HQ"
La documentación oficial no detalla el método HTTP ni parámetros adicionales de la URL. Si su integrador necesita confirmarlos, escríbanos por WhatsApp y lo consultamos con el fabricante.
Cómo verificar
- En Sensors aparece su sensor; en Routines, la rutina con disparador de sensor tiene al menos una acción; en Locations, la columna Routines del Stream muestra el grupo.
- Abra la URL de API desde el navegador de un computador (en horario de prueba): la acción debe ocurrir en la sede. Si ocurre, la integración solo depende de que el sistema externo llame esa misma URL.
- Pídale al administrador del sistema externo que dispare el evento real una vez y confirme en el local el resultado.
Guía oficial en PDF
La guía del fabricante con capturas de cada pantalla de Cloud HQ: creación del sensor, rutina, acción y obtención de la URL (en inglés).
Si algo falla
- Llamo la URL y no pasa nada
- Revise en este orden: (1) la URL se copió completa, sin espacios ni cortes; (2) el sensor tiene una rutina con disparador de sensor y esa rutina tiene al menos una acción; (3) el grupo de rutinas está asignado al Stream de la sede (columna Routines en Locations); (4) el Stream está en línea (El Stream aparece fuera de línea en Cloud HQ); (5) el contenido existe: la playlist tiene canciones o el anuncio terminó de subir.
- La acción ocurre, pero en la zona equivocada
- Edita la acción de la rutina y cambia la zona (1, 2 o ambas). Si los altavoces del área no están en la zona que cree: Ajustar volumen por altavoz y cambiar zonas desde Cloud HQ.
- Necesito varios eventos distintos
- Cree un sensor por evento, cada uno con su propia rutina y su propia URL: por ejemplo, uno para «venta cerrada» y otro para «turno llamado». Puede agruparlos en un mismo grupo de rutinas.
- ¿Quién puede ver o usar la URL?
- Cualquiera que la tenga puede disparar la acción, así que compártala solo con el integrador y no la publiques. Si cree que se filtró, escríbanos y revisamos con usted cómo proceder con el fabricante.
- Mi proveedor de POS o turnos pregunta por método, parámetros o respuesta de la API
- La guía oficial solo describe la URL de integración. Escríbanos con la pregunta exacta y la consultamos con Spottune.
- Quiero que la rutina se dispare a una hora, no por un evento
- Use el disparador Time of Day en lugar del sensor: Crear rutinas: horarios, volumen y anuncios automáticos.