1. Installera PocketHook#
Ladda ner PocketHook fran App Store och oppna den pa din iPhone, iPad eller Mac.
2. Konfigurera Din Server#
PocketHook behover en HTTPS-andpunkt for att kommunicera. Du kan anvanda:
- Agent Server — Sjalvhostad AI-agent med LLM, verktyg, bakgrundsuppgifter och minne
- Ditt eget API — Vilken server som helst som accepterar POST-forfragan och returnerar JSON
- n8n — Sjalvhostad arbetsflodeautomatisering med webhook-utlosare
- OpenClaw — Sjalvhostad AI-assistent med flerkanalsmeddelanden
Serverkrav#
Din server maste:
- Acceptera POST-forfragningar med JSON-kropp
- Returnera JSON-svar
- Vara tillganglig via HTTPS (HTTP avvisas av sakerhetskal)
- Valfritt stodja Bearer token-autentisering
3. Anslut i PocketHook#
- Oppna PocketHook och ga till Installningar
- Ange din Server-URL (maste vara HTTPS)
- Ange ditt Autentiseringstoken (om din server kraver autentisering)
- Tryck pa Testa Anslutning for att verifiera
4. Forfragansformat#
PocketHook skickar meddelanden som en JSON-array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "ditt meddelande har"
}]
5. Svarsformat#
Din server bor svara med ett JSON-objekt:
{
"msg": "Meddelande visat for anvandaren",
"shortcut": "ValfrittGenvagensNamn",
"data": { "nyckel": "varde" },
"url": "https://optional-url.com"
}
| Falt | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
msg | string | Ja | Text som visas i chatten |
shortcut | string | Nej | iOS Shortcut att kora |
data | object | array | Nej | Data som skickas till Shortcut |
url | string | Nej | URL att oppna eller visa |
For flerstegsautomatiseringar, returnera en array med svar:
[
{ "msg": "Steg 1...", "shortcut": "ForstaGenvagen" },
{ "msg": "Steg 2...", "shortcut": "AndraGenvagen", "data": { "input": "varde" } }
]
6. Snabbstart med Starter-servern#
Anvand var starter server-mall for att komma igang pa nagra minuter:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Redigera .env med ditt hemliga token
bun dev
Starter-servern inkluderar inbyggda kommandon (ping, hello, help, time) och exempel pa att utlosa Shortcuts. Se API-referensen for den fullstandiga protokollspecifikationen.
7. Anvanda SDK#
Installera pockethook-sdk-paketet for att bygga typssakra svar:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Enkelt textsvar
return toResponse(text("Hej fran min server!"));
// Utlos en Shortcut
return toResponse(shortcut("Kor...", "MinGenvag", { nyckel: "varde" }));
// Flerstegsautomatisering
return toResponse(responses([
{ msg: "Steg 1", shortcut: "Forsta" },
{ msg: "Steg 2", shortcut: "Andra" }
]));