Довідник налаштувань

Синхронізація

#

PocketHook синхронізує ваші розмови та налаштування застосунку між пристроями, використовуючи ваш приватний обліковий запис iCloud — без облікового запису PocketHook, без стороннього сервера.

Увійдіть у той самий обліковий запис iCloud на iPhone, iPad і Mac — і все з’явиться автоматично, без додаткового налаштування. Ваші дані залишаються у вашій власній приватній базі даних iCloud; сервери PocketHook ніколи їх не бачать.

Налаштування сервера

#

Основні параметри з’єднання з вашим сервером PocketHook.

URL сервера

#

HTTPS-ендпоінт, на який PocketHook надсилає ваші повідомлення з чату. Приймаються лише HTTPS-адреси — HTTP відхиляється з міркувань безпеки. Це основний ендпоінт, який прослуховує ваш сервер.

Токен автентифікації

#

Bearer-токен, що надсилається в заголовку Authorization з кожним запитом. Ваш сервер може використовувати його, щоб перевірити, що запити надходять з вашого пристрою. Зберігається безпечно в iOS Keychain — ніколи у відкритому вигляді.

Сумісність з OpenClaw

#

Увімкніть, якщо ваш сервер використовує платформу OpenClaw або будь-який OpenAI-сумісний Chat Completions API. Коли увімкнено, PocketHook надсилає повідомлення у форматі чату OpenAI та розбирає у відповіді вбудовані маркери команд ([SHORTCUT:name], [DATA:{...}], [URL:...]). До запитів додається заголовок x-openclaw-agent-id.

Перевірка з’єднання

#

Кнопка, що надсилає тестовий запит на налаштований сервер. Показує:

• Час відповіді в мілісекундах
• Результат Health Check (якщо увімкнено)
• Деталі помилки, якщо з’єднання не вдалося

Використовуйте її після зміни URL сервера чи токена автентифікації, щоб переконатися, що все працює.

Мережа

#

Точне налаштування тайм-аутів для різних типів операцій.

Тайм-аут запиту

#

Скільки часу PocketHook чекає, поки сервер почне відповідати на запит. Якщо ваш сервер виконує важку обробку (наприклад, звертається до ШІ-моделі), збільште це значення. Для простих вебхук-серверів типових 5 секунд зазвичай достатньо.

Тайм-аут ресурсу

#

Максимальний час для завершення всієї відповіді, включно з передачею даних. Має бути більшим за тайм-аут запиту. Збільште, якщо сервер повертає великі обсяги даних або має повільну швидкість передачі.

Health Check

#

Вмикає моніторинг стану сервера. Коли активний, PocketHook під час перевірки з’єднання надсилає GET-запит на URL Health Check і показує, чи повідомляє сервер про свою працездатність.

URL Health Check

#

Окремий HTTPS-ендпоінт, що повертає простий текст true або false. Цей URL опитується під час перевірки з’єднання, щоб підтвердити, що сервер працює. Корисно, коли основний API-ендпоінт закритий автентифікацією, але потрібна проста перевірка стану.

Автоматизація

#

Керує тим, як PocketHook виконує швидкі команди iOS, що запускаються відповідями сервера.

Швидкі команди iOS

#

Головний перемикач виконання швидких команд. Коли він OFF, PocketHook і далі показує повідомлення сервера, але ігнорує поля shortcut у відповідях. Корисно для налагодження або тимчасового вимкнення автоматизацій.

Затримка між командами

#

Час очікування між виконанням послідовних команд, коли сервер повертає кілька автоматизацій в одній відповіді. Збільште, якщо ваші команди залежать одна від одної (наприклад, перша команда створює файл, який читає друга).

Тайм-аут команди

#

Максимальний час очікування завершення кожної окремої команди, після якого PocketHook вважає її простроченою. Тривалим командам (наприклад, тим, що обробляють медіафайли чи роблять кілька API-викликів) може знадобитися всі 5 хвилин.

Персональний інтерфейс

#

Вбудуйте власний вебінтерфейс безпосередньо в PocketHook.

Персональний інтерфейс

#

