1. Instalace PocketHook#
Stahnete si PocketHook z App Store a otevrete ho na svem iPhone, iPad nebo Mac.
2. Konfigurace serveru#
PocketHook potrebuje HTTPS endpoint pro komunikaci. Muzete pouzit:
- Agent Server — Samohostovany AI agent s LLM, nastroji, ulohy na pozadi a pameti
- Vlastni API — Jakykoli server prijimajici POST pozadavky a vracejici JSON
- n8n — Samohostovana automatizace workflow s webhook triggerem
- OpenClaw — Samohostovany AI asistent s vicekanalovym zaslanim zprav
Pozadavky na server#
Vas server musi:
- Prijimat pozadavky POST s JSON telem
- Vracet JSON odpovedi
- Byt dostupny pres HTTPS (HTTP je odmitnut z bezpecnostnich duvodu)
- Volitelne podporovat Bearer token autentizaci
3. Pripojeni v PocketHook#
- Otevrete PocketHook a prejdete do Nastaveni
- Zadejte URL serveru (musi byt HTTPS)
- Zadejte svuj Autentizacni token (pokud to vas server vyzaduje)
- Klepnete na Otestovat pripojeni pro overeni
4. Format pozadavku#
PocketHook odesila zpravy jako JSON pole:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "vase zprava zde"
}]
5. Format odpovedi#
Vas server by mel odpovedet JSON objektem:
{
"msg": "Zprava zobrazena uzivateli",
"shortcut": "VolitelnyNazevZkratky",
"data": { "klic": "hodnota" },
"url": "https://optional-url.com"
}
| Pole | Typ | Povinne | Popis |
|---|---|---|---|
msg | string | Ano | Text zobrazeny v chatu |
shortcut | string | Ne | iOS Shortcut k provedeni |
data | object | array | Ne | Data predana do Shortcut |
url | string | Ne | URL k otevreni nebo zobrazeni |
Pro vicekrokove automatizace vratte pole odpovedi:
[
{ "msg": "Krok 1...", "shortcut": "PrvniZkratka" },
{ "msg": "Krok 2...", "shortcut": "DruhaZkratka", "data": { "input": "hodnota" } }
]
6. Rychly start se Starter serverem#
Pouzijte nasi sablonu starter serveru a zacnete behem 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 vestevene prikazy (ping, hello, help, time) a priklady pro spousteni Shortcuts. Podrobnosti najdete v API referenci pro uplnou specifikaci protokolu.
7. Pouziti SDK#
Nainstalujte balicek pockethook-sdk pro tvorbu typove bezpecnych odpovedi:
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" }
]));