1. Instalace PocketHook#
Stáhněte si PocketHook z App Store a otevřete ho na svém iPhone, iPad nebo Mac.
2. Konfigurace serveru#
PocketHook potřebuje HTTPS endpoint pro komunikaci. Můžete použít:
- Agent Server — Samohostovaný AI agent s LLM, nástroji, úlohami na pozadí a pamětí
- Vlastní API — Jakýkoli server přijímající POST požadavky a vracející JSON
- n8n — Samohostovaná automatizace workflow s webhook triggerem
- OpenClaw — Samohostovaný AI asistent s vícekanálovým zasíláním zpráv
Požadavky na server#
Váš server musí:
- Přijímat požadavky POST s JSON tělem
- Vracet JSON odpovědi
- Být dostupný přes HTTPS (HTTP je odmítnuto z bezpečnostních důvodů)
- Volitelně podporovat Bearer token autentizaci
3. Připojení v PocketHook#
- Otevřete PocketHook a přejděte do Nastavení
- Zadejte URL serveru (musí být HTTPS)
- Zadejte svůj Autentizační token (pokud to váš server vyžaduje)
- Klepněte na Otestovat připojení pro ověření
4. Formát požadavku#
PocketHook odesílá zprávy jako JSON pole:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "vase zprava zde"
}]
5. Formát odpovědi#
Váš server by měl odpovědět JSON objektem:
{
"msg": "Zprava zobrazena uzivateli",
"shortcut": "VolitelnyNazevZkratky",
"data": { "klic": "hodnota" },
"url": "https://optional-url.com"
}
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
msg | string | Ano | Text zobrazený v chatu |
shortcut | string | Ne | iOS Shortcut k provedení |
data | object | array | Ne | Data předaná do Shortcut |
url | string | Ne | URL k otevření nebo zobrazení |
Pro vícekrokové automatizace vraťte pole odpovědí:
[
{ "msg": "Krok 1...", "shortcut": "PrvniZkratka" },
{ "msg": "Krok 2...", "shortcut": "DruhaZkratka", "data": { "input": "hodnota" } }
]
6. Rychlý start se Starter serverem#
Použijte naši šablonu starter serveru a začněte během minut:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Upravte .env s vasim tajnym tokenem
bun dev
Starter obsahuje vestavěné příkazy (ping, hello, help, time) a příklady pro spouštění Shortcuts. Podrobnosti najdete v API referenci pro úplnou specifikaci protokolu.
7. Použití SDK#
Nainstalujte balíček pockethook-sdk pro tvorbu typově bezpečných odpovědí:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Jednoducha textova odpoved
return toResponse(text("Ahoj z meho serveru!"));
// Spustit Shortcut
return toResponse(shortcut("Spoustim...", "MojeZkratka", { klic: "hodnota" }));
// Vicekrokova automatizace
return toResponse(responses([
{ msg: "Krok 1", shortcut: "Prvni" },
{ msg: "Krok 2", shortcut: "Druhy" }
]));