Referencia de Ajustes

Configuración del Servidor

#

Los ajustes principales de conexión con tu servidor PocketHook.

URL del Servidor

#

El endpoint HTTPS donde PocketHook envía tus mensajes del chat. Solo se aceptan URLs HTTPS — las HTTP se rechazan por seguridad. Este es el endpoint principal en el que tu servidor escucha.

Token de Autenticación

#

Token Bearer enviado en la cabecera Authorization con cada petición. Tu servidor puede usarlo para verificar que las peticiones vienen de tu dispositivo. Se almacena de forma segura en el iOS Keychain — nunca en texto plano.

Compatible con OpenClaw

#

Activa si tu servidor usa la plataforma OpenClaw o cualquier API compatible con OpenAI Chat Completions. Cuando está activo, PocketHook envía mensajes en formato chat de OpenAI y parsea marcadores de atajos en línea ([SHORTCUT:nombre], [DATA:{...}], [URL:...]) de la respuesta. Se incluye la cabecera x-openclaw-agent-id en las peticiones.

Probar Conexión

#

Botón que envía una petición de prueba a tu servidor configurado. Muestra:

• Tiempo de respuesta en milisegundos
• Resultado del health check (si está habilitado)
• Detalles del error si la conexión falla

Úsalo después de cambiar la URL del Servidor o el Token de Autenticación para verificar que todo funciona.

Red

#

Ajusta el comportamiento de los tiempos de espera para diferentes tipos de operaciones.

Timeout de Petición

#

Cuánto tiempo espera PocketHook a que el servidor empiece a responder a una petición. Si tu servidor hace procesamiento pesado (como llamar a un modelo de IA), aumenta este valor. Para servidores webhook simples, los 5 segundos por defecto suelen ser suficientes.

Timeout de Recurso

#

Tiempo máximo para que la respuesta completa se transfiera, incluyendo datos. Debe ser mayor que el Timeout de Petición. Aumenta si tu servidor devuelve payloads grandes o tiene velocidades de subida lentas.

Health Check

#

Activa la monitorización de salud del servidor. Cuando está activo, PocketHook envía una petición GET a la URL de Health Check durante las pruebas de conexión y muestra si tu servidor reporta estar operativo.

URL de Health Check

#

Un endpoint HTTPS separado que devuelve texto plano true o false. Esta URL se consulta durante las pruebas de conexión para verificar que tu servidor está operativo. Útil cuando tu endpoint principal de API está detrás de autenticación pero quieres una verificación de estado simple.

Automatización

#

Controla cómo PocketHook ejecuta los Atajos de iOS activados por respuestas del servidor.

Atajos de iOS

#

Interruptor principal para la ejecución de Atajos. Cuando está OFF, PocketHook sigue mostrando los mensajes del servidor pero ignora cualquier campo shortcut en las respuestas. Útil para depurar o deshabilitar automatizaciones temporalmente.

Retraso Entre Atajos

#

Tiempo de espera entre la ejecución de atajos consecutivos cuando el servidor devuelve múltiples automatizaciones en una sola respuesta. Aumenta si tus atajos dependen uno del otro (por ejemplo, el primero crea un archivo que el segundo lee).

Timeout de Atajo

#

Tiempo máximo de espera para que cada atajo individual termine antes de que PocketHook lo considere agotado. Atajos de larga duración (como los que procesan multimedia o hacen múltiples llamadas API) pueden necesitar los 5 minutos completos.

Interfaz Personal

#

Inserta una interfaz web personalizada directamente en PocketHook.

Interfaz Personal

#

Muestra una pestaña dedicada con una vista web integrada. Cuando está activo, aparece una nueva pestaña en la navegación principal donde se muestra tu página web personalizada. La página se precarga para mostrarse al instante y soporta pull-to-refresh.

URL de Interfaz Personal

#

La URL a mostrar en la pestaña de Interfaz Personal. Se aceptan HTTP y HTTPS (se recomienda HTTPS). Puede ser un dashboard, panel de administración o cualquier página web a la que quieras acceder rápidamente junto a tu chat.

Enlaces

#

Configura cómo PocketHook gestiona las URLs de las respuestas del servidor.

Pestaña de Enlaces

#

Muestra u oculta la pestaña de Enlaces en la navegación principal. Cuando está activo, todas las URLs recibidas de las respuestas del servidor se guardan y muestran en una pestaña dedicada con previsualizaciones enriquecidas, búsqueda y eliminación.

Abrir URLs Automáticamente

#

Cuando está activo, PocketHook abre automáticamente las URLs de las respuestas del servidor en tu navegador predeterminado. Cuando está desactivado, las URLs se guardan en la pestaña de Enlaces (si está habilitada) pero no se abren automáticamente.

Idioma

#

Personaliza el idioma de la app y del dictado.

Idioma de la App

#

Cambia el idioma de la interfaz de la app independientemente del idioma de tu dispositivo. Cuando está en “Por defecto del sistema”, PocketHook sigue el ajuste de idioma de iOS.

Idioma de Dictado

#

Idioma usado para el dictado por voz (speech-to-text) en la entrada del chat. Idiomas disponibles:

Tareas en Segundo Plano

#

Comprueba periódicamente si hay tareas pendientes incluso cuando la app está en segundo plano.

Tareas en Segundo Plano

#

Activa el polling en segundo plano. Cuando está activo, PocketHook envía periódicamente una petición GET a la URL de Polling. Si la respuesta es true, envía el Mensaje de Consulta a tu servidor principal cuando la app se abre. Requiere permiso de notificaciones para alertarte de tareas pendientes.

Intervalo de Comprobación

#

Con qué frecuencia PocketHook consulta la URL de Polling en segundo plano. Intervalos más cortos significan detección más rápida de tareas pendientes pero consumen más batería. iOS puede ajustar la frecuencia real según los patrones de uso del dispositivo.

URL de Polling

#

Endpoint HTTPS que PocketHook consulta en el intervalo configurado. Debe devolver texto plano true (tareas pendientes) o false (sin tareas). Esta es una comprobación ligera — tu servidor debe responder rápido sin procesamiento pesado.

Agent Server: Usa https://tu-host/jobs (ajusta host y puerto según tu configuración).

Mensaje de Consulta

#

El mensaje enviado a tu servidor principal cuando una comprobación en segundo plano encuentra tareas pendientes y la app se abre. La respuesta del servidor aparece en el chat como cualquier otro mensaje. Personaliza esto para activar un comportamiento específico en tu servidor.

Gestión de Datos

#

Monitorea y gestiona tus mensajes almacenados.

Mensajes Almacenados

#

Muestra cuántos mensajes están almacenados actualmente. El indicador tiene código de colores:

• Verde — Menos del 70% de capacidad
• Naranja — 70–90% de capacidad
• Rojo — Más del 90% de capacidad

Cuando se alcanza el límite de 500 mensajes, los más antiguos se eliminan automáticamente para hacer espacio a los nuevos.

Exportar Conversación

#

Botón que exporta todos los mensajes almacenados como un archivo JSON a través del menú compartir de iOS. Puedes guardar el archivo, enviarlo por AirDrop o compartirlo con cualquier app. Útil para hacer copias de seguridad o analizar el historial de mensajes.

Eliminar Todos los Mensajes

#

Botón destructivo que elimina permanentemente todos los mensajes almacenados. Requiere confirmación antes de ejecutarse. Esta acción no se puede deshacer.

Acerca de

#

Información de solo lectura sobre tu instalación de PocketHook.