Показує окрему вкладку з вбудованим вебпереглядом. Коли увімкнено, у головній навігації з’являється нова вкладка, де відображається ваша вебсторінка. Сторінка попередньо завантажується для миттєвого показу та підтримує оновлення жестом «потягнути вниз».

URL персонального інтерфейсу

#

URL, що відображається у вкладці персонального інтерфейсу. Приймаються і HTTP, і HTTPS (рекомендовано HTTPS). Це може бути дашборд, адмін-панель або будь-яка вебсторінка, до якої ви хочете мати швидкий доступ поруч із чатом.

Посилання

#

Налаштуйте, як PocketHook обробляє URL з відповідей сервера.

Вкладка «Посилання»

#

Показує або приховує вкладку «Посилання» в головній навігації. Коли увімкнено, всі URL, отримані з відповідей сервера, зберігаються та відображаються в окремій вкладці з розширеними попередніми переглядами посилань, пошуком і можливістю видалення.

Автовідкриття URL

#

Коли увімкнено, PocketHook автоматично відкриває URL з відповідей сервера у вашому типовому браузері. Коли вимкнено, URL все одно зберігаються у вкладці «Посилання» (якщо вона увімкнена), але не відкриваються автоматично.

Це налаштування навмисно є індивідуальним для кожного пристрою: можливо, ви захочете, щоб посилання відкривалися автоматично на iPhone, але не на Mac. Натискання на плашку посилання під повідомленням завжди відкриває його, незалежно від цього налаштування.

Мова

#

Налаштуйте мову застосунку та диктування.

Мова застосунку

#

Перевизначає мову інтерфейсу застосунку незалежно від мови пристрою. Якщо вибрано «Системна», PocketHook дотримується мовних налаштувань iOS.

Мова диктування

#

Мова голосового диктування (перетворення мовлення на текст) у полі введення чату. Доступні мови:

Фонові завдання

#

Періодична перевірка наявності відкладених завдань, навіть коли застосунок у фоні.

Фонові завдання

#

Вмикає фонове опитування. Коли активне, PocketHook періодично надсилає GET-запит на URL опитування. Якщо відповідь — true, під час відкриття застосунку на основний сервер надсилається повідомлення-запит. Потрібен дозвіл на сповіщення, щоб повідомляти вас про відкладені завдання.

Інтервал перевірки

#

Як часто PocketHook перевіряє URL опитування у фоні. Коротші інтервали означають швидше виявлення відкладених завдань, але більшу витрату батареї. iOS може коригувати фактичну частоту залежно від характеру використання пристрою.

URL опитування

#

HTTPS-ендпоінт, який PocketHook опитує із заданим інтервалом. Має повертати простий текст true (є завдання) або false (завдань немає). Це легка перевірка — сервер повинен відповідати швидко, без важкої обробки.

Agent Server: використовуйте https://your-host/jobs (підставте свій хост і порт).

Повідомлення-запит

#

Повідомлення, що надсилається на основний сервер, коли фонова перевірка знаходить відкладені завдання і застосунок відкривається. Відповідь сервера з’являється в чаті як звичайне повідомлення. Налаштуйте його, щоб запускати потрібну поведінку на боці сервера.

Керування даними

#

Відстежуйте та керуйте збереженими повідомленнями.

Збережені повідомлення

#

Показує, скільки повідомлень наразі збережено. Індикатор має кольорове кодування:

• Зелений — менше 70% ємності
• Помаранчевий — 70–90% ємності
• Червоний — понад 90% ємності

Коли досягнуто ліміту в 500 повідомлень, найстаріші автоматично видаляються, звільняючи місце для нових.

Експорт розмови

#

Кнопка, що експортує всі збережені повідомлення у файл JSON через системне меню «Поділитися» iOS. Файл можна зберегти, передати через AirDrop або поділитися ним з будь-яким застосунком. Корисно для резервного копіювання розмов чи аналізу історії повідомлень.

Видалити всі повідомлення

#

Деструктивна кнопка, що безповоротно видаляє всі збережені повідомлення. Потребує підтвердження перед виконанням. Цю дію не можна скасувати.

Про застосунок

#

Інформація про вашу інсталяцію PocketHook (лише читання).