1. Installer PocketHook#
Last ned PocketHook fra App Store og apne den pa din iPhone, iPad eller Mac.
2. Konfigurer Serveren Din#
PocketHook trenger et HTTPS-endepunkt for a kommunisere. Du kan bruke:
- Agent Server — Selvhostet AI-agent med LLM, verktoy, bakgrunnsoppgaver og minne
- Din egen API — Enhver server som godtar POST-foresporsler og returnerer JSON
- n8n — Selvhostet arbeidsflytautomatisering med webhook-utloser
- OpenClaw — Selvhostet AI-assistent med flerkanals meldinger
Serverkrav#
Serveren din ma:
- Godta POST-foresporsler med JSON-kropp
- Returnere JSON-svar
- Vaere tilgjengelig via HTTPS (HTTP avvises av sikkerhetsgrunner)
- Valgfritt stotte Bearer token-autentisering
3. Koble til i PocketHook#
- Apne PocketHook og ga til Innstillinger
- Skriv inn din Server-URL (ma vaere HTTPS)
- Skriv inn ditt Autentiseringstoken (hvis serveren din krever autentisering)
- Trykk pa Test Tilkobling for a verifisere
4. Foresporselformat#
PocketHook sender meldinger som en JSON-matrise:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "din melding her"
}]
5. Svarformat#
Serveren din bor svare med et JSON-objekt:
{
"msg": "Melding vist til brukeren",
"shortcut": "ValgfrittSnarveisNavn",
"data": { "nokkel": "verdi" },
"url": "https://optional-url.com"
}
| Felt | Type | Pakrevd | Beskrivelse |
|---|---|---|---|
msg | string | Ja | Tekst vist i chatten |
shortcut | string | Nei | iOS Shortcut som skal kjores |
data | object | array | Nei | Data sendt til Shortcut |
url | string | Nei | URL som skal apnes eller vises |
For flerstegs-automatiseringer, returner en matrise med svar:
[
{ "msg": "Steg 1...", "shortcut": "ForsteSnarveien" },
{ "msg": "Steg 2...", "shortcut": "AndreSnarveien", "data": { "input": "verdi" } }
]
6. Hurtigstart med Starter-serveren#
Bruk var starter server-mal for a 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 ditt hemmelige token
bun dev
Starter-serveren inkluderer innebygde kommandoer (ping, hello, help, time) og eksempler pa a utlose Shortcuts. Se API-referansen for den fullstendige protokollspesifikasjonen.
7. Bruke SDK#
Installer pockethook-sdk-pakken for a bygge typesikre svar:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Enkelt tekstsvar
return toResponse(text("Hei fra serveren min!"));
// Utlose en Shortcut
return toResponse(shortcut("Kjorer...", "MinSnarvei", { nokkel: "verdi" }));
// Flerstegs-automatisering
return toResponse(responses([
{ msg: "Steg 1", shortcut: "Forste" },
{ msg: "Steg 2", shortcut: "Andre" }
]));