1. Instalacija PocketHook#
Preuzmite PocketHook iz App Store i otvorite ga na svom iPhone, iPad ili Mac uređaju.
2. Konfigurirajte Svoj Server#
PocketHook treba HTTPS endpoint za komunikaciju. Možete koristiti:
- Agent Server — Samostalno hostani AI agent s LLM, alatima, pozadinskim zadacima i memorijom
- Vlastiti API — Bilo koji server koji prima POST zahtjeve i vraća JSON
- n8n — Samostalno hostana automatizacija radnih tokova s webhook okidačem
- OpenClaw — Samostalno hostani AI asistent s višekanalnim porukama
Zahtjevi Servera#
Vaš server mora:
- Prihvaćati POST zahtjeve s JSON tijelom
- Vraćati JSON odgovore
- Biti dostupan putem HTTPS (HTTP se odbija iz sigurnosnih razloga)
- Opcionalno podržavati Bearer token autentifikaciju
3. Povezivanje u PocketHook#
- Otvorite PocketHook i idite na Postavke
- Unesite svoju URL Servera (mora biti HTTPS)
- Unesite svoj Token za Autentifikaciju (ako vaš server zahtijeva autentifikaciju)
- Dodirnite Testiraj Vezu za provjeru
4. Format Zahtjeva#
PocketHook šalje poruke kao JSON niz:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "vasa poruka ovdje"
}]
5. Format Odgovora#
Vaš server treba odgovoriti JSON objektom:
{
"msg": "Poruka prikazana korisniku",
"shortcut": "OpcionalnaNazivPrecice",
"data": { "kljuc": "vrijednost" },
"url": "https://optional-url.com"
}
| Polje | Tip | Obavezno | Opis |
|---|---|---|---|
msg | string | Da | Tekst prikazan u chatu |
shortcut | string | Ne | iOS Shortcut za pokretanje |
data | object | array | Ne | Podaci proslijeđeni Shortcutu |
url | string | Ne | URL za otvaranje ili prikaz |
Za višestepene automatizacije, vratite niz odgovora:
[
{ "msg": "Korak 1...", "shortcut": "PrvaPrecica" },
{ "msg": "Korak 2...", "shortcut": "DrugaPrecica", "data": { "input": "vrijednost" } }
]
6. Brzi Početak sa Starter Serverom#
Koristite naš predložak starter servera da počnete u minutama:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Uredite .env sa svojim tajnim tokenom
bun dev
Starter uključuje ugrađene naredbe (ping, hello, help, time) i primjere za pokretanje Shortcuts. Pogledajte API Referencu za potpunu specifikaciju protokola.
7. Korištenje SDK#
Instalirajte paket pockethook-sdk za izgradnju tipski sigurnih odgovora:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Jednostavan tekstualni odgovor
return toResponse(text("Pozdrav s mog servera!"));
// Pokretanje Shortcuta
return toResponse(shortcut("Pokrecem...", "MojaPrecica", { kljuc: "vrijednost" }));
// Visestepena automatizacija
return toResponse(responses([
{ msg: "Korak 1", shortcut: "Prva" },
{ msg: "Korak 2", shortcut: "Druga" }
]));