1. Instalează PocketHook#
Descarcă PocketHook din App Store și deschide-l pe iPhone, iPad sau Mac.
2. Configurează Serverul Tău#
PocketHook are nevoie de un endpoint HTTPS pentru a comunica. Poți folosi:
- Agent Server — Agent AI auto-găzduit cu LLM, instrumente, sarcini în fundal și memorie
- Propriul tău API — Orice server care acceptă cereri POST și returnează JSON
- n8n — Automatizare a fluxurilor de lucru auto-găzduită cu trigger webhook
- OpenClaw — Asistent AI auto-găzduit cu mesagerie multicanal
Cerințe Server#
Serverul tău trebuie să:
- Accepte cereri POST cu corp JSON
- Returneze răspunsuri JSON
- Fie accesibil prin HTTPS (HTTP este respins din motive de securitate)
- Opțional să suporte autentificarea Bearer token
3. Conectează-te în PocketHook#
- Deschide PocketHook și mergi la Setări
- Introdu URL-ul Serverului (trebuie să fie HTTPS)
- Introdu Tokenul de Autentificare (dacă serverul tău necesită autentificare)
- Apasă Testează Conexiunea pentru verificare
4. Formatul Cererii#
PocketHook trimite mesajele ca un array JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "mesajul tau aici"
}]
5. Formatul Răspunsului#
Serverul tău ar trebui să răspundă cu un obiect JSON:
{
"msg": "Mesaj afisat utilizatorului",
"shortcut": "NumeScurtatura Optionala",
"data": { "cheie": "valoare" },
"url": "https://optional-url.com"
}
| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
msg | string | Da | Text afișat în chat |
shortcut | string | Nu | Comanda rapidă iOS de executat |
data | object | array | Nu | Date trimise către comanda rapidă |
url | string | Nu | URL de deschis sau afișat |
Pentru automatizări cu mai mulți pași, returnează un array de răspunsuri:
[
{ "msg": "Pasul 1...", "shortcut": "PrimaScurtatura" },
{ "msg": "Pasul 2...", "shortcut": "ADouaScurtatura", "data": { "input": "valoare" } }
]
6. Start Rapid cu Serverul Starter#
Folosește șablonul de server starter pentru a începe în câteva 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) și exemple pentru declanșarea Shortcuts. Vezi Referința API pentru specificația completă a protocolului.
7. Utilizarea SDK#
Instalează pachetul pockethook-sdk pentru a construi răspunsuri 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" }
]));