1. Instalacia PocketHook#
Stiahnite si PocketHook z App Store a otvorte ho na svojom iPhone, iPad alebo Mac.
2. Konfiguracia Vasho Servera#
PocketHook potrebuje HTTPS endpoint na komunikaciu. Mozete pouzit:
- Agent Server — Samohostovany AI agent s LLM, nastrojmi, ulohami na pozadi a pamatou
- Vlastne API — Akykolvek server prijimajuci POST poziadavky a vracajuci JSON
- n8n — Samohostovana automatizacia pracovnych tokov s webhook triggerom
- OpenClaw — Samohostovany AI asistent s viackanalovoyu komunikaciou
Poziadavky na Server#
Vas server musi:
- Prijimat poziadavky POST s JSON telom
- Vracat JSON odpovede
- Byt dostupny cez HTTPS (HTTP je odmietnuty z bezpecnostnych dovodov)
- Volitelne podporovat Bearer token autentifikaciu
3. Pripojenie v PocketHook#
- Otvorte PocketHook a prejdite do Nastaveni
- Zadajte URL servera (musi byt HTTPS)
- Zadajte svoj Autentifikacny token (ak to vas server vyzaduje)
- Klepnite na Otestovat pripojenie na overenie
4. Format Poziadavky#
PocketHook posiela spravy ako JSON pole:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "vasa sprava tu"
}]
5. Format Odpovede#
Vas server by mal odpovedat JSON objektom:
{
"msg": "Sprava zobrazena pouzivatelovi",
"shortcut": "VolitelnyNazovSkratky",
"data": { "kluc": "hodnota" },
"url": "https://optional-url.com"
}
| Pole | Typ | Povinne | Popis |
|---|---|---|---|
msg | string | Ano | Text zobrazeny v chate |
shortcut | string | Nie | iOS Shortcut na vykonanie |
data | object | array | Nie | Data odoslane do Shortcut |
url | string | Nie | URL na otvorenie alebo zobrazenie |
Pre viackrokove automatizacie vratte pole odpovedi:
[
{ "msg": "Krok 1...", "shortcut": "PrvaSkratka" },
{ "msg": "Krok 2...", "shortcut": "DruhaSkratka", "data": { "input": "hodnota" } }
]
6. Rychly Start so Starter Serverom#
Pouzite nasu sablonu starter servera a zacnite pocas niekolkych 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 tokenom
bun dev
Starter obsahuje vstavane prikazy (ping, hello, help, time) a priklady na spustanie Shortcuts. Podrobnosti najdete v API referencii pre uplnu specifikaciu protokolu.
7. Pouzitie SDK#
Nainstalujte balicek pockethook-sdk na tvorbu typovo bezpecnych odpovedi:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Jednoducha textova odpoved
return toResponse(text("Ahoj z mojho servera!"));
// Spustenie Shortcut
return toResponse(shortcut("Spustam...", "MojaSkratka", { kluc: "hodnota" }));
// Viackrokova automatizacia
return toResponse(responses([
{ msg: "Krok 1", shortcut: "Prvy" },
{ msg: "Krok 2", shortcut: "Druhy" }
]));