Bruk denne guiden til å installere PocketHook, konfigurere serverendepunktet ditt, og bekrefte din første forespørsel fra en Apple-enhet.
1. Installer PocketHook#
Last ned PocketHook fra App Store og åpne den på din iPhone, iPad eller Mac.
2. Konfigurer Serveren Din#
PocketHook trenger et HTTPS-endepunkt for å kommunisere. Du kan bruke:
- Agent Server — Selvhostet AI-agent med LLM, verktøy, bakgrunnsoppgaver og minne
- Din egen API — Enhver server som godtar POST-forespørsler og returnerer JSON
- n8n — Selvhostet arbeidsflytautomatisering med webhook-utløser
- OpenClaw — Selvhostet AI-assistent med flerkanals meldinger
Serverkrav#
Serveren din må:
- Godta POST-forespørsler med JSON-kropp
- Returnere JSON-svar
- Være tilgjengelig via HTTPS (HTTP avvises av sikkerhetsgrunner)
- Valgfritt støtte Bearer token-autentisering
3. Koble til i PocketHook#
- Åpne PocketHook og gå til Innstillinger
- Skriv inn din Server-URL (må være HTTPS)
- Skriv inn ditt Autentiseringstoken (hvis serveren din krever autentisering)
- Trykk på Test Tilkobling for å verifisere
4. Forespørselformat#
PocketHook sender meldinger som en JSON-matrise:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "din melding her"
}]
5. Svarformat#
Serveren din bør svare med et JSON-objekt:
{
"msg": "Melding vist til brukeren",
"shortcut": "ValgfrittSnarveisNavn",
"data": { "nokkel": "verdi" },
"url": "https://optional-url.com"
}
| Felt | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
msg | string | Ja | Tekst vist i chatten |
shortcut | string | Nei | iOS Shortcut som skal kjøres |
data | object | array | Nei | Data sendt til Shortcut |
url | string | Nei | URL som skal åpnes 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 vår starter server-mal for å komme i gang på 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 på å utløse Shortcuts. Se API-referansen for den fullstendige protokollspesifikasjonen.
7. Bruke SDK#
Installer pockethook-sdk-pakken for å 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" }
]));