1. Zainstaluj PocketHook#
Pobierz PocketHook z App Store i otworz go na swoim iPhone, iPad lub Mac.
2. Skonfiguruj Swoj Serwer#
PocketHook wymaga endpointu HTTPS do komunikacji. Mozesz uzyc:
- Serwer Agent — Samodzielnie hostowany agent AI z LLM, narzedziami, zadaniami w tle i pamiecia
- Wlasne API — Dowolny serwer przyjmujacy zadania POST i zwracajacy JSON
- n8n — Samodzielnie hostowana automatyzacja przepywow pracy z wyzwalaczem webhook
- OpenClaw — Samodzielnie hostowany asystent AI z wielokanalowym przesylaniem wiadomosci
Wymagania Serwera#
Twoj serwer musi:
- Przyjmowac zadania POST z trescia JSON
- Zwracac odpowiedzi JSON
- Byc dostepny przez HTTPS (HTTP jest odrzucane ze wzgledow bezpieczenstwa)
- Opcjonalnie obslugiwac uwierzytelnianie Bearer token
3. Polacz w PocketHook#
- Otworz PocketHook i przejdz do Ustawien
- Wprowadz swoj URL Serwera (musi byc HTTPS)
- Wprowadz swoj Token Uwierzytelniania (jesli serwer wymaga uwierzytelniania)
- Dotknij Testuj Polaczenie aby zweryfikowac
4. Format Zadania#
PocketHook wysyla wiadomosci jako tablice JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "twoja wiadomosc tutaj"
}]
5. Format Odpowiedzi#
Twoj serwer powinien odpowiadac obiektem JSON:
{
"msg": "Wiadomosc wyswietlana uzytkownikowi",
"shortcut": "OpcjonalnaNazwaSkrotu",
"data": { "klucz": "wartosc" },
"url": "https://optional-url.com"
}
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
msg | string | Tak | Tekst wyswietlany w czacie |
shortcut | string | Nie | Skrot iOS do wykonania |
data | object | array | Nie | Dane przekazane do Skrotu |
url | string | Nie | URL do otwarcia lub wyswietlenia |
Dla wieloetapowych automatyzacji zwroc tablice odpowiedzi:
[
{ "msg": "Krok 1...", "shortcut": "PierwszySkrot" },
{ "msg": "Krok 2...", "shortcut": "DrugiSkrot", "data": { "input": "wartosc" } }
]
6. Szybki Start z Serwerem Starter#
Uzyj naszego szablonu serwera starter aby zaczac w kilka minut:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Edytuj .env swoim tajnym tokenem
bun dev
Starter zawiera wbudowane komendy (ping, hello, help, time) i przyklady wyzwalania Shortcuts. Zobacz Referencje API po pelna specyfikacje protokolu.
7. Korzystanie z SDK#
Zainstaluj pakiet pockethook-sdk do budowania odpowiedzi z bezpieczenstwem typow:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Prosta odpowiedz tekstowa
return toResponse(text("Czesc z mojego serwera!"));
// Wyzwolenie Skrotu
return toResponse(shortcut("Uruchamianie...", "MojSkrot", { klucz: "wartosc" }));
// Wieloetapowa automatyzacja
return toResponse(responses([
{ msg: "Krok 1", shortcut: "Pierwszy" },
{ msg: "Krok 2", shortcut: "Drugi" }
]));