PocketHook fornisce sei App Intents che si integrano con Siri e l’app Scorciatoie iOS. Puoi usarli per creare potenti automazioni attivate dalla voce, dall’ora, dalla posizione o da altri trigger iOS.
Invia messaggio#
Intent: SendMessageIntent
Invia un messaggio al tuo server e attendi opzionalmente la risposta.
| Parametro | Tipo | Descrizione |
|---|---|---|
| Messaggio | string | Il messaggio da inviare |
| Attendi risposta | boolean | Se true, attende fino a 5 minuti |
Esempio: “Ehi Siri, invia ‘controlla server’ con PocketHook”
Restituisce il testo di risposta del server se l’attesa è attiva.
Invia dati al server#
Intent: SendDataToServerIntent
Invia un messaggio al server silenziosamente — senza aggiungerlo alla cronologia della chat. Utile per automazioni in background.
| Parametro | Tipo | Descrizione |
|---|---|---|
| Messaggio | string | Il messaggio da inviare |
Esempio: Crea un’automazione Scorciatoie che si esegue ogni mattina e invia “daily-report” al tuo server.
Estrai messaggio#
Intent: ExtractMessageIntent
Estrae il campo msg da una stringa JSON di risposta PocketHook.
| Parametro | Tipo | Descrizione |
|---|---|---|
| JSON di risposta | string | La risposta JSON grezza |
Restituisce: La stringa msg dalla risposta.
Estrai dati#
Intent: ExtractDataIntent
Estrae l’oggetto data da una stringa JSON di risposta PocketHook.
| Parametro | Tipo | Descrizione |
|---|---|---|
| JSON di risposta | string | La risposta JSON grezza |
Restituisce: L’oggetto data come stringa JSON.
Estrai nome scorciatoia#
Intent: ExtractShortcutIntent
Estrae il nome del shortcut da una stringa JSON di risposta PocketHook.
| Parametro | Tipo | Descrizione |
|---|---|---|
| JSON di risposta | string | La risposta JSON grezza |
Restituisce: La stringa del nome della scorciatoia.
Aggiungi messaggio locale#
Intent: AddLocalMessageIntent
Aggiunge un messaggio alla cronologia locale della chat senza inviare nulla al server. Utile per registrare le automazioni localmente.
| Parametro | Tipo | Descrizione |
|---|---|---|
| Messaggio | string | Il testo del messaggio da aggiungere |
| Mittente | enum | user o server |
Creare automazioni con Scorciatoie#
Base: Invia e visualizza#
- Aggiungi l’azione Invia messaggio (attendi risposta: sì)
- Aggiungi Mostra risultato con l’output
Avanzato: Analizza e agisci#
- Invia messaggio → ottieni la risposta grezza
- Estrai dati → ottieni il payload dei dati
- Usa i dati estratti in altre azioni Scorciatoie (imposta luminosità, apri app, ecc.)
Automazione in background#
- Crea un’automazione Ora del giorno
- Aggiungi Invia dati al server con il tuo comando trigger
- Il server lo elabora e può attivare Scorciatoie di ritorno tramite PocketHook
Concatenamento con altre app#
Gli intent di PocketHook funzionano con qualsiasi azione Scorciatoie. Combinali con:
- Azioni Casa per controllare i dispositivi smart
- Calendario/Promemoria per leggere o creare eventi
- File per elaborare documenti
- Salute per registrare dati di allenamento
- Qualsiasi altra app compatibile con Scorciatoie