Referência de definições

Sincronização

#

O PocketHook sincroniza as suas conversas e definições da aplicação entre os seus dispositivos, utilizando a sua conta privada do iCloud — sem conta PocketHook, sem qualquer servidor de terceiros envolvido.

Inicie sessão com a mesma conta iCloud no seu iPhone, iPad e Mac e tudo aparece automaticamente — sem necessidade de configuração. Os seus dados permanecem na sua própria base de dados privada do iCloud; os servidores do PocketHook nunca os veem.

Configuração do Servidor

#

As definições principais de ligação ao seu servidor PocketHook.

URL do Servidor

#

O endpoint HTTPS para onde o PocketHook envia as suas mensagens do chat. Apenas URLs HTTPS são aceites — HTTP é rejeitado por segurança. Este é o endpoint principal em que o seu servidor escuta.

Token de Autenticação

#

Token Bearer enviado no cabeçalho Authorization com cada pedido. O seu servidor pode usá-lo para verificar que os pedidos vêm do seu dispositivo. Armazenado de forma segura no iOS Keychain — nunca em texto simples.

Compatível com OpenClaw

#

Ative se o seu servidor usa a plataforma OpenClaw ou qualquer API compatível com OpenAI Chat Completions. Quando ativado, o PocketHook envia mensagens no formato de chat da OpenAI e analisa marcadores de atalho em linha ([SHORTCUT:name], [DATA:{...}], [URL:...]) da resposta. Um cabeçalho x-openclaw-agent-id é incluído nos pedidos.

Testar Ligação

#

Botão que envia um pedido de teste ao seu servidor configurado. Apresenta:

• Tempo de resposta em milissegundos
• Resultado do health check (se ativado)
• Detalhes do erro se a ligação falhar

Utilize-o após alterar o URL do Servidor ou o Token de Autenticação para verificar que tudo funciona.

Rede

#

Afine o comportamento dos tempos de espera para diferentes tipos de operações.

Timeout de Pedido

#

Quanto tempo o PocketHook espera que o servidor comece a responder a um pedido. Se o seu servidor faz processamento pesado (como chamar um modelo de IA), aumente este valor. Para servidores webhook simples, a predefinição de 5 segundos costuma ser suficiente.

Timeout de Recurso

#

Tempo máximo para a resposta completa terminar, incluindo a transferência de dados. Deve ser superior ao Timeout de Pedido. Aumente se o seu servidor devolve payloads grandes ou tem velocidades de envio lentas.

Health Check

#

Ativa a monitorização de saúde do servidor. Quando ativo, o PocketHook envia um pedido GET ao URL de Health Check durante os testes de ligação e mostra se o seu servidor reporta estar operacional.

URL de Health Check

#

Um endpoint HTTPS separado que devolve texto simples true ou false. Este URL é consultado durante os testes de ligação para verificar que o seu servidor está operacional. Útil quando o seu endpoint principal de API está protegido por autenticação, mas quer uma verificação de estado simples.

Automatização

#

Controle como o PocketHook executa os Atalhos do iOS acionados por respostas do servidor.

Atalhos do iOS

#

Interruptor principal para a execução de Atalhos. Quando está OFF, o PocketHook continua a apresentar as mensagens do servidor, mas ignora qualquer campo shortcut nas respostas. Útil para depurar ou desativar automatizações temporariamente.

Atraso Entre Atalhos

#

Tempo de espera entre a execução de atalhos consecutivos quando o servidor devolve múltiplas automatizações numa única resposta. Aumente se os seus atalhos dependem uns dos outros (por exemplo, o primeiro atalho cria um ficheiro que o segundo lê).

Timeout de Atalho

#

Tempo máximo de espera para que cada atalho individual termine antes de o PocketHook o considerar expirado. Atalhos de longa duração (como os que processam multimédia ou fazem múltiplas chamadas de API) podem necessitar dos 5 minutos completos.

UI Pessoal

#

Incorpore uma interface web personalizada diretamente no PocketHook.

UI Pessoal

#

