Emparejar un dispositivo

Esta guía te muestra cómo emparejar un celular con Control Center para que puedas leer mensajes y tickets y responder desde cualquier lugar. El mismo flujo empareja un segundo navegador o una aplicación de escritorio. Consulta Control remoto y móvil para saber cómo funciona el enlace y su modelo de seguridad.

Requisitos previos

Un cliente de escritorio o web conectado a tu servidor y un espacio de trabajo configurado. Las operaciones de emparejamiento requieren un cliente completo, así que un celular emparejado nunca puede emparejar —ni revocar— otro dispositivo.
Que el servidor sea accesible desde el dispositivo que estás emparejando. En la misma red funciona sin más; desde más lejos, el relevo intermediado transporta el tráfico. Si el panel responde No accesible en lugar de un QR o unas credenciales, publica primero una ruta: la activación del túnel en Ajustes → Servidor → Conexión y estado (Compartir este servidor), o el --public-url del servidor (consulta Ejecutar un servidor headless).
Para un celular: no hay nada que instalar. El QR abre la aplicación web Remote (remote.usectrl.dev de forma predeterminada).

Autoalojamiento. Remote y el broker del relevo son de código abierto en este repositorio: la app del celular (apps/cc_remote, una PWA web de Flutter que puedes desplegar en Cloudflare Pages mediante su wrangler.jsonc, en la imagen nginx docker/cc_remote, o en cualquier host estático con HTTPS —los service workers e IndexedDB están condicionados al contexto seguro—) y el relevo (apps/cc_signaling_server, un único binario Dart sin estado que no guarda datos de la app y nunca ve el secreto de emparejamiento: solo reenvía tramas selladas de extremo a extremo). Consulta sus README para conocer los pasos de compilación y ejecución.

Paso 1: Abrir el panel de emparejamiento

Abre Ajustes → Tú → Tus dispositivos. La sección Tus dispositivos muestra los clientes emparejados con tu cuenta en este servidor. (El propietario del servidor ve todos los dispositivos del servidor; los demás solo ven los suyos.)

Paso 2: Vincular un nuevo cliente

Haz clic en Vincular un nuevo cliente en el encabezado de la página, asígnale una etiqueta (p. ej. “Mi celular”), elige el tipo —Navegador web, Aplicación de escritorio o Teléfono— y haz clic en Vincular.

Para un celular, aparece un código QR. Escanéalo con la cámara del celular, o copia el enlace y ábrelo en cualquier navegador. Apunta la app Remote a tu servidor y lleva la credencial.
Para un navegador o un escritorio, copia el enlace que se muestra (o el id de dispositivo y la clave de emparejamiento) en el nuevo cliente. El enlace de un solo toque solo se ofrece cuando emparejas desde el cliente web, ya que un binario de escritorio no tiene un origen web a partir del cual generarlo.

El QR del celular y el enlace que cc_server pair --client-url imprime en la CLI son cargas útiles distintas y no son intercambiables: el enlace de la CLI rellena el formulario de conexión del cliente web, mientras que este QR lleva el descriptor de conexión completo del servidor y la huella de identidad para la PWA Remote.

Del lado del celular, abrir un enlace de emparejamiento no empareja en silencio. Remote muestra el nombre anunciado del servidor y te pide confirmación antes de guardar nada, así que un enlace falsificado no puede secuestrar la app para llevarla al servidor de otra persona.

Administrar dispositivos emparejados

Desde Ajustes → Tú → Tus dispositivos puedes:

Cambiar nombre de un dispositivo
Revocar un dispositivo en el que ya no confías. Revocar destruye su credencial y cierra su sesión activa en cuestión de segundos, así que falla en cerrado al reconectarse

Revocar es lo correcto cuando pierdes un celular o lo reemplazas. Es inmediato e irreversible desde la perspectiva del dispositivo.

Las credenciales emitidas desde este panel tienen una vigencia limitada: caducan 30 días después de emitirse, y a partir de ese momento la compuerta de conexión las rechaza en cerrado. Una credencial emitida con cc_server pair en la línea de comandos no caduca en absoluto: revócala a mano cuando se retire la máquina para la que era.

Cambiar de espacio de trabajo desde el celular

Un celular emparejado puede cambiar entre espacios de trabajo de forma independiente del escritorio. El celular envía el espacio de trabajo con cada llamada, y el servidor comprueba tu pertenencia y tu rol en ese espacio en cada una, así que el celular solo llega a los espacios de trabajo de los que eres miembro, y cambiar ahí nunca modifica lo que muestra el escritorio.

Una sesión de celular está además limitada a una pequeña lista de permitidos de herramientas de uso intensivo de lectura: puede listar y leer tickets, agentes, espacios, mensajes y artículos del feed, y puede actualizar o asignar un ticket, enviar un mensaje en un espacio y marcar un artículo como leído o guardado. Todo lo que quede fuera de ese conjunto se rechaza antes de llegar al despachador del servidor.

Guías relacionadas

Ejecutar un servidor headless: para empezar, hacer que el servidor sea accesible
Conectarte a un servidor remoto: apuntar un cliente completo a él
Usar espacios: lo que harás sobre todo desde el celular
Crear y administrar tickets: clasificar sobre la marcha