1. Cài Đặt PocketHook#
Tải PocketHook từ App Store và mở trên iPhone, iPad hoặc Mac của bạn.
2. Cấu Hình Máy Chủ Của Bạn#
PocketHook cần một HTTPS endpoint để giao tiếp. Bạn có thể sử dụng:
- Agent Server — AI agent tự lưu trữ với LLM, công cụ, tác vụ nền và bộ nhớ
- API của bạn — Bất kỳ máy chủ nào chấp nhận yêu cầu POST và trả về JSON
- n8n — Tự động hóa quy trình làm việc tự lưu trữ với webhook trigger
- OpenClaw — Trợ lý AI tự lưu trữ với nhắn tin đa kênh
Yêu Cầu Máy Chủ#
Máy chủ của bạn phải:
- Chấp nhận yêu cầu POST với nội dung JSON
- Trả về phản hồi JSON
- Có thể truy cập qua HTTPS (HTTP bị từ chối vì lý do bảo mật)
- Tùy chọn hỗ trợ xác thực Bearer token
3. Kết Nối Trong PocketHook#
- Mở PocketHook và đi đến Cài Đặt
- Nhập URL Máy Chủ của bạn (phải là HTTPS)
- Nhập Token Xác Thực của bạn (nếu máy chủ yêu cầu xác thực)
- Nhấn Kiểm Tra Kết Nối để xác minh
4. Định Dạng Yêu Cầu#
PocketHook gửi tin nhắn dưới dạng mảng JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "tin nhan cua ban o day"
}]
5. Định Dạng Phản Hồi#
Máy chủ của bạn nên phản hồi bằng một đối tượng JSON:
{
"msg": "Tin nhan hien thi cho nguoi dung",
"shortcut": "TenPhimTatTuychon",
"data": { "khoa": "gia_tri" },
"url": "https://optional-url.com"
}
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
msg | string | Có | Văn bản hiển thị trong chat |
shortcut | string | Không | Phím tắt iOS cần thực thi |
data | object | array | Không | Dữ liệu truyền vào Phím tắt |
url | string | Không | URL để mở hoặc hiển thị |
Đối với tự động hóa nhiều bước, trả về một mảng phản hồi:
[
{ "msg": "Buoc 1...", "shortcut": "PhimTatDauTien" },
{ "msg": "Buoc 2...", "shortcut": "PhimTatThuHai", "data": { "input": "gia_tri" } }
]
6. Bắt Đầu Nhanh Với Starter Server#
Sử dụng mẫu starter server của chúng tôi để bắt đầu trong vài phút:
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 gồm các lệnh tích hợp sẵn (ping, hello, help, time) và ví dụ kích hoạt Shortcuts. Xem Tài liệu tham khảo API để biết thông số kỹ thuật đầy đủ của giao thức.
7. Sử Dụng SDK#
Cài đặt gói pockethook-sdk để xây dựng phản hồi an toàn về kiểu:
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" }
]));