Zum Hauptinhalt springen
  1. Dokumentation/

Siri & App Intents

PocketHook bietet sechs App Intents, die sich mit Siri und der iOS-Kurzbefehle-App integrieren. Sie können damit leistungsfähige Automatisierungen erstellen, die per Sprache, Zeit, Standort oder anderen iOS-Auslösern gestartet werden.

Nachricht senden
#

Intent: SendMessageIntent

Senden Sie eine Nachricht an Ihren Server und warten Sie optional auf die Antwort.

ParameterTypBeschreibung
NachrichtstringDie zu sendende Nachricht
Auf Antwort wartenbooleanWenn aktiviert, wartet bis zu 5 Minuten

Beispiel: “Hey Siri, sende ‘Server prüfen’ mit PocketHook”

Gibt den Antworttext des Servers zurück, wenn das Warten aktiviert ist.

Daten an Server senden
#

Intent: SendDataToServerIntent

Senden Sie eine Nachricht still an Ihren Server — ohne sie zum Chatverlauf hinzuzufügen. Nützlich für Hintergrundautomatisierungen.

ParameterTypBeschreibung
NachrichtstringDie zu sendende Nachricht

Beispiel: Erstellen Sie eine Kurzbefehle-Automatisierung, die jeden Morgen läuft und “daily-report” an Ihren Server sendet.

Nachricht extrahieren
#

Intent: ExtractMessageIntent

Extrahiert das Feld msg aus einem PocketHook-Antwort-JSON-String.

ParameterTypBeschreibung
Antwort-JSONstringDie rohe JSON-Antwort

Gibt zurück: Den msg-String aus der Antwort.

Daten extrahieren
#

Intent: ExtractDataIntent

Extrahiert das data-Objekt aus einem PocketHook-Antwort-JSON-String.

ParameterTypBeschreibung
Antwort-JSONstringDie rohe JSON-Antwort

Gibt zurück: Das data-Objekt als JSON-String.

Kurzbefehl-Namen extrahieren
#

Intent: ExtractShortcutIntent

Extrahiert den shortcut-Namen aus einem PocketHook-Antwort-JSON-String.

ParameterTypBeschreibung
Antwort-JSONstringDie rohe JSON-Antwort

Gibt zurück: Den Kurzbefehl-Namensstring.

Lokale Nachricht hinzufügen
#

Intent: AddLocalMessageIntent

Fügt eine Nachricht zum lokalen Chatverlauf hinzu, ohne etwas an den Server zu senden. Nützlich zur lokalen Protokollierung von Automatisierungen.

ParameterTypBeschreibung
NachrichtstringDer hinzuzufügende Nachrichtentext
Absenderenumuser oder server

Kurzbefehle-Automatisierungen erstellen
#

Einfach: Senden und Anzeigen
#

  1. Fügen Sie die Aktion Nachricht senden hinzu (auf Antwort warten: ein)
  2. Fügen Sie Ergebnis anzeigen mit der Ausgabe hinzu

Fortgeschritten: Analysieren und Handeln
#

  1. Nachricht senden → Rohantwort erhalten
  2. Daten extrahieren → Datenpaket erhalten
  3. Die extrahierten Daten in anderen Kurzbefehle-Aktionen verwenden (Helligkeit einstellen, App öffnen usw.)

Hintergrundautomatisierung
#

  1. Erstellen Sie eine Tageszeit-Automatisierung
  2. Fügen Sie Daten an Server senden mit Ihrem Auslösebefehl hinzu
  3. Der Server verarbeitet es und kann über PocketHook Kurzbefehle zurückauslösen

Verkettung mit anderen Apps
#

PocketHook-Intents funktionieren mit jeder Kurzbefehle-Aktion. Kombinieren Sie sie mit:

  • Home-Aktionen zur Steuerung smarter Geräte
  • Kalender/Erinnerungen zum Lesen oder Erstellen von Ereignissen
  • Dateien zur Verarbeitung von Dokumenten
  • Health zur Protokollierung von Trainingsdaten
  • Jeder anderen Kurzbefehle-kompatiblen App