1. Instaleaza PocketHook#
Descarca PocketHook din App Store si deschide-l pe iPhone, iPad sau Mac.
2. Configureaza Serverul Tau#
PocketHook are nevoie de un endpoint HTTPS pentru a comunica. Poti folosi:
- Server Agent — Agent AI auto-gazduit cu LLM, instrumente, sarcini in fundal si memorie
- Propriul tau API — Orice server care accepta cereri POST si returneaza JSON
- n8n — Automatizare a fluxurilor de lucru auto-gazduita cu trigger webhook
- OpenClaw — Asistent AI auto-gazduit cu mesagerie multicanal
Cerinte Server#
Serverul tau trebuie sa:
- Accepte cereri POST cu corp JSON
- Returneze raspunsuri JSON
- Fie accesibil prin HTTPS (HTTP este respins din motive de securitate)
- Optional sa suporte autentificarea Bearer token
3. Conecteaza in PocketHook#
- Deschide PocketHook si mergi la Setari
- Introdu URL-ul Serverului (trebuie sa fie HTTPS)
- Introdu Tokenul de Autentificare (daca serverul tau necesita autentificare)
- Apasa Testeaza Conexiunea pentru verificare
4. Formatul Cererii#
PocketHook trimite mesaje ca un array JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "mesajul tau aici"
}]
5. Formatul Raspunsului#
Serverul tau ar trebui sa raspunda cu un obiect JSON:
{
"msg": "Mesaj afisat utilizatorului",
"shortcut": "NumeScurtatura Optionala",
"data": { "cheie": "valoare" },
"url": "https://optional-url.com"
}
| Camp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
msg | string | Da | Text afisat in chat |
shortcut | string | Nu | Scurtatura iOS de executat |
data | object | array | Nu | Date trimise catre Scurtatura |
url | string | Nu | URL de deschis sau afisat |
Pentru automatizari cu mai multi pasi, returneaza un array de raspunsuri:
[
{ "msg": "Pasul 1...", "shortcut": "PrimaScurtatura" },
{ "msg": "Pasul 2...", "shortcut": "ADouaScurtatura", "data": { "input": "valoare" } }
]
6. Start Rapid cu Serverul Starter#
Foloseste sablonul de server starter pentru a incepe in cateva minute:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Editeaza .env cu tokenul tau secret
bun dev
Starterul include comenzi integrate (ping, hello, help, time) si exemple pentru declansarea Shortcuts. Vezi Referinta API pentru specificatia completa a protocolului.
7. Utilizarea SDK#
Instaleaza pachetul pockethook-sdk pentru a construi raspunsuri type-safe:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Raspuns text simplu
return toResponse(text("Salut de pe serverul meu!"));
// Declanseaza o Scurtatura
return toResponse(shortcut("Se executa...", "ScurtaturaMea", { cheie: "valoare" }));
// Automatizare cu mai multi pasi
return toResponse(responses([
{ msg: "Pasul 1", shortcut: "Prima" },
{ msg: "Pasul 2", shortcut: "ADoua" }
]));