Riferimento impostazioni

Sincronizzazione

#

PocketHook sincronizza le tue conversazioni e le impostazioni dell’app tra i tuoi dispositivi usando il tuo account privato iCloud — nessun account PocketHook, nessun server di terze parti coinvolto.

Accedi con lo stesso account iCloud su iPhone, iPad e Mac e tutto appare automaticamente — nessuna configurazione necessaria. I tuoi dati restano nel tuo database privato di iCloud; i server di PocketHook non li vedono mai.

Configurazione del server

#

Le impostazioni principali di connessione al tuo server PocketHook.

URL del server

#

L’endpoint HTTPS a cui PocketHook invia i tuoi messaggi della chat. Sono accettati solo URL HTTPS — HTTP viene rifiutato per sicurezza. Questo è l’endpoint principale su cui il tuo server è in ascolto.

Token di autenticazione

#

Token Bearer inviato nell’header Authorization con ogni richiesta. Il tuo server può usarlo per verificare che le richieste provengano dal tuo dispositivo. Salvato in modo sicuro nell’iOS Keychain — mai in testo in chiaro.

Compatibile con OpenClaw

#

Attivalo se il tuo server usa la piattaforma OpenClaw o qualsiasi API Chat Completions compatibile con OpenAI. Quando è attivo, PocketHook invia i messaggi nel formato chat di OpenAI e interpreta i marcatori inline di comandi rapidi ([SHORTCUT:name], [DATA:{...}], [URL:...]) nella risposta. Alle richieste viene aggiunto l’header x-openclaw-agent-id.

Prova connessione

#

Pulsante che invia una richiesta di prova al server configurato. Mostra:

• Tempo di risposta in millisecondi
• Risultato dell’health check (se abilitato)
• Dettagli dell’errore se la connessione fallisce

Usalo dopo aver cambiato l’URL del server o il token di autenticazione per verificare che tutto funzioni.

Rete

#

Regola il comportamento dei timeout per i diversi tipi di operazioni.

Timeout di richiesta

#

Quanto tempo PocketHook aspetta che il server inizi a rispondere a una richiesta. Se il tuo server esegue elaborazioni pesanti (come chiamare un modello di IA), aumenta questo valore. Per semplici server webhook, i 5 secondi predefiniti di solito bastano.

Timeout di risorsa

#

Tempo massimo perché la risposta completa venga trasferita, dati inclusi. Deve essere superiore al Timeout di richiesta. Aumentalo se il tuo server restituisce payload grandi o ha velocità di upload lente.

Health Check

#

Attiva il monitoraggio dello stato del server. Quando è attivo, PocketHook invia una richiesta GET all’URL di Health Check durante le prove di connessione e mostra se il tuo server risulta operativo.

URL di Health Check

#

Un endpoint HTTPS separato che restituisce testo semplice true o false. Questo URL viene interrogato durante le prove di connessione per verificare che il tuo server sia operativo. Utile quando l’endpoint API principale è protetto da autenticazione ma vuoi un controllo di stato semplice.

Automazione

#

Controlla come PocketHook esegue i Comandi Rapidi di iOS attivati dalle risposte del server.

Comandi Rapidi di iOS

#

Interruttore principale per l’esecuzione dei Comandi Rapidi. Quando è OFF, PocketHook continua a mostrare i messaggi del server ma ignora qualsiasi campo shortcut nelle risposte. Utile per il debug o per disabilitare temporaneamente le automazioni.

Ritardo tra comandi rapidi

#

Tempo di attesa tra l’esecuzione di comandi rapidi consecutivi quando il server restituisce più automazioni in un’unica risposta. Aumentalo se i tuoi comandi rapidi dipendono l’uno dall’altro (per esempio, il primo crea un file che il secondo legge).

Timeout dei comandi rapidi

#

Tempo massimo di attesa perché ogni singolo comando rapido termini prima che PocketHook lo consideri scaduto. I comandi rapidi di lunga durata (come quelli che elaborano contenuti multimediali o fanno più chiamate API) possono richiedere i 5 minuti completi.

Interfaccia personale

#

Incorpora un’interfaccia web personalizzata direttamente in PocketHook.

Interfaccia personale

#

