Referência de configurações

Sincronização

#

O PocketHook sincroniza suas conversas e configurações do app entre seus dispositivos usando sua conta privada do iCloud — sem conta do PocketHook, sem nenhum servidor de terceiros envolvido.

Faça login na mesma conta do iCloud no seu iPhone, iPad e Mac e tudo aparece automaticamente — sem necessidade de configuração. Seus dados permanecem no seu próprio banco de dados privado do iCloud; os servidores do PocketHook nunca os veem.

Configuração do Servidor

#

As configurações principais de conexão com seu servidor PocketHook.

URL do Servidor

#

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

Token de Autenticação

#

Token Bearer enviado no cabeçalho Authorization com cada requisição. Seu servidor pode usá-lo para verificar que as requisições vêm do seu dispositivo. Armazenado com segurança no iOS Keychain — nunca em texto plano.

Compatível com OpenClaw

#

Ative se 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 nas requisições.

Testar Conexão

#

Botão que envia uma requisição de teste ao seu servidor configurado. Exibe:

• Tempo de resposta em milissegundos
• Resultado do health check (se habilitado)
• Detalhes do erro se a conexão falhar

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

Rede

#

Ajuste fino do comportamento de timeout para diferentes tipos de operações.

Timeout de Requisição

#

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

Timeout de Recurso

#

Tempo máximo para a resposta inteira ser concluída, incluindo a transferência de dados. Deve ser maior que o Timeout de Requisição. Aumente se seu servidor retorna payloads grandes ou tem velocidades de upload lentas.

Health Check

#

Ativa o monitoramento de saúde do servidor. Quando ativo, o PocketHook envia uma requisição GET à URL de Health Check durante os testes de conexão e exibe se seu servidor reporta estar saudável.

URL de Health Check

#

Um endpoint HTTPS separado que retorna texto plano true ou false. Esta URL é consultada durante os testes de conexão para verificar que seu servidor está operacional. Útil quando seu endpoint principal de API está atrás de autenticação, mas você quer uma verificação de status simples.

Automaçã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 exibindo as mensagens do servidor, mas ignora qualquer campo shortcut nas respostas. Útil para depurar ou desabilitar automações temporariamente.

Atraso Entre Atalhos

#

Tempo de espera entre a execução de atalhos consecutivos quando o servidor retorna múltiplas automações em uma única resposta. Aumente se seus atalhos dependem um do outro (por exemplo, o primeiro atalho cria um arquivo que o segundo lê).

Timeout de Atalho

#

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

UI Pessoal

#

Incorpore uma interface web personalizada diretamente no PocketHook.

UI Pessoal

#

Mostra uma aba dedicada com uma visualização web incorporada. Quando ativada, uma nova aba aparece na navegação principal onde sua página web personalizada é exibida. A página é pré-carregada para exibição instantânea e suporta pull-to-refresh.

URL da UI Pessoal

#

A URL a exibir na aba de UI Pessoal. Tanto HTTP quanto HTTPS são aceitos (HTTPS recomendado). Pode ser um dashboard, um painel de administração ou qualquer página web que você queira acessar rapidamente junto ao seu chat.

Links

#

Configure como o PocketHook lida com as URLs das respostas do servidor.

Aba de Links

#

Mostra ou oculta a aba de Links na navegação principal. Quando ativada, todas as URLs recebidas das respostas do servidor são salvas e exibidas em uma aba dedicada com prévias ricas de links, busca e exclusão.

Abrir URLs Automaticamente

#

Quando ativado, o PocketHook abre automaticamente as URLs das respostas do servidor no seu navegador padrão. Quando desativado, as URLs continuam sendo salvas na aba de Links (se habilitada), mas não abrem automaticamente.

Esta configuração é por dispositivo de propósito: você pode querer que os links abram automaticamente no seu iPhone, mas não no seu Mac. Tocar no link abaixo de uma mensagem sempre a abre, independentemente desta configuração.

Idioma

#

Personalize o idioma do app e do ditado.

Idioma do App

#

Altera o idioma de exibição do app independentemente do idioma do seu dispositivo. Quando definido como “Padrão do sistema”, o PocketHook segue a configuraçã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 o app está em segundo plano.

Tarefas em Segundo Plano

#

Ativa o polling em segundo plano. Quando ativo, o PocketHook envia periodicamente uma requisição GET à URL de Polling. Se a resposta for true, ele envia a Mensagem de Busca ao seu servidor principal quando o app é aberto. Requer permissão de notificações para alertá-lo sobre tarefas pendentes.

Intervalo de Verificação

#

Com que frequência o PocketHook verifica a URL de Polling em segundo plano. Intervalos mais curtos significam detecçã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 uso do dispositivo.

URL de Polling

#

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

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

Mensagem de Busca

#

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

Gerenciamento de Dados

#

Monitore e gerencie 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 excluídas automaticamente para abrir espaço para as novas.

Exportar Conversa

#

Botão que exporta todas as mensagens armazenadas como um arquivo JSON pelo menu de compartilhamento do iOS. Você pode salvar o arquivo, enviá-lo por AirDrop ou compartilhá-lo com qualquer app. Útil para fazer backup de conversas ou analisar o histórico de mensagens.

Excluir 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 desfeita.

Sobre

#

Informações somente leitura sobre sua instalação do PocketHook.