1. Asenna PocketHook#
Lataa PocketHook App Storesta ja avaa se iPhonella, iPadilla tai Macilla.
2. Maarita palvelimesi#
PocketHook tarvitsee HTTPS-paatepisteen viestintaan. Voit kayttaa:
- Agent Server — Itse isannoity AI-agentti LLM:lla, tyokaluilla, taustatoilla ja muistilla
- Oma API — Mika tahansa palvelin, joka hyvaksyy POST-pyynrot ja palauttaa JSON-muotoista dataa
- n8n — Itse isannoitu tyonkulun automatisointi webhook-triggerilla
- OpenClaw — Itse isannoity AI-avustaja monikanavaisella viestinnalla
Palvelimen vaatimukset#
Palvelimesi taytyy:
- Hyvaksya POST-pyynnot JSON-sisallolla
- Palauttaa JSON-vastauksia
- Olla saavutettavissa HTTPS:n kautta (HTTP hylataan turvallisuussyista)
- Valinnaisesti tukea Bearer token -todennusta
3. Yhdista PocketHookissa#
- Avaa PocketHook ja siirry kohtaan Asetukset
- Syota Palvelimen URL (taytyy olla HTTPS)
- Syota Todennustoken (jos palvelimesi vaatii todennusta)
- Napauta Testaa yhteys vahvistaaksesi
4. Pyyntomuoto#
PocketHook lahettaa viestit JSON-taulukkona:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "viestisi tahan"
}]
5. Vastausmuoto#
Palvelimesi tulee vastata JSON-objektilla:
{
"msg": "Kayttajalle naytettava viesti",
"shortcut": "ValinnainenOikotieName",
"data": { "avain": "arvo" },
"url": "https://optional-url.com"
}
| Kentta | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
msg | string | Kylla | Chatissa naytettava teksti |
shortcut | string | Ei | Suoritettava iOS Shortcut |
data | object | array | Ei | Shortcutille valitettava data |
url | string | Ei | Avattava tai naytettava URL |
Monivaiheisiin automaatioihin palauta taulukko vastauksista:
[
{ "msg": "Vaihe 1...", "shortcut": "EnsimmainenOikotie" },
{ "msg": "Vaihe 2...", "shortcut": "ToinenOikotie", "data": { "input": "arvo" } }
]
6. Pikaaloitus Starter-palvelimella#
Kayta starter-palvelinmalliamme paastaksesi alkuun minuuteissa:
git clone https://github.com/pockethook-app/pockethook-server.git
cd pockethook-server
bun install
cp .env.example .env
# Muokkaa .env salaisella tokenillasi
bun dev
Starter sisaltaa sisaanrakennetut komennot (ping, hello, help, time) ja esimerkkeja Shortcuts-pikakomentojen kaynnistamiseen. Katso API-viite taydellistae protokollamaarittelya varten.
7. SDK:n kayttaminen#
Asenna pockethook-sdk-paketti tyyppiturvallisten vastausten rakentamiseen:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Yksinkertainen tekstivastaus
return toResponse(text("Hei palvelimeltani!"));
// Kaynnista Shortcut
return toResponse(shortcut("Suoritetaan...", "OmaOikotie", { avain: "arvo" }));
// Monivaiheinen automaatio
return toResponse(responses([
{ msg: "Vaihe 1", shortcut: "Ensimmainen" },
{ msg: "Vaihe 2", shortcut: "Toinen" }
]));