1. PocketHook Telepitese#
Toltsd le a PocketHook alkalmazast az App Store-bol es nyisd meg iPhone-on, iPad-en vagy Mac-en.
2. A Szervered Konfigurálása#
A PocketHook-nak szuksege van egy HTTPS endpointra a kommunikaciohoz. Hasznalhatod:
- Agent Server — Onhosztolt AI ugynok LLM-mel, eszkozokkel, hatter feladatokkal es memoriaval
- Sajat API — Barmilyen szerver, ami POST kereseket fogad es JSON-t ad vissza
- n8n — Onhosztolt munkafolyamat-automatizalas webhook triggerrel
- OpenClaw — Onhosztolt AI asszisztens tobbcsatornas uzenetküldessel
Szerver Kovetelmenyek#
A szerverednek:
- POST kereseket kell fogadnia JSON torzzsel
- JSON valaszokat kell visszaadnia
- HTTPS-en keresztul elerhetonek kell lennie (HTTP biztonsagi okokbol elutasitva)
- Opcionalisan tamogatnia kell a Bearer token hitelesiest
3. Csatlakozas a PocketHook-ban#
- Nyisd meg a PocketHook-ot es menj a Beallitasok-hoz
- Add meg a Szerver URL-t (HTTPS kell legyen)
- Add meg a Hitelesitesi Tokent (ha a szervered hitelesiest igenyel)
- Koppints a Kapcsolat Tesztelese gombra az ellenorzeshez
4. Keres Formatum#
A PocketHook JSON tombbkent kuldi az uzeneteket:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "az uzeneted ide"
}]
5. Valasz Formatum#
A szerverednek JSON objektummal kell valaszolnia:
{
"msg": "A felhasznalonak megjelenített uzenet",
"shortcut": "OpcionalísParancsikon Nev",
"data": { "kulcs": "ertek" },
"url": "https://optional-url.com"
}
| Mezo | Tipus | Kotelezo | Leiras |
|---|---|---|---|
msg | string | Igen | A chatben megjelenített szoveg |
shortcut | string | Nem | Vegrehajtando iOS Shortcut |
data | object | array | Nem | A Shortcutnak atadott adatok |
url | string | Nem | Megnyitando vagy megjelenitendo URL |
Tobblepcsos automatizalasokhoz adj vissza egy valasz tombot:
[
{ "msg": "1. lepes...", "shortcut": "ElsoParancsikon" },
{ "msg": "2. lepes...", "shortcut": "MasodikParancsikon", "data": { "input": "ertek" } }
]
6. Gyors Inditas a Starter Szerverrel#
Hasznald 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 fajlt a titkos tokeneddel
bun dev
A starter beepitett parancsokat (ping, hello, help, time) es peldakat tartalmaz Shortcuts inditasahoz. Lasd az API Referencia oldalt a teljes protokoll specifikacioert.
7. Az SDK Hasznalata#
Telepitsd a pockethook-sdk csomagot tipusbiztos valaszok epitésehez:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Egyszeru szoveges valasz
return toResponse(text("Hello a szerveremrol!"));
// Shortcut inditasa
return toResponse(shortcut("Futtatas...", "AzEnParancsikonom", { kulcs: "ertek" }));
// Tobblepcsos automatizalas
return toResponse(responses([
{ msg: "1. lepes", shortcut: "Elso" },
{ msg: "2. lepes", shortcut: "Masodik" }
]));