1. Εγκατασταση PocketHook#
Κατεβαστε το PocketHook απο το App Store και ανοιξτε το στο iPhone, iPad η Mac σας.
2. Ρυθμιση του Διακομιστη σας#
Το PocketHook χρειαζεται ενα HTTPS endpoint για επικοινωνια. Μπορειτε να χρησιμοποιησετε:
- Agent Server — Αυτοφιλοξενουμενος AI agent με LLM, εργαλεια, εργασιες παρασκηνιου και μνημη
- Το δικο σας API — Οποιοσδηποτε διακομιστης που δεχεται POST αιτηματα και επιστρεφει JSON
- n8n — Αυτοφιλοξενουμενη αυτοματοποιηση ροων εργασιας με webhook trigger
- OpenClaw — Αυτοφιλοξενουμενος AI βοηθος με πολυκαναλη αποστολη μηνυματων
Απαιτησεις Διακομιστη#
Ο διακομιστης σας πρεπει να:
- Δεχεται αιτηματα POST με JSON body
- Επιστρεφει απαντησεις JSON
- Ειναι προσβασιμος μεσω HTTPS (το HTTP απορριπτεται για λογους ασφαλειας)
- Προαιρετικα να υποστηριζει Bearer token αυθεντικοποιηση
3. Συνδεση στο PocketHook#
- Ανοιξτε το PocketHook και μεταβειτε στις Ρυθμισεις
- Εισαγετε τη Διευθυνση URL Διακομιστη (πρεπει να ειναι HTTPS)
- Εισαγετε το Token Αυθεντικοποιησης (αν ο διακομιστης σας απαιτει αυθεντικοποιηση)
- Πατηστε Δοκιμη Συνδεσης για επαληθευση
4. Μορφη Αιτηματος#
Το PocketHook στελνει μηνυματα ως JSON array:
[{
"sessionId": "uuid-v4",
"action": "sendMessage",
"chatInput": "το μηνυμα σας εδω"
}]
5. Μορφη Απαντησης#
Ο διακομιστης σας πρεπει να απαντα με ενα JSON αντικειμενο:
{
"msg": "Μηνυμα που εμφανιζεται στον χρηστη",
"shortcut": "ΠροαιρετικοΟνομαΣυντομευσης",
"data": { "κλειδι": "τιμη" },
"url": "https://optional-url.com"
}
| Πεδιο | Τυπος | Απαιτειται | Περιγραφη |
|---|---|---|---|
msg | string | Ναι | Κειμενο που εμφανιζεται στη συνομιλια |
shortcut | string | Οχι | iOS Shortcut προς εκτελεση |
data | object | array | Οχι | Δεδομενα που περνουν στο Shortcut |
url | string | Οχι | URL για ανοιγμα η εμφανιση |
Για αυτοματοποιησεις πολλαπλων βηματων, επιστρεψτε ενα array απαντησεων:
[
{ "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 με το μυστικο token σας
bun dev
Ο starter περιλαμβανει ενσωματωμενες εντολες (ping, hello, help, time) και παραδειγματα για ενεργοποιηση Shortcuts. Δειτε την Αναφορα API για την πληρη προδιαγραφη πρωτοκολλου.
7. Χρηση του SDK#
Εγκαταστηστε το πακετο pockethook-sdk για τη δημιουργια τυπικα ασφαλων απαντησεων:
bun add pockethook-sdk
import { text, shortcut, responses, toResponse } from "pockethook-sdk";
// Απλη απαντηση κειμενου
return toResponse(text("Γεια απο τον διακομιστη μου!"));
// Ενεργοποιηση Shortcut
return toResponse(shortcut("Εκτελεση...", "ΗΣυντομευσηΜου", { κλειδι: "τιμη" }));
// Αυτοματοποιηση πολλαπλων βηματων
return toResponse(responses([
{ msg: "Βημα 1", shortcut: "Πρωτη" },
{ msg: "Βημα 2", shortcut: "Δευτερη" }
]));