1. A PocketHook telepítése#
Töltsd le a PocketHook alkalmazást az App Store-ból, és nyisd meg iPhone-on, iPaden vagy Macen.
2. A szervered konfigurálása#
A PocketHooknak szüksége van egy HTTPS végpontra a kommunikációhoz. Használhatod:
- Agent Server — Önhosztolt AI ügynök LLM-mel, eszközökkel, háttérfeladatokkal és memóriával
- Saját API — Bármilyen szerver, amely POST kéréseket fogad és JSON-t ad vissza
- n8n — Önhosztolt munkafolyamat-automatizálás webhook triggerrel
- OpenClaw — Önhosztolt AI asszisztens többcsatornás üzenetküldéssel
Szerverkövetelmények#
A szerverednek:
- POST kéréseket kell fogadnia JSON törzzsel
- JSON válaszokat kell visszaadnia
- HTTPS-en keresztül elérhetőnek kell lennie (a HTTP biztonsági okokból elutasítva)
- Opcionálisan támogatnia kell a Bearer token hitelesítést
3. Csatlakozás a PocketHookban#
- Nyisd meg a PocketHookot, és menj a Beállítások-hoz
- Add meg a Szerver URL-t (HTTPS kell legyen)
- Add meg a Hitelesítési tokent (ha a szervered hitelesítést igényel)
- Koppints a Kapcsolat tesztelése gombra az ellenőrzéshez
4. Kérésformátum#
A PocketHook JSON tömbként küldi az üzeneteket:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "az üzeneted ide"
}]
5. Válaszformátum#
A szerverednek JSON objektummal kell válaszolnia:
{
"msg": "A felhasználónak megjelenített üzenet",
"shortcut": "OpcionálisParancsikonNév",
"data": { "kulcs": "érték" },
"url": "https://optional-url.com"
}
| Mező | Típus | Kötelező | Leírás |
|---|---|---|---|
msg | string | Igen | A csevegésben megjelenített szöveg |
shortcut | string | Nem | A végrehajtandó iOS parancsikon |
data | object | array | Nem | A parancsikonnak átadott adatok |
url | string | Nem | A megnyitandó vagy megjelenítendő URL |
Többlépcsős automatizálásokhoz adj vissza egy választömböt:
[
{ "msg": "1. lépés...", "shortcut": "ElsőParancsikon" },
{ "msg": "2. lépés...", "shortcut": "MásodikParancsikon", "data": { "input": "érték" } }
]
6. Gyors indítás a starter szerverrel#
Használd a starter szerver sablonunkat, hogy percek alatt elindulj:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Szerkeszd a .env fájlt a titkos tokeneddel
bun dev
A starter beépített parancsokat (ping, hello, help, time) és példákat tartalmaz Shortcuts indításához. Lásd az API referencia oldalt a teljes protokollspecifikációért.
7. Az SDK használata#
Telepítsd a pockethook-sdk csomagot típusbiztos válaszok építéséhez:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Egyszerű szöveges válasz
return toResponse(text("Hello a szerveremről!"));
// Shortcut indítása
return toResponse(shortcut("Futtatás...", "AzÉnParancsikonom", { kulcs: "érték" }));
// Többlépcsős automatizálás
return toResponse(responses([
{ msg: "1. lépés", shortcut: "Első" },
{ msg: "2. lépés", shortcut: "Második" }
]));