1. Instal·lar PocketHook#
Descarrega PocketHook des de l’App Store i obre’l al teu iPhone, iPad o Mac.
2. Configura el Teu Servidor#
PocketHook necessita un endpoint HTTPS per comunicar-se. Pots utilitzar:
- Servidor Agent — Agent IA autoallotjat amb LLM, eines, tasques en segon pla i memoria
- La teva propia API — Qualsevol servidor que accepti peticions POST i retorni JSON
- n8n — Automatitzacio de fluxos autoallotjada amb trigger webhook
- OpenClaw — Assistent IA autoallotjat amb missatgeria multicanal
Requisits del Servidor#
El teu servidor ha de:
- Acceptar peticions POST amb body JSON
- Retornar respostes JSON
- Ser accessible via HTTPS (HTTP es rebutja per seguretat)
- Opcionalment suportar autenticacio Bearer token
3. Connectar a PocketHook#
- Obre PocketHook i ves a Configuracio
- Introdueix la teva URL del Servidor (ha de ser HTTPS)
- Introdueix el teu Token d’Autenticacio (si el teu servidor ho requereix)
- Toca Provar Connexio per verificar
4. Format de Peticio#
PocketHook envia missatges com un array JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "el teu missatge aqui"
}]
5. Format de Resposta#
El teu servidor ha de respondre amb un objecte JSON:
{
"msg": "Missatge mostrat a l'usuari",
"shortcut": "NomDeLaDrecera Opcional",
"data": { "clau": "valor" },
"url": "https://url-opcional.com"
}
| Camp | Tipus | Requerit | Descripcio |
|---|---|---|---|
msg | string | Si | Text mostrat al xat |
shortcut | string | No | Drecera d’iOS a executar |
data | object | array | No | Dades passades a la Drecera |
url | string | No | URL per obrir o mostrar |
Per a automatitzacions multi-pas, retorna un array de respostes:
[
{ "msg": "Pas 1...", "shortcut": "PrimeraDrecera" },
{ "msg": "Pas 2...", "shortcut": "SegonaDrecera", "data": { "input": "valor" } }
]
6. Inici Rapid amb el Servidor Starter#
Utilitza la nostra plantilla de servidor starter per comencar en minuts:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Edita .env amb el teu token secret
bun dev
L’starter inclou comandes integrades (ping, hello, help, time) i exemples per activar Dreceres. Consulta la Referencia API per a l’especificacio completa del protocol.
7. Utilitzant el SDK#
Instal·la el paquet pockethook-sdk per construir respostes amb tipus:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Resposta de text simple
return toResponse(text("Hola des del meu servidor!"));
// Activar una Drecera
return toResponse(shortcut("Executant...", "LaMevaDrecera", { clau: "valor" }));
// Automatitzacio multi-pas
return toResponse(responses([
{ msg: "Pas 1", shortcut: "Primera" },
{ msg: "Pas 2", shortcut: "Segona" }
]));