1. ติดตั้ง PocketHook#
ดาวน์โหลด PocketHook จาก App Store แล้วเปิดบน iPhone, iPad หรือ Mac ของคุณ
2. กำหนดค่าเซิร์ฟเวอร์ของคุณ#
PocketHook ต้องการ HTTPS endpoint เพื่อสื่อสาร คุณสามารถใช้:
- Agent Server — AI agent แบบโฮสต์เองพร้อม LLM, เครื่องมือ, งานเบื้องหลัง และหน่วยความจำ
- API ของคุณเอง — เซิร์ฟเวอร์ใดก็ได้ที่รับ POST request และส่งกลับ JSON
- n8n — ระบบอัตโนมัติเวิร์กโฟลว์แบบโฮสต์เองพร้อมตัวกระตุ้น webhook
- OpenClaw — AI assistant แบบโฮสต์เองพร้อมระบบส่งข้อความหลายช่องทาง
ข้อกำหนดเซิร์ฟเวอร์#
เซิร์ฟเวอร์ของคุณต้อง:
- รับ POST request พร้อม JSON body
- ส่งกลับ JSON response
- เข้าถึงได้ผ่าน HTTPS (HTTP ถูกปฏิเสธเพื่อความปลอดภัย)
- รองรับการยืนยันตัวตน Bearer token (ทางเลือก)
3. เชื่อมต่อใน PocketHook#
- เปิด PocketHook แล้วไปที่ การตั้งค่า
- ป้อน URL เซิร์ฟเวอร์ ของคุณ (ต้องเป็น HTTPS)
- ป้อน โทเค็นยืนยันตัวตน ของคุณ (ถ้าเซิร์ฟเวอร์ต้องการการยืนยันตัวตน)
- แตะ ทดสอบการเชื่อมต่อ เพื่อตรวจสอบ
4. รูปแบบ Request#
PocketHook ส่งข้อความเป็น JSON array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "ข้อความของคุณที่นี่"
}]
5. รูปแบบ Response#
เซิร์ฟเวอร์ของคุณควรตอบกลับด้วย JSON object:
{
"msg": "ข้อความที่แสดงให้ผู้ใช้",
"shortcut": "ชื่อคำสั่งลัดทางเลือก",
"data": { "คีย์": "ค่า" },
"url": "https://optional-url.com"
}
| ฟิลด์ | ชนิด | จำเป็น | คำอธิบาย |
|---|---|---|---|
msg | string | ใช่ | ข้อความที่แสดงในแชท |
shortcut | string | ไม่ | iOS Shortcut ที่จะดำเนินการ |
data | object | array | ไม่ | ข้อมูลที่ส่งไปยัง Shortcut |
url | string | ไม่ | URL ที่จะเปิดหรือแสดง |
สำหรับระบบอัตโนมัติหลายขั้นตอน ส่งกลับ array ของ response:
[
{ "msg": "ขั้นตอน 1...", "shortcut": "คำสั่งลัดแรก" },
{ "msg": "ขั้นตอน 2...", "shortcut": "คำสั่งลัดที่สอง", "data": { "input": "ค่า" } }
]
6. เริ่มต้นอย่างรวดเร็วด้วย Starter Server#
ใช้ เทมเพลต starter server ของเราเพื่อเริ่มต้นในไม่กี่นาที:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# แก้ไข .env ด้วยโทเค็นลับของคุณ
bun dev
Starter รวมคำสั่งในตัว (ping, hello, help, time) และตัวอย่างสำหรับการเรียกใช้ Shortcuts ดู เอกสารอ้างอิง API สำหรับข้อกำหนดโปรโตคอลฉบับเต็ม
7. การใช้ SDK#
ติดตั้งแพ็กเกจ pockethook-sdk เพื่อสร้าง response ที่ type-safe:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Response ข้อความอย่างง่าย
return toResponse(text("สวัสดีจากเซิร์ฟเวอร์ของฉัน!"));
// เรียกใช้ Shortcut
return toResponse(shortcut("กำลังดำเนินการ...", "คำสั่งลัดของฉัน", { คีย์: "ค่า" }));
// ระบบอัตโนมัติหลายขั้นตอน
return toResponse(responses([
{ msg: "ขั้นตอน 1", shortcut: "แรก" },
{ msg: "ขั้นตอน 2", shortcut: "ที่สอง" }
]));