Conectar tu sistema a las pantallas
Tu sistema expone los datos en una URL y Tenelo los lee, o tu sistema se los envía a Tenelo. En los dos casos se muestran en la zona de la pantalla que elijas, con el resto del espacio para lo que quieras comunicar.
Turnos, reservas, precios, stock, indicadores: si ya viven en un sistema, no hay que volver a cargarlos. Esta página dice exactamente qué forma tienen que tener los datos, cuál de las dos formas de conectar te conviene, cómo queda en pantalla y qué no está disponible todavía, para que lo evalúes antes de escribirnos.
¿Quién es el dueño de la pantalla?
Hay dos formas de integrar dos sistemas en una misma pantalla, y hoy Tenelo hace una.
Tenelo maneja la pantalla y tu sistema aporta los datos
Es la integración que existe hoy y la que resuelve la mayoría de los casos. El reproductor de Tenelo toma la salida de video completa del equipo; tu sistema no tiene que dibujar nada, sólo responder una URL con los datos. Vos decidís en qué parte de la pantalla se muestran y qué ocupa el resto.
Tu sistema maneja la pantalla y Tenelo dibuja adentro de un recuadro
Hoy no. No hay un modo "widget" ni una URL para incrustar el contenido de Tenelo dentro de otra aplicación. Si tu sistema ya es dueño de la pantalla, la opción es darle a Tenelo una pantalla propia, o invertir los roles: que tu sistema exponga sus datos y Tenelo se ocupe de toda la salida.
Tenelo lee tus datos, o tu sistema se los manda
Elegís una por cada fuente. Podés cambiar después sin rehacer la pantalla: la grilla es la misma.
Tu sistema expone una URL y Tenelo la lee
Publicás los datos en una dirección (una API, un archivo JSON o CSV, un feed) y Tenelo la consulta cada pocos segundos. Es la opción natural si ya tenés una API pública o un servicio en la nube.
CUÁNDO CONVIENE• Ya tenés una API o un feed accesible desde internet
• Los datos cambian poco o a intervalos regulares
• No querés programar nada del lado de tu sistema
La URL puede pedir autenticación: Bearer, API key o usuario y contraseña. La credencial queda en tu cuenta; las pantallas nunca la reciben.
Tu sistema le envía los datos a Tenelo (webhook)
Tenelo te da una URL y un token. Cada vez que cambia algo, tu sistema hace un POST con la lista de registros, y las pantallas muestran lo último que llegó. Tu sistema no tiene que estar expuesto a internet: la conexión sale desde tu red.
CUÁNDO CONVIENE• Tu sistema está en una red interna, sin URL pública
• Los cambios son eventos: se llamó un turno, se vendió algo
• Preferís mandar sólo cuando hay novedad
Se acepta la lista pelada o adentro de un objeto, y un nivel de anidado se acomoda solo. Si tu sistema deja de enviar, las pantallas siguen mostrando lo último recibido.
Así se ve un envío por webhook
curl -X POST https://tenelo.app/api/v1/webhooks/<id>/datos \
-H "Authorization: Bearer whw_…" \
-H "Content-Type: application/json" \
-d '[{"turno":"A-102","box":"Box 1","estado":"Llamando"}]'La URL y el token los da el panel al crear el webhook, con este mismo ejemplo listo para copiar. Tenelo responde cuántos registros entendió, o el motivo si algo no sirve.Una lista de registros planos
Es todo el contrato, y vale para las dos formas: lo que tu sistema publica en la URL, o lo que envía por webhook.
1
Una lista de registros
Por URL: JSON, CSV, XML, RSS o Atom, con la lista en la raíz del JSON. Por webhook: JSON, con la lista pelada o adentro de un objeto —Tenelo la encuentra sola.
2
Registros planos
Cada registro es un objeto con campos de texto o número. Por URL, Tenelo lee sólo el primer nivel. Por webhook, un objeto anidado se abre un nivel (detalle.box pasa a detalle_box); las listas anidadas se descartan.
3
Credenciales en su lugar
Por URL: sin autenticación, Bearer, API key o usuario y contraseña, guardadas en tu cuenta. Por webhook: un token de escritura que va en tu sistema y otro de lectura que va en el elemento. Las pantallas nunca reciben ninguno.
4
Cada cuánto llega a la pantalla
En modo "en vivo", desde cada 5 segundos: el servidor relee la fuente —tu URL o lo último que llegó por webhook— una vez por intervalo para todas las pantallas, y todas muestran lo mismo. Para datos que cambian poco, también se programa por horarios.
Así se ve una fuente que sirve
Un turnero con tres puestos. Cada registro es un puesto; los nombres de los campos los elegís vos y después indicás cuál va como título, cuál como descripción y cuál como dato extra.
[
{ "turno": "A-102", "box": "Box 1", "estado": "Llamando" },
{ "turno": "A-099", "box": "Box 2", "estado": "En atención" },
{ "turno": "—", "box": "Box 3", "estado": "Libre" }
]Así se ve una que no
La lista está adentro de un objeto y cada puesto tiene el estado anidado. Tenelo mostraría una sola fila, con el campo puestos como texto. Se resuelve del lado del sistema: devolver la lista pelada, con los campos al primer nivel.
{
"ok": true,
"puestos": [
{ "turno": "A-102", "detalle": { "box": 1, "estado": 2 } }
]
}Probalo con una fuente de verdad
Esta URL es un turnero simulado que corre en nuestros servidores y cambia solo cada 30 segundos. Abrila en el navegador para ver la forma exacta, o usala como fuente en tu cuenta para armar el elemento antes de tener tu sistema conectado. En el panel hay otras fuentes de ejemplo (clases de gimnasio, productos, propiedades, eventos), y cualquier URL pública que devuelva una lista sirve igual.
https://tenelo.app/ds/v1/turnero?cada=30&boxes=6Los datos son inventados y no se guardan. Sirve para probar; no la uses en una pantalla real.
Tus datos en una zona, tu comunicación en el resto
El ejemplo es un turnero que comparte la pantalla con institucionales y publicidad, pero vale para cualquier sistema: una cola de pedidos, el stock de un depósito, cotizaciones, indicadores de una planta. El sistema sigue siendo el tuyo: Tenelo lo muestra, no lo reemplaza.
Secuencia · rota sola
Institucionales y publicidad
Imágenes, videos y piezas del editor, en el orden y la duración que definas.
Zona fija · en vivo
A-102
Box 1
Llamando
A-099
Box 2
En atención
A-101
Box 3
En atención
—
Box 4
Libre
Los turnos se leen de tu sistema cada 30 segundos; la izquierda rota como cualquier canal.
Elegís la zona
El elemento se ubica en un rectángulo de la pantalla, en porcentaje del lienzo: mitad derecha, tercio de abajo, la medida que necesites. El resto queda libre.
Fijo o en la secuencia
Fijo, se dibuja permanente encima del canal —el caso de los turnos—. En la secuencia, ocupa un turno como cualquier otra pieza —el caso de una lista de precios que aparece cada tanto.
Diseñás la grilla
Qué campo va como título, cuál como descripción, cuál como dato extra; columnas, cuántos registros por vista, tipografía, colores, fondo transparente o no. Sin escribir código.
Y el resto es un canal normal
Publicidad, institucionales, video, YouTube, piezas del editor: la misma secuencia que en cualquier canal, y las mismas pantallas ilimitadas por canal.
Lo que hoy no hay
Preferimos que lo leas acá y no que lo descubras con la pantalla instalada.
Conexión directa a bases de datos
Tenelo no se conecta a MySQL, PostgreSQL, SQL Server ni MongoDB. Lee una URL o recibe un webhook. Si tus datos están en una base, tu sistema —o un servicio chico delante de la base— tiene que exponerlos o enviarlos como se describe arriba.
Actualización instantánea en la pantalla
Aun por webhook, la pantalla se actualiza en el intervalo configurado —desde 5 segundos—, no en el instante en que tu sistema envía. Es lo que hace que todas las pantallas muestren lo mismo a la vez.
Sonido de llamado
No hay un "ding" ni una locución cuando cambia un turno. Si el llamado sonoro es parte del circuito, hoy lo tiene que dar tu sistema.
Incrustar Tenelo en otra aplicación
No hay modo widget ni URL para poner el contenido de Tenelo en un recuadro de otro software. Tenelo es dueño de la salida de video donde corre.
API pública para administrar canales
Crear canales, cambiar la secuencia o encender pantallas desde otro sistema no está disponible como API documentada. Se opera desde el panel.
Veinte minutos, sin hablar con nadie
Si tu sistema devuelve la lista, esto es todo lo que hace falta para verlo en una pantalla.
Activá el plan Gratis
Sin tarjeta. Alcanza para armar el canal y verlo en una pantalla.
Creá un contenido dinámico con tu fuente
Contenido dinámico → Fuente de datos → "Desde URL" o "Webhook". Por URL, pegá la de tu sistema o la del turnero de prueba de esta página. Por webhook, creá uno: el panel te da la URL y el token, y podés diseñar antes de conectar tu sistema, con filas de ejemplo tomadas de tu propia API, de un servicio de ejemplo o pegadas, y mandar envíos de prueba por el camino real.
Mapeá y diseñá
Indicá qué campo es el título, cuál la descripción y cuál el dato extra. Elegí columnas, registros por vista y estilo. Marcá "en vivo" y el intervalo.
Ubicalo en un canal
Agregalo al canal como elemento fijo, definí la zona, y cargá en la secuencia lo que va en el resto de la pantalla.
Vinculá una pantalla
Instalá el reproductor, escaneá el QR y mirá cómo se actualiza.
Tres cosas de los términos que aplican acá
Resumidas. El texto que vale es el de los términos y condiciones.
Podés integrar pantallas de tus clientes desde tu cuenta
Un integrador o una agencia puede operar la plataforma para pantallas de terceros. La relación con esos clientes es tuya: Tenelo no es parte de ella.
Los datos son tuyos y se muestran como llegan
Lo que devuelve tu fuente se exhibe tal cual. Tenelo no lo verifica ni responde por datos incorrectos, desactualizados o no disponibles por causas ajenas al servicio.
No hay garantía de continuidad ni SLA
Tenelo procura estar disponible siempre, pero no garantiza ausencia de interrupciones. Si una pantalla caída es un problema operativo —un turnero lo es—, diseñá el circuito con eso en mente: por ejemplo, que el llamado tenga respaldo en tu sistema.
Preguntas frecuentes
Sí, si tu sistema de turnos puede exponer el estado actual en una URL como una lista de registros planos (JSON, CSV o XML). Tenelo la lee cada pocos segundos y muestra los turnos en la zona de la pantalla que elijas. La lógica de turnos —la cola, el llamado, el botón del operador— sigue en tu sistema.
Puede mostrarlo, no reemplazarlo. Tenelo no gestiona colas ni llama turnos: muestra los datos que tu sistema publica y se ocupa del resto de la pantalla, como la publicidad y los mensajes institucionales.
Si el otro sistema es dueño de la pantalla, hoy no: Tenelo toma la salida de video completa y no se incrusta dentro de otra aplicación. Lo que sí podés hacer es lo inverso: que Tenelo maneje la pantalla y muestre los datos del otro sistema en una zona.
No, si usás webhook: tu sistema hace un POST hacia Tenelo cuando cambia algo, y esa conexión sale desde tu red. Si preferís que Tenelo lea, entonces sí hace falta una URL accesible desde internet, con la autenticación que quieras.
Tenelo responde en el momento con el motivo, en castellano, y no reemplaza lo último que había: la pantalla sigue mostrando el dato anterior. En el panel se ve el último rechazo y cuántos envíos se aceptaron.
No. Tenelo lee una URL o recibe un webhook. Si tus datos están en una base, tu sistema o un servicio chico delante de la base tiene que exponerlos o enviarlos como una lista de registros.
En modo en vivo, desde cada 5 segundos, sea por URL o por webhook. El servidor relee la fuente una vez por intervalo para todas las pantallas, así que todas muestran lo mismo al mismo tiempo. También se puede programar por horarios para datos que cambian poco.
Las pantallas mantienen el último dato válido que recibieron y siguen mostrando el resto del canal. Cuando la fuente vuelve, se actualizan solas.
No como API pública documentada. Los canales y las pantallas se administran desde el panel web.
El soporte es por escrito, a [email protected]. Lo que hace falta para evaluar la integración está en esta página; si te queda una duda concreta, escribinos con un ejemplo del JSON que devuelve tu sistema y la respondemos.
Si te quedó una duda, escribinos con el JSON
Un ejemplo de lo que devuelve tu sistema vale más que una reunión: con eso te decimos en el primer mail si conecta tal cual o qué habría que cambiar.