1. Installer PocketHook#
Telechargez 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-heberge avec LLM, outils, taches en arriere-plan et memoire
- Votre propre API — Tout serveur acceptant les requetes POST et retournant du JSON
- n8n — Automatisation de workflows auto-hebergee avec declencheur webhook
- OpenClaw — Assistant IA auto-heberge avec messagerie multicanal
Exigences du Serveur#
Votre serveur doit :
- Accepter les requetes POST avec un body JSON
- Retourner des reponses JSON
- Etre accessible via HTTPS (HTTP est rejete pour des raisons de securite)
- Optionnellement supporter l’authentification Bearer token
3. Connecter dans PocketHook#
- Ouvrez PocketHook et allez dans Reglages
- Entrez votre URL du Serveur (doit etre HTTPS)
- Entrez votre Token d’Authentification (si votre serveur requiert une authentification)
- Appuyez sur Tester la Connexion pour verifier
4. Format de Requete#
PocketHook envoie les messages sous forme de tableau JSON :
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "votre message ici"
}]
5. Format de Reponse#
Votre serveur doit repondre 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 affiche dans le chat |
shortcut | string | Non | Raccourci iOS a executer |
data | object | array | Non | Donnees transmises au Raccourci |
url | string | Non | URL a ouvrir ou afficher |
Pour des automatisations multi-etapes, retournez un tableau de reponses :
[
{ "msg": "Etape 1...", "shortcut": "PremierRaccourci" },
{ "msg": "Etape 2...", "shortcut": "SecondRaccourci", "data": { "input": "valeur" } }
]
6. Demarrage Rapide avec le Serveur Starter#
Utilisez notre modele de serveur starter pour demarrer 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 integrees (ping, hello, help, time) et des exemples pour declencher des Raccourcis. Consultez la Reference API pour la specification complete du protocole.
7. Utiliser le SDK#
Installez le package pockethook-sdk pour construire des reponses typees :
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" }
]));