1. Instal PocketHook#
Unduh PocketHook dari App Store dan buka di iPhone, iPad, atau Mac Anda.
2. Konfigurasi Server Anda#
PocketHook memerlukan endpoint HTTPS untuk berkomunikasi. Anda dapat menggunakan:
- Agent Server — Agen AI self-hosted dengan LLM, alat, tugas latar belakang, dan memori
- API Anda sendiri — Server apa pun yang menerima permintaan POST dan mengembalikan JSON
- n8n — Otomatisasi alur kerja self-hosted dengan pemicu webhook
- OpenClaw — Asisten AI self-hosted dengan pesan multisaluran
Persyaratan Server#
Server Anda harus:
- Menerima permintaan POST dengan body JSON
- Mengembalikan respons JSON
- Dapat diakses melalui HTTPS (HTTP ditolak demi keamanan)
- Opsional mendukung autentikasi Bearer token
3. Hubungkan di PocketHook#
- Buka PocketHook dan buka Pengaturan
- Masukkan URL Server Anda (harus HTTPS)
- Masukkan Token Auth Anda (jika server Anda memerlukan autentikasi)
- Ketuk Uji Koneksi untuk memverifikasi
4. Format Permintaan#
PocketHook mengirim pesan sebagai array JSON:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "pesan Anda di sini"
}]
5. Format Respons#
Server Anda harus merespons dengan objek JSON:
{
"msg": "Pesan ditampilkan kepada pengguna",
"shortcut": "NamaPintasanOpsional",
"data": { "kunci": "nilai" },
"url": "https://optional-url.com"
}
| Bidang | Tipe | Wajib | Deskripsi |
|---|---|---|---|
msg | string | Ya | Teks yang ditampilkan di chat |
shortcut | string | Tidak | Pintasan iOS untuk dijalankan |
data | object | array | Tidak | Data yang diteruskan ke Pintasan |
url | string | Tidak | URL untuk dibuka atau ditampilkan |
Untuk otomatisasi multi-langkah, kembalikan array respons:
[
{ "msg": "Langkah 1...", "shortcut": "PintasanPertama" },
{ "msg": "Langkah 2...", "shortcut": "PintasanKedua", "data": { "input": "nilai" } }
]
6. Mulai Cepat dengan Server Starter#
Gunakan template server starter kami untuk mulai dalam hitungan menit:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Edit .env dengan token rahasia Anda
bun dev
Starter mencakup perintah bawaan (ping, hello, help, time) dan contoh untuk memicu Shortcuts. Lihat Referensi API untuk spesifikasi protokol lengkap.
7. Menggunakan SDK#
Instal paket pockethook-sdk untuk membangun respons yang type-safe:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Respons teks sederhana
return toResponse(text("Halo dari server saya!"));
// Memicu Pintasan
return toResponse(shortcut("Menjalankan...", "PintasanSaya", { kunci: "nilai" }));
// Otomatisasi multi-langkah
return toResponse(responses([
{ msg: "Langkah 1", shortcut: "Pertama" },
{ msg: "Langkah 2", shortcut: "Kedua" }
]));