1. Cai Dat PocketHook#
Tai PocketHook tu App Store va mo tren iPhone, iPad hoac Mac cua ban.
2. Cau Hinh May Chu Cua Ban#
PocketHook can mot HTTPS endpoint de giao tiep. Ban co the su dung:
- Agent Server — AI agent tu luu tru voi LLM, cong cu, tac vu nen va bo nho
- API cua ban — Bat ky may chu nao chap nhan yeu cau POST va tra ve JSON
- n8n — Tu dong hoa quy trinh lam viec tu luu tru voi webhook trigger
- OpenClaw — Tro ly AI tu luu tru voi nhan tin da kenh
Yeu Cau May Chu#
May chu cua ban phai:
- Chap nhan yeu cau POST voi noi dung JSON
- Tra ve phan hoi JSON
- Co the truy cap qua HTTPS (HTTP bi tu choi vi ly do bao mat)
- Tuy chon ho tro xac thuc Bearer token
3. Ket Noi Trong PocketHook#
- Mo PocketHook va di den Cai Dat
- Nhap URL May Chu cua ban (phai la HTTPS)
- Nhap Token Xac Thuc cua ban (neu may chu yeu cau xac thuc)
- Nhan Kiem Tra Ket Noi de xac minh
4. Dinh Dang Yeu Cau#
PocketHook gui tin nhan duoi dang mang JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "tin nhan cua ban o day"
}]
5. Dinh Dang Phan Hoi#
May chu cua ban nen phan hoi bang mot doi tuong JSON:
{
"msg": "Tin nhan hien thi cho nguoi dung",
"shortcut": "TenPhimTatTuychon",
"data": { "khoa": "gia_tri" },
"url": "https://optional-url.com"
}
| Truong | Kieu | Bat buoc | Mo ta |
|---|---|---|---|
msg | string | Co | Van ban hien thi trong chat |
shortcut | string | Khong | iOS Shortcut de thuc thi |
data | object | array | Khong | Du lieu truyen vao Shortcut |
url | string | Khong | URL de mo hoac hien thi |
Cho tu dong hoa nhieu buoc, tra ve mot mang phan hoi:
[
{ "msg": "Buoc 1...", "shortcut": "PhimTatDauTien" },
{ "msg": "Buoc 2...", "shortcut": "PhimTatThuHai", "data": { "input": "gia_tri" } }
]
6. Bat Dau Nhanh Voi Starter Server#
Su dung mau starter server cua chung toi de bat dau trong vai phut:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Chinh sua .env voi token bi mat cua ban
bun dev
Starter bao gom cac lenh tich hop san (ping, hello, help, time) va vi du kich hoat Shortcuts. Xem Tai lieu tham khao API de biet thong so ky thuat day du cua giao thuc.
7. Su Dung SDK#
Cai dat goi pockethook-sdk de xay dung phan hoi an toan ve kieu:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Phan hoi van ban don gian
return toResponse(text("Xin chao tu may chu cua toi!"));
// Kich hoat Shortcut
return toResponse(shortcut("Dang chay...", "PhimTatCuaToi", { khoa: "gia_tri" }));
// Tu dong hoa nhieu buoc
return toResponse(responses([
{ msg: "Buoc 1", shortcut: "DauTien" },
{ msg: "Buoc 2", shortcut: "ThuHai" }
]));