1. PocketHook’u Kurun#
PocketHook’u App Store‘dan indirin ve iPhone, iPad veya Mac’inizde açın.
2. Sunucunuzu Yapılandırın#
PocketHook iletişim için bir HTTPS endpoint’e ihtiyaç duyar. Şunları kullanabilirsiniz:
- Agent Server — LLM, araçlar, arka plan görevleri ve bellek ile kendi barındırdığınız AI ajanı
- Kendi API’niz — POST isteklerini kabul eden ve JSON döndüren herhangi bir sunucu
- n8n — Webhook tetikleyicili kendi barındırdığınız iş akışı otomasyonu
- OpenClaw — Çok kanallı mesajlaşma ile kendi barındırdığınız AI asistanı
Sunucu Gereksinimleri#
Sunucunuz:
- JSON gövdeli POST isteklerini kabul etmeli
- JSON yanıtlar döndürmeli
- HTTPS üzerinden erişilebilir olmalı (HTTP güvenlik nedeniyle reddedilir)
- İsteğe bağlı olarak Bearer token kimlik doğrulamasını desteklemeli
3. PocketHook’ta Bağlanın#
- PocketHook’u açın ve Ayarlar‘a gidin
- Sunucu URL’nizi girin (HTTPS olmalı)
- Kimlik Doğrulama Token’ınızı girin (sunucunuz kimlik doğrulama gerektiriyorsa)
- Doğrulamak için Bağlantı Testi’ne dokunun
4. İstek Formatı#
PocketHook mesajları JSON dizisi olarak gönderir:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "mesajiniz buraya"
}]
5. Yanıt Formatı#
Sunucunuz bir JSON nesnesiyle yanıt vermeli:
{
"msg": "Kullaniciya gosterilen mesaj",
"shortcut": "IstegeBasliKisayolAdi",
"data": { "anahtar": "deger" },
"url": "https://optional-url.com"
}
| Alan | Tip | Zorunlu | Açıklama |
|---|---|---|---|
msg | string | Evet | Sohbette gösterilen metin |
shortcut | string | Hayır | Çalıştırılacak iOS Shortcut |
data | object | array | Hayır | Shortcut’a iletilen veri |
url | string | Hayır | Açılacak veya gösterilecek URL |
Çok adımlı otomasyonlar için bir yanıt dizisi döndürün:
[
{ "msg": "Adim 1...", "shortcut": "IlkKisayol" },
{ "msg": "Adim 2...", "shortcut": "IkinciKisayol", "data": { "input": "deger" } }
]
6. Starter Sunucuyla Hızlı Başlangıç#
Dakikalar içinde başlamak için starter sunucu şablonumuzu kullanın:
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, yerleşik komutlar (ping, hello, help, time) ve Shortcuts tetikleme örnekleri içerir. Tam protokol spesifikasyonu için API Referansı’na bakın.
7. SDK Kullanımı#
Tip-güvenli yanıtlar oluşturmak için 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" }
]));