1. PocketHook Installeren#
Download PocketHook uit de App Store en open het op je iPhone, iPad of Mac.
2. Je Server Configureren#
PocketHook heeft een HTTPS-endpoint nodig om mee te communiceren. Je kunt gebruiken:
- Agent Server — Zelfgehoste AI-agent met LLM, tools, achtergrondtaken en geheugen
- Je eigen API — Elke server die POST-verzoeken accepteert en JSON retourneert
- n8n — Zelfgehoste workflow-automatisering met webhook-trigger
- OpenClaw — Zelfgehoste AI-assistent met multikanaal-berichten
Serververeisten#
Je server moet:
- POST-verzoeken met JSON-body accepteren
- JSON-antwoorden retourneren
- Bereikbaar zijn via HTTPS (HTTP wordt geweigerd om veiligheidsredenen)
- Optioneel Bearer token-authenticatie ondersteunen
3. Verbinden in PocketHook#
- Open PocketHook en ga naar Instellingen
- Voer je Server-URL in (moet HTTPS zijn)
- Voer je Auth Token in (als je server authenticatie vereist)
- Tik op Test Verbinding om te verifieren
4. Verzoekformaat#
PocketHook verstuurt berichten als een JSON-array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "je bericht hier"
}]
5. Antwoordformaat#
Je server moet antwoorden met een JSON-object:
{
"msg": "Bericht getoond aan de gebruiker",
"shortcut": "OptioneleSnelkoppelingNaam",
"data": { "sleutel": "waarde" },
"url": "https://optional-url.com"
}
| Veld | Type | Vereist | Beschrijving |
|---|---|---|---|
msg | string | Ja | Tekst getoond in de chat |
shortcut | string | Nee | iOS Shortcut om uit te voeren |
data | object | array | Nee | Data doorgegeven aan de Shortcut |
url | string | Nee | URL om te openen of weer te geven |
Voor meerstaps-automatiseringen, retourneer een array van antwoorden:
[
{ "msg": "Stap 1...", "shortcut": "EersteSnelkoppeling" },
{ "msg": "Stap 2...", "shortcut": "TweedeSnelkoppeling", "data": { "input": "waarde" } }
]
6. Snelle Start met de Starter Server#
Gebruik ons starter server-sjabloon om binnen minuten aan de slag te gaan:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Bewerk .env met je geheime token
bun dev
De starter bevat ingebouwde commando’s (ping, hello, help, time) en voorbeelden voor het activeren van Shortcuts. Zie de API-referentie voor de volledige protocolspecificatie.
7. De SDK Gebruiken#
Installeer het pockethook-sdk-pakket om type-veilige antwoorden te bouwen:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Eenvoudig tekstantwoord
return toResponse(text("Hallo vanuit mijn server!"));
// Een Shortcut activeren
return toResponse(shortcut("Uitvoeren...", "MijnSnelkoppeling", { sleutel: "waarde" }));
// Meerstaps-automatisering
return toResponse(responses([
{ msg: "Stap 1", shortcut: "Eerste" },
{ msg: "Stap 2", shortcut: "Tweede" }
]));