1. Installer PocketHook#
Téléchargez PocketHook depuis l’App Store et ouvrez-le sur votre iPhone, iPad ou Mac.
2. Configurer Votre Serveur#
PocketHook a besoin d’un endpoint HTTPS pour communiquer. Vous pouvez utiliser :
- Serveur Agent — Agent IA auto-hébergé avec LLM, outils, tâches en arrière-plan et mémoire
- Votre propre API — Tout serveur acceptant les requêtes POST et retournant du JSON
- n8n — Automatisation de workflows auto-hébergée avec déclencheur webhook
- OpenClaw — Assistant IA auto-hébergé avec messagerie multicanal
Exigences du Serveur#
Votre serveur doit :
- Accepter les requêtes POST avec un body JSON
- Retourner des réponses JSON
- Être accessible via HTTPS (HTTP est rejeté pour des raisons de sécurité)
- Optionnellement supporter l’authentification Bearer token
3. Connecter dans PocketHook#
- Ouvrez PocketHook et allez dans Réglages
- Entrez votre URL du Serveur (doit être HTTPS)
- Entrez votre Token d’Authentification (si votre serveur requiert une authentification)
- Appuyez sur Tester la Connexion pour vérifier
4. Format de Requête#
PocketHook envoie les messages sous forme de tableau JSON :
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "votre message ici"
}]
5. Format de Réponse#
Votre serveur doit répondre avec un objet JSON :
{
"msg": "Message affiche a l'utilisateur",
"shortcut": "NomDuRaccourciOptionnel",
"data": { "cle": "valeur" },
"url": "https://optional-url.com"
}
| Champ | Type | Requis | Description |
|---|---|---|---|
msg | string | Oui | Texte affiché dans le chat |
shortcut | string | Non | Raccourci iOS à exécuter |
data | object | array | Non | Données transmises au Raccourci |
url | string | Non | URL à ouvrir ou afficher |
Pour des automatisations multi-étapes, retournez un tableau de réponses :
[
{ "msg": "Etape 1...", "shortcut": "PremierRaccourci" },
{ "msg": "Etape 2...", "shortcut": "SecondRaccourci", "data": { "input": "valeur" } }
]
6. Démarrage Rapide avec le Serveur Starter#
Utilisez notre modèle de serveur starter pour démarrer en quelques minutes :
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Modifiez .env avec votre token secret
bun dev
Le starter inclut des commandes intégrées (ping, hello, help, time) et des exemples pour déclencher des Raccourcis. Consultez la Référence API pour la spécification complète du protocole.
7. Utiliser le SDK#
Installez le package pockethook-sdk pour construire des réponses typées :
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Reponse texte simple
return toResponse(text("Bonjour depuis mon serveur !"));
// Declencher un Raccourci
return toResponse(shortcut("Execution...", "MonRaccourci", { cle: "valeur" }));
// Automatisation multi-etapes
return toResponse(responses([
{ msg: "Etape 1", shortcut: "Premier" },
{ msg: "Etape 2", shortcut: "Second" }
]));