Skip to main content
  1. Documentation/

Référence des réglages

Synchronisation
#

PocketHook synchronise vos conversations et les réglages de l’appli entre vos appareils grâce à votre compte iCloud privé — sans compte PocketHook, sans serveur tiers impliqué.

RequiertConnexion à iCloud, iCloud Drive activé
Ce qui synchroniseLes conversations, la configuration du serveur et la plupart des réglages
Ce qui ne synchronise pasQuelques réglages sont volontairement propres à chaque appareil — voir Ouverture automatique des URL plus bas

Connectez-vous au même compte iCloud sur votre iPhone, votre iPad et votre Mac et tout apparaît automatiquement — aucune configuration nécessaire. Vos données restent dans votre propre base de données iCloud privée ; les serveurs de PocketHook ne les voient jamais.

Configuration du serveur
#

Les réglages principaux de connexion à votre serveur PocketHook.

URL du serveur
#

TypeChamp de texte (URL)
Par défautVide
Stocké dansKeychain iOS

Le point de terminaison HTTPS auquel PocketHook envoie vos messages de clavardage. Seules les URL HTTPS sont acceptées — HTTP est refusé pour des raisons de sécurité. C’est le point de terminaison principal sur lequel votre serveur écoute.

Jeton d’authentification
#

TypeChamp de texte sécurisé
Par défautVide
Longueur10–1 000 caractères
Stocké dansKeychain iOS

Jeton Bearer envoyé dans l’en-tête Authorization avec chaque requête. Votre serveur peut l’utiliser pour vérifier que les requêtes proviennent bien de votre appareil. Stocké de manière sécurisée dans le Keychain iOS — jamais en texte clair.

Compatible OpenClaw
#

TypeInterrupteur
Par défautOFF

Activez-le si votre serveur utilise la plateforme OpenClaw ou toute API Chat Completions compatible OpenAI. Lorsqu’il est activé, PocketHook envoie les messages au format chat d’OpenAI et interprète les marqueurs de raccourcis en ligne ([SHORTCUT:name], [DATA:{...}], [URL:...]) dans la réponse. Un en-tête x-openclaw-agent-id est ajouté aux requêtes.

Tester la connexion
#

Bouton qui envoie une requête de test à votre serveur configuré. Affiche :

  • Temps de réponse en millisecondes
  • Résultat du health check (si activé)
  • Détails de l’erreur si la connexion échoue

Utilisez-le après avoir changé l’URL du serveur ou le jeton d’authentification pour vérifier que tout fonctionne.


Réseau
#

Ajustez le comportement des délais d’attente pour différents types d’opérations.

Délai de requête
#

TypeStepper (±5 secondes)
Par défaut5 secondes
Plage1–600 secondes

Combien de temps PocketHook attend que le serveur commence à répondre à une requête. Si votre serveur effectue des traitements lourds (comme appeler un modèle d’IA), augmentez cette valeur. Pour de simples serveurs webhook, les 5 secondes par défaut suffisent généralement.

Délai de ressource
#

TypeStepper (±10 secondes)
Par défaut60 secondes
Plage30–600 secondes

Temps maximum pour que la réponse entière soit transférée, données comprises. Il doit être supérieur au Délai de requête. Augmentez-le si votre serveur renvoie de gros payloads ou a des vitesses de téléversement lentes.

Health Check
#

TypeInterrupteur
Par défautOFF

Active la surveillance de l’état du serveur. Lorsqu’il est actif, PocketHook envoie une requête GET à l’URL de Health Check pendant les tests de connexion et affiche si votre serveur se déclare opérationnel.

URL de Health Check
#

TypeChamp de texte (URL)
Par défautVide
Visible quandHealth Check est ON

Un point de terminaison HTTPS séparé qui renvoie le texte brut true ou false. Cette URL est interrogée pendant les tests de connexion pour vérifier que votre serveur est opérationnel. Utile lorsque votre point de terminaison API principal est derrière une authentification mais que vous voulez une simple vérification d’état.


Automatisation
#

Contrôlez comment PocketHook exécute les Raccourcis iOS déclenchés par les réponses du serveur.

Raccourcis iOS
#

TypeInterrupteur
Par défautON

Interrupteur principal pour l’exécution des Raccourcis. Lorsqu’il est OFF, PocketHook continue d’afficher les messages du serveur mais ignore tout champ shortcut dans les réponses. Utile pour déboguer ou désactiver temporairement les automatisations.

Délai entre raccourcis
#

TypeCurseur
Par défaut2.0 secondes
Plage0.5–10.0 secondes

Temps d’attente entre l’exécution de raccourcis consécutifs lorsque le serveur renvoie plusieurs automatisations dans une seule réponse. Augmentez-le si vos raccourcis dépendent les uns des autres (par exemple, le premier crée un fichier que le second lit).

Délai des raccourcis
#

TypeSélecteur segmenté
Par défaut5 minutes (300s)
Options30s, 1 min, 2 min, 5 min

Temps d’attente maximum pour que chaque raccourci individuel se termine avant que PocketHook le considère comme expiré. Les raccourcis de longue durée (comme ceux qui traitent des médias ou font plusieurs appels API) peuvent nécessiter les 5 minutes complètes.


Interface personnelle
#

Intégrez une interface web personnalisée directement dans PocketHook.

Interface personnelle
#

TypeInterrupteur
Par défautOFF

Affiche un onglet dédié avec une vue web intégrée. Lorsqu’il est activé, un nouvel onglet apparaît dans la navigation principale où s’affiche votre page web personnalisée. La page est préchargée pour un affichage instantané et prend en charge le tirer-pour-rafraîchir.

URL d’interface personnelle
#

TypeChamp de texte (URL)
Par défautVide
Visible quandInterface personnelle est ON

