1. Installer PocketHook#
Download PocketHook fra App Store og abn den pa din iPhone, iPad eller Mac.
2. Konfigurer Din Server#
PocketHook har brug for et HTTPS endpoint at kommunikere med. Du kan bruge:
- Agent Server — Selvhostet AI-agent med LLM, vaerktojer, baggrundsopgaver og hukommelse
- Din egen API — Enhver server der accepterer POST-anmodninger og returnerer JSON
- n8n — Selvhostet workflow-automatisering med webhook trigger
- OpenClaw — Selvhostet AI-assistent med multikanal-beskedsystem
Serverkrav#
Din server skal:
- Acceptere POST-anmodninger med JSON body
- Returnere JSON-svar
- Vaere tilgaengelig via HTTPS (HTTP afvises af sikkerhedsgrunde)
- Valgfrit understotte Bearer token-godkendelse
3. Forbind i PocketHook#
- Abn PocketHook og ga til Indstillinger
- Indtast din Server URL (skal vaere HTTPS)
- Indtast dit Godkendelsestoken (hvis din server kraever godkendelse)
- Tryk pa Test Forbindelse for at verificere
4. Anmodningsformat#
PocketHook sender beskeder som et JSON-array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "din besked her"
}]
5. Svarformat#
Din server skal svare med et JSON-objekt:
{
"msg": "Besked vist til brugeren",
"shortcut": "ValgfritGenvejsnavn",
"data": { "noegle": "vaerdi" },
"url": "https://optional-url.com"
}
| Felt | Type | Pavkraevet | Beskrivelse |
|---|---|---|---|
msg | string | Ja | Tekst vist i chatten |
shortcut | string | Nej | iOS Shortcut der skal koeres |
data | object | array | Nej | Data sendt til Shortcut |
url | string | Nej | URL der skal abnes eller vises |
For flertrins-automatiseringer returneres et array af svar:
[
{ "msg": "Trin 1...", "shortcut": "ForsteGenvej" },
{ "msg": "Trin 2...", "shortcut": "AndenGenvej", "data": { "input": "vaerdi" } }
]
6. Hurtig Start med Starter-serveren#
Brug vores starter server-skabelon for at komme i gang pa minutter:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Rediger .env med dit hemmelige token
bun dev
Starter-serveren inkluderer indbyggede kommandoer (ping, hello, help, time) og eksempler pa at udlose Shortcuts. Se API-referencen for den fulde protokolspecifikation.
7. Brug af SDK#
Installer pockethook-sdk-pakken for at bygge typesikre svar:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Simpelt tekstsvar
return toResponse(text("Hej fra min server!"));
// Udlos en Shortcut
return toResponse(shortcut("Koerer...", "MinGenvej", { noegle: "vaerdi" }));
// Flertrins-automatisering
return toResponse(responses([
{ msg: "Trin 1", shortcut: "Forste" },
{ msg: "Trin 2", shortcut: "Anden" }
]));