1. Zainstaluj PocketHook#
Pobierz PocketHook z App Store i otwórz go na swoim iPhone, iPad lub Mac.
2. Skonfiguruj Swój Serwer#
PocketHook wymaga endpointu HTTPS do komunikacji. Możesz użyć:
- Serwer Agent — Samodzielnie hostowany agent AI z LLM, narzędziami, zadaniami w tle i pamięcią
- Własne API — Dowolny serwer przyjmujący żądania POST i zwracający JSON
- n8n — Samodzielnie hostowana automatyzacja przepływów pracy z wyzwalaczem webhook
- OpenClaw — Samodzielnie hostowany asystent AI z wielokanałowym przesyłaniem wiadomości
Wymagania Serwera#
Twój serwer musi:
- Przyjmować żądania POST z treścią JSON
- Zwracać odpowiedzi JSON
- Być dostępny przez HTTPS (HTTP jest odrzucane ze względów bezpieczeństwa)
- Opcjonalnie obsługiwać uwierzytelnianie Bearer token
3. Połącz w PocketHook#
- Otwórz PocketHook i przejdź do Ustawień
- Wprowadź swój URL Serwera (musi być HTTPS)
- Wprowadź swój Token Uwierzytelniania (jeśli serwer wymaga uwierzytelniania)
- Dotknij Testuj Połączenie aby zweryfikować
4. Format Żądania#
PocketHook wysyła wiadomości jako tablicę JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "twoja wiadomosc tutaj"
}]
5. Format Odpowiedzi#
Twój serwer powinien odpowiadać obiektem JSON:
{
"msg": "Wiadomosc wyswietlana uzytkownikowi",
"shortcut": "OpcjonalnaNazwaSkrotu",
"data": { "klucz": "wartosc" },
"url": "https://optional-url.com"
}
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
msg | string | Tak | Tekst wyświetlany w czacie |
shortcut | string | Nie | Skrót iOS do wykonania |
data | object | array | Nie | Dane przekazane do Skrótu |
url | string | Nie | URL do otwarcia lub wyświetlenia |
Dla wieloetapowych automatyzacji zwróć tablicę odpowiedzi:
[
{ "msg": "Krok 1...", "shortcut": "PierwszySkrot" },
{ "msg": "Krok 2...", "shortcut": "DrugiSkrot", "data": { "input": "wartosc" } }
]
6. Szybki Start z Serwerem Starter#
Użyj naszego szablonu serwera starter aby zacząć 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 przykłady wyzwalania Shortcuts. Zobacz Referencje API po pełną specyfikację protokołu.
7. Korzystanie z SDK#
Zainstaluj pakiet pockethook-sdk do budowania odpowiedzi z bezpieczeństwem typów:
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" }
]));