Mostra una scheda dedicata con una vista web integrata. Quando è attiva, nella navigazione principale appare una nuova scheda in cui viene mostrata la tua pagina web personalizzata. La pagina viene precaricata per apparire all’istante e supporta il pull-to-refresh.

URL dell’interfaccia personale

#

L’URL da mostrare nella scheda dell’interfaccia personale. Sono accettati sia HTTP che HTTPS (HTTPS consigliato). Può essere una dashboard, un pannello di amministrazione o qualsiasi pagina web a cui vuoi accedere rapidamente accanto alla chat.

Link

#

Configura come PocketHook gestisce gli URL delle risposte del server.

Scheda Link

#

Mostra o nasconde la scheda Link nella navigazione principale. Quando è attiva, tutti gli URL ricevuti nelle risposte del server vengono salvati e mostrati in una scheda dedicata con anteprime dei link, ricerca e possibilità di eliminazione.

Apertura automatica degli URL

#

Quando è attivo, PocketHook apre automaticamente gli URL delle risposte del server nel tuo browser predefinito. Quando è disattivato, gli URL vengono comunque salvati nella scheda Link (se abilitata) ma non si aprono automaticamente.

Questa impostazione è intenzionalmente per dispositivo: potresti voler far aprire i link automaticamente sul tuo iPhone ma non sul tuo Mac. Toccare il link sotto un messaggio lo apre sempre, indipendentemente da questa impostazione.

Lingua

#

Personalizza la lingua dell’app e della dettatura.

Lingua dell’app

#

Cambia la lingua dell’interfaccia dell’app indipendentemente dalla lingua del dispositivo. Quando è impostata su “Predefinita di sistema”, PocketHook segue l’impostazione della lingua di iOS.

Lingua di dettatura

#

Lingua usata per la dettatura vocale (speech-to-text) nel campo di input della chat. Lingue disponibili:

Attività in background

#

Controlla periodicamente se ci sono attività in sospeso anche quando l’app è in background.

Attività in background

#

Attiva il polling in background. Quando è attivo, PocketHook invia periodicamente una richiesta GET all’URL di polling. Se la risposta è true, invia il messaggio di recupero al tuo server principale quando l’app viene aperta. Richiede il permesso per le notifiche per avvisarti delle attività in sospeso.

Intervallo di controllo

#

Con quale frequenza PocketHook controlla l’URL di polling in background. Intervalli più brevi significano un rilevamento più rapido delle attività in sospeso ma un maggiore consumo di batteria. iOS può regolare la frequenza effettiva in base ai modelli d’uso del dispositivo.

URL di polling

#

Endpoint HTTPS che PocketHook interroga all’intervallo configurato. Deve restituire testo semplice true (attività in sospeso) o false (nessuna attività). È un controllo leggero — il tuo server dovrebbe rispondere rapidamente senza elaborazioni pesanti.

Agent Server: usa https://your-host/jobs (adatta host e porta alla tua configurazione).

Messaggio di recupero

#

Il messaggio inviato al tuo server principale quando un controllo in background trova attività in sospeso e l’app viene aperta. La risposta del server appare nella chat come qualsiasi altro messaggio. Personalizzalo per attivare un comportamento specifico lato server.

Gestione dei dati

#

Monitora e gestisci i tuoi messaggi salvati.

Messaggi salvati

#

Mostra quanti messaggi sono attualmente salvati. L’indicatore è codificato a colori:

• Verde — Sotto il 70% della capacità
• Arancione — 70–90% della capacità
• Rosso — Oltre il 90% della capacità

Quando si raggiunge il limite di 500 messaggi, i più vecchi vengono eliminati automaticamente per fare spazio ai nuovi.

Esporta conversazione

#

Pulsante che esporta tutti i messaggi salvati come file JSON tramite il foglio di condivisione di iOS. Puoi salvare il file, inviarlo via AirDrop o condividerlo con qualsiasi app. Utile per fare il backup delle conversazioni o analizzare la cronologia dei messaggi.

Elimina tutti i messaggi

#

Pulsante distruttivo che rimuove in modo permanente tutti i messaggi salvati. Richiede una conferma prima dell’esecuzione. Questa azione non può essere annullata.

Informazioni

#

Informazioni di sola lettura sulla tua installazione di PocketHook.