1. Inštalácia PocketHook#
Stiahnite si PocketHook z App Store a otvorte ho na svojom iPhone, iPad alebo Mac.
2. Konfigurácia Vášho Servera#
PocketHook potrebuje HTTPS endpoint na komunikáciu. Môžete použiť:
- Agent Server — Samohostovaný AI agent s LLM, nástrojmi, úlohami na pozadí a pamäťou
- Vlastné API — Akýkoľvek server prijímajúci POST požiadavky a vracajúci JSON
- n8n — Samohostovaná automatizácia pracovných tokov s webhook triggerom
- OpenClaw — Samohostovaný AI asistent s viackanálovou komunikáciou
Požiadavky na Server#
Váš server musí:
- Prijímať požiadavky POST s JSON telom
- Vracať JSON odpovede
- Byť dostupný cez HTTPS (HTTP je odmietnuté z bezpečnostných dôvodov)
- Voliteľne podporovať Bearer token autentifikáciu
3. Pripojenie v PocketHook#
- Otvorte PocketHook a prejdite do Nastavení
- Zadajte URL servera (musí byť HTTPS)
- Zadajte svoj Autentifikačný token (ak to váš server vyžaduje)
- Klepnite na Otestovať pripojenie na overenie
4. Formát Požiadavky#
PocketHook posiela správy ako JSON pole:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "vasa sprava tu"
}]
5. Formát Odpovede#
Váš server by mal odpovedať JSON objektom:
{
"msg": "Sprava zobrazena pouzivatelovi",
"shortcut": "VolitelnyNazovSkratky",
"data": { "kluc": "hodnota" },
"url": "https://optional-url.com"
}
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
msg | string | Áno | Text zobrazený v chate |
shortcut | string | Nie | iOS Shortcut na vykonanie |
data | object | array | Nie | Dáta odoslané do Shortcut |
url | string | Nie | URL na otvorenie alebo zobrazenie |
Pre viackrokové automatizácie vráťte pole odpovedí:
[
{ "msg": "Krok 1...", "shortcut": "PrvaSkratka" },
{ "msg": "Krok 2...", "shortcut": "DruhaSkratka", "data": { "input": "hodnota" } }
]
6. Rýchly Štart so Starter Serverom#
Použite našu šablónu starter servera a začnite počas niekoľkých minút:
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 vstavané príkazy (ping, hello, help, time) a príklady na spúšťanie Shortcuts. Podrobnosti nájdete v API referencii pre úplnú špecifikáciu protokolu.
7. Použitie SDK#
Nainštalujte balíček pockethook-sdk na tvorbu typovo bezpečných odpovedí:
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" }
]));