Referència d'Ajustos

Sincronització

#

PocketHook sincronitza les teves converses i ajustos de l’app entre els teus dispositius usant el teu compte privat d’iCloud — sense compte de PocketHook, sense cap servidor de tercers pel mig.

Inicia sessió amb el mateix compte d’iCloud a l’iPhone, l’iPad i el Mac i tot apareix automàticament — no cal configurar res. Les teves dades es queden a la teva pròpia base de dades privada d’iCloud; els servidors de PocketHook mai no les veuen.

Configuració del Servidor

#

Els ajustos principals de connexió amb el teu servidor PocketHook.

URL del Servidor

#

L’endpoint HTTPS on PocketHook envia els teus missatges del xat. Només s’accepten URL HTTPS — les HTTP es rebutgen per seguretat. Aquest és l’endpoint principal on escolta el teu servidor.

Token d’Autenticació

#

Token Bearer enviat a la capçalera Authorization amb cada petició. El teu servidor pot usar-lo per verificar que les peticions vénen del teu dispositiu. S’emmagatzema de forma segura a l’iOS Keychain — mai en text pla.

Compatible amb OpenClaw

#

Activa’l si el teu servidor usa la plataforma OpenClaw o qualsevol API Chat Completions compatible amb OpenAI. Quan està actiu, PocketHook envia els missatges en format xat d’OpenAI i interpreta els marcadors de dreceres en línia ([SHORTCUT:name], [DATA:{...}], [URL:...]) de la resposta. S’inclou la capçalera x-openclaw-agent-id a les peticions.

Provar Connexió

#

Botó que envia una petició de prova al servidor configurat. Mostra:

• Temps de resposta en mil·lisegons
• Resultat del health check (si està habilitat)
• Detalls de l’error si la connexió falla

Usa’l després de canviar la URL del Servidor o el Token d’Autenticació per verificar que tot funciona.

Xarxa

#

Ajusta el comportament dels temps d’espera per a diferents tipus d’operacions.

Timeout de Petició

#

Quant de temps espera PocketHook que el servidor comenci a respondre una petició. Si el teu servidor fa processament pesat (com cridar un model d’IA), augmenta aquest valor. Per a servidors webhook simples, els 5 segons per defecte solen ser suficients.

Timeout de Recurs

#

Temps màxim perquè es completi la resposta sencera, incloent-hi la transferència de dades. Ha de ser més alt que el Timeout de Petició. Augmenta’l si el teu servidor retorna payloads grans o té velocitats de pujada lentes.

Health Check

#

Activa la monitorització de l’estat del servidor. Quan està actiu, PocketHook envia una petició GET a la URL de Health Check durant les proves de connexió i mostra si el teu servidor informa que està operatiu.

URL de Health Check

#

Un endpoint HTTPS separat que retorna text pla true o false. Aquesta URL es consulta durant les proves de connexió per verificar que el teu servidor és operatiu. Útil quan el teu endpoint principal d’API està darrere d’autenticació però vols una comprovació d’estat simple.

Automatització

#

Controla com PocketHook executa les Dreceres d’iOS activades per respostes del servidor.

Dreceres d’iOS

#

Interruptor principal per a l’execució de Dreceres. Quan està OFF, PocketHook continua mostrant els missatges del servidor però ignora qualsevol camp shortcut de les respostes. Útil per depurar o desactivar automatitzacions temporalment.

Retard Entre Dreceres

#

Temps d’espera entre l’execució de dreceres consecutives quan el servidor retorna múltiples automatitzacions en una sola resposta. Augmenta’l si les teves dreceres depenen l’una de l’altra (per exemple, la primera crea un fitxer que la segona llegeix).

Timeout de Drecera

#

Temps màxim d’espera perquè cada drecera individual acabi abans que PocketHook la consideri caducada. Les dreceres de llarga durada (com les que processen multimèdia o fan múltiples crides API) poden necessitar els 5 minuts complets.

Interfície Personal

#

Insereix una interfície web personalitzada directament a PocketHook.

Interfície Personal

#

