↓ Ir al contenido
  1. Documentación/

PocketHook 1.4: servidores y configuración por QR

Requisitos y compatibilidad
#

PocketHook 1.4 admite perfiles de servidor en iOS/iPadOS 26 o posterior y en Mac compatibles. Un servidor es gratis, incluida la configuración manual o por QR. Varios servidores requieren una prueba Pro activa, la compra Pro o la licencia de la antigua app de pago. Una compra cubre todos los perfiles. Las funciones Pro anteriores conservan sus requisitos de acceso.

Adjuntar o pegar imágenes en el chat ya era gratis y sigue siéndolo. En la 1.4 también puedes activar sin Pro los enlaces a la fototeca local. Activa esta función en Ajustes y concede el permiso correspondiente de iOS.

Puedes seguir usando cualquier endpoint HTTPS compatible. Agent Server 0.8.0 añade el emparejamiento opcional por QR; no es necesario para configurar la conexión manualmente. El SDK sigue en 0.1.3 y Apple Bridge en 0.6.0. Los adjuntos y resultados asíncronos conservan los requisitos de protocolo de la 1.3.

Añadir y cambiar de servidor
#

  1. Abre Ajustes → Gestionar servidores → Añadir servidor.
  2. Introduce el endpoint HTTPS y el token, escanea una invitación QR o importa su imagen.
  3. Pon un nombre y, si quieres, un emoji. Si lo dejas vacío, se utiliza el icono habitual.
  4. Prueba la conexión y guarda. Cambia de servidor desde el selector de la cabecera del chat.

Cada servidor conserva su chat, borrador, enlaces, sesión y trabajos pendientes. Edita la conexión, los tiempos de espera, la comprobación de estado, los trabajos y la UI desde su propia ficha. Editar otro servidor no lo activa. Vuelve a tocar la pestaña UI seleccionada para recargar su página actual.

Apariencia y navegación
#

Abre Ajustes → Gestionar servidores → tu servidor → Apariencia → Estilos. Puedes elegir una imagen desde Fotos o Archivos, quitarla, cambiar el color de tus mensajes y de las respuestas y ajustar la opacidad de las burbujas. La vista previa permite ver el resultado. El texto y las imágenes no pierden opacidad. Restablecer colores de las burbujas recupera los colores automáticos.

Aplicar fondo a todos los servidores aparece cuando hay varios perfiles y copia solo la imagen a los servidores añadidos en este dispositivo. Conserva los colores, la opacidad y la opción de sincronización de cada uno. El fondo y los colores no se envían al servidor; se comparten por iCloud únicamente cuando el perfil tiene la sincronización activada. Estas opciones son gratuitas.

Mac y iPad con ventanas amplias permiten alternar entre navegación superior y lateral; iPhone conserva las pestañas inferiores. Los controles Liquid Glass siguen los ajustes del sistema. Reducir transparencia tiene prioridad sobre la opacidad elegida para las burbujas. Las opciones de respuesta se presentan en una tarjeta, una por fila, con el color de las respuestas del servidor.

Generar una invitación de Agent Server
#

En el Mac que ejecuta Agent Server 0.8.0, con las herramientas de línea de comandos de Xcode instaladas:

bun run app:qr

El comando lee la configuración local y busca una dirección HTTPS de esa instancia en Tailscale o en la configuración de túnel guardada. No crea ni modifica túneles. Si la dirección es ambigua o no está disponible, sigue las indicaciones del comando para proporcionarla. El teléfono debe poder acceder a ella: una dirección privada de Tailscale sigue necesitando acceso mediante Tailscale.

La terminal muestra el QR; bun run app:qr --open también abre su imagen. Las invitaciones caducan a los cinco minutos, son de un solo uso y se invalidan al generar otra o reiniciar el servidor. Genera una nueva si ha caducado. El QR contiene un código temporal; al canjearlo por HTTPS, la app obtiene las credenciales de conexión.

Trata la invitación como acceso a tu servidor. Usa la credencial de su propietario, no una cuenta de usuario separada. Tener varios perfiles en PocketHook no añade usuarios aislados a Agent Server. No publiques QR reales ni los incluyas en documentación o repositorios. Consulta la referencia de emparejamiento del servidor.

Atajos, Compartir y resultados pendientes
#

Las acciones que usan un servidor ofrecen el parámetro Servidor. Elige un perfil para fijar el destino de una automatización. Las acciones existentes sin selección conservan el perfil original, independientemente del chat activo. Compartir también permite elegir destino. Si está eliminado o bloqueado, la app muestra un error y no envía el contenido a otro servidor.

Una petición en curso queda asociada al servidor de origen. Mientras la app está activa, comprueba los trabajos pendientes de los perfiles habilitados aunque estés viendo otro chat. Tocar otra vez Chat solicita una comprobación. En segundo plano, el sistema decide cuándo ejecuta el sondeo: no garantiza una hora exacta de entrega.

Actualización, almacenamiento y Pro
#

Activa Sincronizar este servidor con iCloud para compartir nombre, emoji, fondo del chat, colores y opacidad de las burbujas, ajustes de conexión, mensajes entregados y enlaces guardados. En los otros equipos aparecerá en Disponibles en iCloud: tú eliges dónde añadirlo y su historial solo se descarga al hacerlo. Déjalo desactivado para un servidor exclusivo de un dispositivo. El servidor activo, los borradores y los envíos pendientes son independientes en cada equipo. Los tokens se sincronizan de forma segura a través del Llavero de iCloud cuando activas la sincronización del servidor. Activa el Llavero de iCloud en ambos dispositivos con la misma cuenta de Apple; las credenciales pueden llegar después del perfil. No necesitas copiar el token obtenido por QR. La conversación original conserva su sincronización anterior con iCloud.

Gestionar servidores consulta iCloud al abrirse. Actualizar iCloud permite repetir la consulta y muestra su progreso y la última comprobación. La entrega del perfil, su historial y el token puede tardar; un perfil sin credenciales indica que está esperando al Llavero antes de permitir el envío.

Si Pro deja de estar activo, elige un servidor gratuito. Los demás siguen guardados, pero bloqueados; comprar o restaurar Pro los habilita. Quitar un perfil de este dispositivo lo desconecta y retira sus credenciales locales. No borra datos remotos ni implica eliminar registros históricos locales o de iCloud. Consulta la política de privacidad.

Un servidor propio no necesita un protocolo obligatorio nuevo para admitir varios perfiles. Cada perfil envía peticiones a su endpoint con sus propias credenciales y sesión. El emparejamiento QR es una capacidad opcional, separada del protocolo de chat.