Mostra um separador dedicado com uma vista web incorporada. Quando ativado, um novo separador aparece na navegação principal onde a sua página web personalizada é apresentada. A página é pré-carregada para apresentação instantânea e suporta pull-to-refresh.

URL da UI Pessoal

#

O URL a apresentar no separador de UI Pessoal. Tanto HTTP como HTTPS são aceites (HTTPS recomendado). Pode ser um dashboard, um painel de administração ou qualquer página web a que queira aceder rapidamente junto ao seu chat.

Links

#

Configure como o PocketHook gere os URLs das respostas do servidor.

Separador de Links

#

Mostra ou oculta o separador de Links na navegação principal. Quando ativado, todos os URLs recebidos das respostas do servidor são guardados e apresentados num separador dedicado com pré-visualizações ricas de links, pesquisa e eliminação.

Abrir URLs Automaticamente

#

Quando ativado, o PocketHook abre automaticamente os URLs das respostas do servidor no seu navegador predefinido. Quando desativado, os URLs continuam a ser guardados no separador de Links (se ativado), mas não abrem automaticamente.

Esta definição é por dispositivo de propósito: pode querer que os links se abram automaticamente no iPhone, mas não no Mac. Tocar no link por baixo de uma mensagem abre-o sempre, independentemente desta definição.

Idioma

#

Personalize o idioma da app e do ditado.

Idioma da App

#

Altera o idioma de apresentação da app independentemente do idioma do seu dispositivo. Quando definido como “Predefinição do sistema”, o PocketHook segue a definição de idioma do iOS.

Idioma de Ditado

#

Idioma usado para o ditado por voz (speech-to-text) na entrada do chat. Idiomas disponíveis:

Tarefas em Segundo Plano

#

Verifique periodicamente se há tarefas pendentes mesmo quando a app está em segundo plano.

Tarefas em Segundo Plano

#

Ativa o polling em segundo plano. Quando ativo, o PocketHook envia periodicamente um pedido GET ao URL de Polling. Se a resposta for true, envia a Mensagem de Consulta ao seu servidor principal quando a app é aberta. Requer permissão de notificações para o alertar sobre tarefas pendentes.

Intervalo de Verificação

#

Com que frequência o PocketHook consulta o URL de Polling em segundo plano. Intervalos mais curtos significam uma deteção mais rápida de tarefas pendentes, mas consomem mais bateria. O iOS pode ajustar a frequência real com base nos padrões de utilização do dispositivo.

URL de Polling

#

Endpoint HTTPS que o PocketHook consulta no intervalo configurado. Deve devolver texto simples true (tarefas pendentes) ou false (sem tarefas). Esta é uma verificação leve — o seu servidor deve responder rapidamente, sem processamento pesado.

Agent Server: Use https://your-host/jobs (ajuste o host e a porta de acordo com a sua configuração).

Mensagem de Consulta

#

A mensagem enviada ao seu servidor principal quando uma verificação em segundo plano encontra tarefas pendentes e a app é aberta. A resposta do servidor aparece no chat como qualquer outra mensagem. Personalize isto para acionar um comportamento específico no seu servidor.

Gestão de Dados

#

Monitorize e faça a gestão das suas mensagens armazenadas.

Mensagens Armazenadas

#

Mostra quantas mensagens estão armazenadas atualmente. O indicador tem código de cores:

• Verde — Menos de 70% da capacidade
• Laranja — 70–90% da capacidade
• Vermelho — Mais de 90% da capacidade

Quando o limite de 500 mensagens é atingido, as mensagens mais antigas são eliminadas automaticamente para abrir espaço às novas.

Exportar Conversa

#

Botão que exporta todas as mensagens armazenadas como um ficheiro JSON através do menu de partilha do iOS. Pode guardar o ficheiro, enviá-lo por AirDrop ou partilhá-lo com qualquer app. Útil para fazer cópias de segurança de conversas ou analisar o histórico de mensagens.

Eliminar Todas as Mensagens

#

Botão destrutivo que remove permanentemente todas as mensagens armazenadas. Requer confirmação antes de executar. Esta ação não pode ser anulada.

Acerca de

#

Informação só de leitura sobre a sua instalação do PocketHook.