PocketHook предоставляет шесть App Intents, которые интегрируются с Siri и приложением «Быстрые команды» iOS. Вы можете использовать их для создания мощных автоматизаций, запускаемых голосом, временем, местоположением или другими триггерами iOS.
Отправить сообщение#
Intent: SendMessageIntent
Отправляет сообщение на ваш сервер и опционально ожидает ответа.
| Параметр | Тип | Описание |
|---|---|---|
| Сообщение | string | Сообщение для отправки |
| Ожидать ответа | boolean | Если true, ожидает до 5 минут |
Пример: «Привет, Siri, отправь ‘проверить серверы’ через PocketHook»
Возвращает текст ответа сервера, если ожидание включено.
Отправить данные на сервер#
Intent: SendDataToServerIntent
Отправляет сообщение на сервер без добавления в историю чата. Полезно для фоновых автоматизаций.
| Параметр | Тип | Описание |
|---|---|---|
| Сообщение | string | Сообщение для отправки |
Пример: Создайте автоматизацию быстрых команд, которая запускается каждое утро и отправляет «daily-report» на сервер.
Извлечь сообщение#
Intent: ExtractMessageIntent
Извлекает поле msg из JSON-строки ответа PocketHook.
| Параметр | Тип | Описание |
|---|---|---|
| JSON ответа | string | Исходный JSON-ответ |
Возвращает: Строку msg из ответа.
Извлечь данные#
Intent: ExtractDataIntent
Извлекает объект data из JSON-строки ответа PocketHook.
| Параметр | Тип | Описание |
|---|---|---|
| JSON ответа | string | Исходный JSON-ответ |
Возвращает: Объект data в виде JSON-строки.
Извлечь имя быстрой команды#
Intent: ExtractShortcutIntent
Извлекает имя shortcut из JSON-строки ответа PocketHook.
| Параметр | Тип | Описание |
|---|---|---|
| JSON ответа | string | Исходный JSON-ответ |
Возвращает: Строку с именем быстрой команды.
Добавить локальное сообщение#
Intent: AddLocalMessageIntent
Добавляет сообщение в локальную историю чата без отправки на сервер. Полезно для локального протоколирования автоматизаций.
| Параметр | Тип | Описание |
|---|---|---|
| Сообщение | string | Текст сообщения для добавления |
| Отправитель | enum | user или server |
Создание автоматизаций с быстрыми командами#
Базовый: Отправить и показать#
- Добавьте действие Отправить сообщение (ожидать ответа: вкл)
- Добавьте Показать результат с выходными данными
Продвинутый: Разобрать и действовать#
- Отправить сообщение → получить необработанный ответ
- Извлечь данные → получить полезную нагрузку данных
- Использовать извлечённые данные в других действиях быстрых команд (настроить яркость, открыть приложение и т.д.)
Фоновая автоматизация#
- Создайте автоматизацию Время суток
- Добавьте Отправить данные на сервер с вашей командой-триггером
- Сервер обрабатывает и может запустить быстрые команды обратно через PocketHook
Связывание с другими приложениями#
Интенты PocketHook работают с любым действием быстрых команд. Комбинируйте их с:
- Действиями Дом для управления умными устройствами
- Календарь/Напоминания для чтения или создания событий
- Файлы для обработки документов
- Здоровье для записи данных о тренировках
- Любым другим приложением, совместимым с быстрыми командами