L’URL à afficher dans l’onglet d’interface personnelle. HTTP et HTTPS sont acceptés (HTTPS recommandé). Cela peut être un tableau de bord, un panneau d’administration ou toute page web à laquelle vous voulez accéder rapidement à côté de votre clavardage.


Liens
#

Configurez comment PocketHook gère les URL provenant des réponses du serveur.

Onglet Liens
#

TypeInterrupteur
Par défautON

Affiche ou masque l’onglet Liens dans la navigation principale. Lorsqu’il est activé, toutes les URL reçues des réponses du serveur sont enregistrées et affichées dans un onglet dédié avec des aperçus de liens enrichis, la recherche et la suppression.

Ouverture automatique des URL
#

TypeInterrupteur
Par défautON
Synchronisé ?Non — se configure indépendamment sur chaque appareil

Lorsqu’il est activé, PocketHook ouvre automatiquement les URL des réponses du serveur dans votre navigateur par défaut. Lorsqu’il est désactivé, les URL sont quand même enregistrées dans l’onglet Liens (s’il est activé) mais ne s’ouvrent pas automatiquement.

Ce réglage est propre à chaque appareil volontairement : vous pourriez vouloir que les liens s’ouvrent automatiquement sur votre iPhone mais pas sur votre Mac. Toucher la pastille de lien sous un message l’ouvre toujours, peu importe ce réglage.


Langue
#

Personnalisez la langue de l’appli et de la dictée.

Langue de l’appli
#

TypeSélecteur
Par défautRéglage du système
OptionsRéglage du système, English, Español

Change la langue d’affichage de l’appli indépendamment de la langue de votre appareil. Réglé sur « Réglage du système », PocketHook suit le réglage de langue d’iOS.

Langue de dictée
#

TypeSélecteur
Par défautLangue du système
Options21 langues

Langue utilisée pour la dictée vocale (reconnaissance vocale) dans la zone de saisie du clavardage. Langues disponibles :

LangueCode
Anglais (É.-U.)en-US
Anglais (Royaume-Uni)en-GB
Espagnol (Espagne)es-ES
Espagnol (Mexique)es-MX
Françaisfr-FR
Allemandde-DE
Italienit-IT
Portugais (Brésil)pt-BR
Portugais (Portugal)pt-PT
Catalanca-ES
Chinois (simplifié)zh-CN
Japonaisja-JP
Coréenko-KR
Arabear-SA
Russeru-RU
Néerlandaisnl-NL
Suédoissv-SE
Polonaispl-PL
Turctr-TR
Thaïth-TH
Vietnamienvi-VN

Tâches en arrière-plan
#

Vérifie périodiquement s’il y a des tâches en attente même lorsque l’appli est en arrière-plan.

Tâches en arrière-plan
#

TypeInterrupteur
Par défautOFF

Active le polling en arrière-plan. Lorsqu’il est actif, PocketHook envoie périodiquement une requête GET à l’URL de polling. Si la réponse est true, il envoie le message de récupération à votre serveur principal à l’ouverture de l’appli. Nécessite l’autorisation de notifications pour vous aviser des tâches en attente.

Intervalle de vérification
#

TypeSélecteur segmenté
Par défaut15 minutes
Options5 min, 15 min, 30 min, 1 hr, 2 hr

À quelle fréquence PocketHook vérifie l’URL de polling en arrière-plan. Des intervalles plus courts signifient une détection plus rapide des tâches en attente mais consomment plus de batterie. iOS peut ajuster la fréquence réelle selon les habitudes d’utilisation de l’appareil.

URL de polling
#

TypeChamp de texte (URL)
Par défautVide
Visible quandTâches en arrière-plan est ON

Point de terminaison HTTPS que PocketHook interroge à l’intervalle configuré. Doit renvoyer le texte brut true (tâches en attente) ou false (aucune tâche). C’est une vérification légère — votre serveur devrait répondre rapidement sans traitement lourd.

Agent Server : utilisez https://your-host/jobs (adaptez l’hôte et le port à votre configuration).

Message de récupération
#

TypeChamp de texte
Par défautfetchPendingTasks
Longueur max10 000 caractères

Le message envoyé à votre serveur principal lorsqu’une vérification en arrière-plan trouve des tâches en attente et que l’appli s’ouvre. La réponse du serveur apparaît dans le clavardage comme n’importe quel autre message. Personnalisez-le pour déclencher un comportement spécifique côté serveur.


Gestion des données
#

Surveillez et gérez vos messages stockés.

Messages stockés
#

TypeAffichage en lecture seule
Format« X sur 500 messages »

Affiche combien de messages sont actuellement stockés. L’indicateur est codé par couleur :

  • Vert — Moins de 70 % de la capacité
  • Orange — 70–90 % de la capacité
  • Rouge — Plus de 90 % de la capacité

Lorsque la limite de 500 messages est atteinte, les messages les plus anciens sont supprimés automatiquement pour faire de la place aux nouveaux.

Exporter la conversation
#

Bouton qui exporte tous les messages stockés dans un fichier JSON via la feuille de partage iOS. Vous pouvez enregistrer le fichier, l’envoyer par AirDrop ou le partager avec n’importe quelle appli. Utile pour sauvegarder vos conversations ou analyser l’historique des messages.

Supprimer tous les messages
#

Bouton destructif qui supprime définitivement tous les messages stockés. Nécessite une confirmation avant l’exécution. Cette action est irréversible.


À propos
#

Informations en lecture seule sur votre installation de PocketHook.

ChampDescription
Version de l’appliVersion actuelle de PocketHook (ex. 1.0.0)
BuildNuméro de build de cette version
Version d’iOSVersion d’iOS/iPadOS de votre appareil