Mostra una pestanya dedicada amb una vista web integrada. Quan està actiu, apareix una nova pestanya a la navegació principal on es mostra la teva pàgina web personalitzada. La pàgina es precarrega per mostrar-se a l’instant i suporta pull-to-refresh.

URL d’Interfície Personal

#

La URL a mostrar a la pestanya d’Interfície Personal. S’accepten HTTP i HTTPS (es recomana HTTPS). Pot ser un dashboard, un panell d’administració o qualsevol pàgina web a la qual vulguis accedir ràpidament al costat del teu xat.

Enllaços

#

Configura com PocketHook gestiona les URL de les respostes del servidor.

Pestanya d’Enllaços

#

Mostra o amaga la pestanya d’Enllaços a la navegació principal. Quan està actiu, totes les URL rebudes de les respostes del servidor es desen i es mostren en una pestanya dedicada amb previsualitzacions enriquides, cerca i eliminació.

Obrir URL Automàticament

#

Quan està actiu, PocketHook obre automàticament les URL de les respostes del servidor al teu navegador predeterminat. Quan està desactivat, les URL es continuen desant a la pestanya d’Enllaços (si està habilitada) però no s’obren automàticament.

Aquest ajust és per dispositiu a propòsit: potser vols que els enllaços s’obrin automàticament a l’iPhone però no al Mac. Tocar la píndola de l’enllaç sota un missatge sempre l’obre, independentment d’aquest ajust.

Idioma

#

Personalitza l’idioma de l’app i del dictat.

Idioma de l’App

#

Canvia l’idioma de la interfície de l’app independentment de l’idioma del teu dispositiu. Quan està en “Per defecte del sistema”, PocketHook segueix l’ajust d’idioma d’iOS.

Idioma de Dictat

#

Idioma usat per al dictat per veu (speech-to-text) a l’entrada del xat. Idiomes disponibles:

Tasques en Segon Pla

#

Comprova periòdicament si hi ha tasques pendents fins i tot quan l’app és en segon pla.

Tasques en Segon Pla

#

Activa el polling en segon pla. Quan està actiu, PocketHook envia periòdicament una petició GET a la URL de Polling. Si la resposta és true, envia el Missatge de Consulta al teu servidor principal quan s’obre l’app. Requereix permís de notificacions per avisar-te de tasques pendents.

Interval de Comprovació

#

Amb quina freqüència PocketHook comprova la URL de Polling en segon pla. Intervals més curts signifiquen una detecció més ràpida de tasques pendents però consumeixen més bateria. iOS pot ajustar la freqüència real segons els patrons d’ús del dispositiu.

URL de Polling

#

Endpoint HTTPS que PocketHook consulta a l’interval configurat. Ha de retornar text pla true (tasques pendents) o false (cap tasca). És una comprovació lleugera — el teu servidor hauria de respondre ràpid sense processament pesat.

Agent Server: usa https://your-host/jobs (ajusta host i port segons la teva configuració).

Missatge de Consulta

#

El missatge enviat al teu servidor principal quan una comprovació en segon pla troba tasques pendents i s’obre l’app. La resposta del servidor apareix al xat com qualsevol altre missatge. Personalitza’l per activar un comportament específic al teu servidor.

Gestió de Dades

#

Monitora i gestiona els teus missatges emmagatzemats.

Missatges Emmagatzemats

#

Mostra quants missatges hi ha emmagatzemats actualment. L’indicador té codi de colors:

• Verd — Menys del 70% de capacitat
• Taronja — 70–90% de capacitat
• Vermell — Més del 90% de capacitat

Quan s’arriba al límit de 500 missatges, els més antics s’eliminen automàticament per fer lloc als nous.

Exportar Conversa

#

Botó que exporta tots els missatges emmagatzemats com un fitxer JSON a través del menú de compartir d’iOS. Pots desar el fitxer, enviar-lo per AirDrop o compartir-lo amb qualsevol app. Útil per fer còpies de seguretat de converses o analitzar l’historial de missatges.

Eliminar Tots els Missatges

#

Botó destructiu que elimina permanentment tots els missatges emmagatzemats. Requereix confirmació abans d’executar-se. Aquesta acció no es pot desfer.

Quant a

#

Informació de només lectura sobre la teva instal·lació de PocketHook.