1. PocketHook’u Kurun#
PocketHook’u App Store‘dan indirin ve iPhone, iPad veya Mac’inizde acin.
2. Sunucunuzu Yapilandirin#
PocketHook iletisim icin bir HTTPS endpoint’e ihtiyac duyar. Sunlari kullanabilirsiniz:
- Agent Server — LLM, araclar, arka plan gorevleri ve bellek ile kendi barindirdiginiz AI ajani
- Kendi API’niz — POST isteklerini kabul eden ve JSON donduren herhangi bir sunucu
- n8n — Webhook tetikleyicili kendi barindirdiginiz is akisi otomasyonu
- OpenClaw — Cok kanalli mesajlasma ile kendi barindirdiginiz AI asistani
Sunucu Gereksinimleri#
Sunucunuz:
- JSON govdeli POST isteklerini kabul etmeli
- JSON yanitlar dondurmeli
- HTTPS uzerinden erisilebilir olmali (HTTP guvenlik nedeniyle reddedilir)
- Istege bagli olarak Bearer token kimlik dogrulamasini desteklemeli
3. PocketHook’ta Baglanin#
- PocketHook’u acin ve Ayarlar‘a gidin
- Sunucu URL’nizi girin (HTTPS olmali)
- Kimlik Dogrulama Token’inizi girin (sunucunuz kimlik dogrulama gerektiriyorsa)
- Dogrulamak icin Baglanti Testi’ne dokunun
4. Istek Formati#
PocketHook mesajlari JSON dizisi olarak gonderir:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "mesajiniz buraya"
}]
5. Yanit Formati#
Sunucunuz bir JSON nesnesiyle yanit vermeli:
{
"msg": "Kullaniciya gosterilen mesaj",
"shortcut": "IstegeBasliKisayolAdi",
"data": { "anahtar": "deger" },
"url": "https://optional-url.com"
}
| Alan | Tip | Zorunlu | Aciklama |
|---|---|---|---|
msg | string | Evet | Sohbette gosterilen metin |
shortcut | string | Hayir | Calistirilacak iOS Shortcut |
data | object | array | Hayir | Shortcut’a iletilen veri |
url | string | Hayir | Acilacak veya gosterilecek URL |
Cok adimli otomasyonlar icin bir yanit dizisi dondurun:
[
{ "msg": "Adim 1...", "shortcut": "IlkKisayol" },
{ "msg": "Adim 2...", "shortcut": "IkinciKisayol", "data": { "input": "deger" } }
]
6. Starter Sunucuyla Hizli Baslangic#
Dakikalar icinde baslamak icin starter sunucu sablonumuzu kullanin:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# .env dosyasini gizli token'inizle duzenleyin
bun dev
Starter, yerlesik komutlar (ping, hello, help, time) ve Shortcuts tetikleme ornekleri icerir. Tam protokol spesifikasyonu icin API Referansi’na bakin.
7. SDK Kullanimi#
Tip-guvenli yanitlar olusturmak icin pockethook-sdk paketini kurun:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Basit metin yaniti
return toResponse(text("Sunucumdan merhaba!"));
// Bir Shortcut tetikle
return toResponse(shortcut("Calistiriliyor...", "BenimKisayolum", { anahtar: "deger" }));
// Cok adimli otomasyon
return toResponse(responses([
{ msg: "Adim 1", shortcut: "Birinci" },
{ msg: "Adim 2", shortcut: "Ikinci" }
]));