App Intents: интеграция Siri Shortcuts в iOS-приложение

App Intents iOS: почему приложение не видно в Siri и Shortcuts

Чаще всего проблема не в Siri и не в Shortcuts, а в том, что приложение физически не отдаёт системе свои сценарии. Пользователь открывает галерею быстрых команд, ищет вашу функцию — и не находит её; пробует вызвать голосом — Siri отвечает, что не знает такого действия. Поддержка получает однотипные обращения, хотя сама функция в приложении работает исправно.

Причина в том, что App Intents iOS — это не «включается само». Каждое действие нужно описать как отдельную сущность с параметрами и фразой-триггером, зарегистрировать её в описании приложения и корректно связать с кодом, который это действие выполняет. Если сущность объявлена, но не попала в сборку, если фразы не локализованы под язык устройства или параметры не помечены как обязательные — система молча пропускает сценарий. Ни ошибки, ни предупреждения: просто пустая галерея и неработающий голосовой запуск приложения.

Отдельная ловушка — фоновое выполнение. Siri запускает действие вне контекста открытого экрана, поэтому код, который в приложении опирается на текущее состояние интерфейса, в этом режиме падает или отрабатывает частично. Сценарий виден в Shortcuts, но при вызове ничего не происходит — и это снова обращение в поддержку.

Интеграция Siri Shortcuts ломается и на релизной сборке: в отладочной всё видно, а после публикации сценарии исчезают, потому что часть объявлений осталась в тестовой конфигурации. Разбираем, как это закрывается: от проектирования набора действий и фраз до проверки, что каждый сценарий действительно виден системе и запускается голосом на живом устройстве.

Что даёт интеграция: измеримые эффекты для продукта

Интеграция App Intents превращает функции приложения в действия, доступные системе: пользователь вызывает их голосом через Siri, из поиска, с экрана блокировки или автоматизаций, не открывая само приложение. Для продукта это не косметика, а другой путь к ключевым сценариям — короче на несколько шагов и без ручной навигации по экранам.

Первый измеримый эффект — доля сценариев, доступных голосом. Если в приложении есть повторяющиеся действия (заказ, статус, добавление записи, запуск трекинга), их перевод в App Intents закрывает заметную часть обращений без открытия интерфейса. Путь пользователя сокращается с типичных «открыть → найти раздел → заполнить → подтвердить» до одной фразы, а время до результата падает в разы — это видно по воронке и по числу завершённых действий на пользователя.

Второй эффект — метрики вовлечённости. Действия через Siri и системные подсказки возвращают в продукт тех, кто давно не открывал приложение: сценарий запускается из привычного места, а не через иконку. Растёт частота повторных действий и удержание, а нагрузка на поддержку снижается — типовые вопросы («как посмотреть статус», «где оформить») закрываются голосом без обращения к оператору.

Третий эффект — предсказуемость интеграции. App Intents описываются декларативно: система сама предлагает действия в нужный момент и подбирает формулировки, а приложение получает единый контракт для Siri, поиска и автоматизаций. Работаем на актуальной ветке Apple — сценарии остаются совместимыми с новыми версиями системы, а не ломаются при обновлении.

Способы интеграции: App Intents, Shortcuts и ручные сценарии

Голосовой запуск функций приложения реализуется тремя путями, и выбор между ними определяет, насколько глубоко сценарий встроится в систему. Нативные App Intents регистрируют действия прямо в оболочке: система сама показывает их в поиске, предлагает в нужный момент и передаёт параметры без участия пользователя. Классические Shortcuts работают через отдельное приложение-посредник — действие доступно, но требует, чтобы пользователь сначала собрал сценарий. Ручная настройка не даёт системной интеграции вовсе: функция вызывается только изнутри приложения.

Ключевое ограничение — обратная совместимость. App Intents раскрываются только на актуальной ветке системы, поэтому для парка старых устройств приходится держать параллельный слой на классических Shortcuts. Мы проектируем оба слоя так, чтобы логика действия описывалась один раз, а различалась лишь точка входа — иначе поведение расходится между версиями и поддержка дорожает.

Второе ограничение — доступ к данным. Голосовой вызов может сработать, когда приложение закрыто или экран заблокирован, и сценарий обязан корректно отработать без открытия интерфейса. Мы заранее определяем, какие действия безопасно выполнять в фоне, а какие требуют подтверждения, — это снимает класс отказов, когда команда запускается, но результат пользователь не видит.

Этапы внедрения App Intents в существующее приложение

Внедрение App Intents в работающее приложение — это не «добавить пару шорткатов», а перестройка части архитектуры под системные сценарии. Ниже — последовательность, по которой мы ведём такие проекты, чтобы интеграция не сломала существующие пользовательские пути и не потребовала переписывания через релиз.

1. Аудит сценариев и точек входа. Смотрим, какие действия пользователь реально совершает часто и что осмысленно выносить в Siri и «Команды»: создание записи, быстрый статус, повтор последнего действия. Отсекаем то, что не имеет смысла без контекста экрана.
2. Проектирование модели интентов. Определяем набор интентов, их параметры, типы сущностей и связи с доменной моделью приложения. На этом шаге фиксируем, какие данные уходят в систему, а какие остаются внутри — это влияет на приватность и на ревью.
3. Настройка и регистрация. Прописываем интенты в конфигурации приложения, описываем фразы активации, связываем с существующими сервисами и хранилищем. Здесь же закладываем обработку ошибок и понятные ответы, когда данных нет.
4. Проверка на устройствах. Тестируем не в симуляторе, а на живых устройствах: разные версии системы, режимы блокировки, отсутствие сети, отзыв разрешений. Проверяем, что вызов из Siri и из приложения «Команды» даёт одинаковый результат.
5. Обработка отказов и граничных состояний. Отдельно прогоняем сценарии, где пользователь не авторизован, где запись уже удалена, где интент вызван повторно. Без этого интеграция выглядит рабочей на демо и рассыпается в реальном использовании.
6. Документация и передача. Отдаём команде заказчика схему интентов, список поддерживаемых фраз, инструкцию по добавлению новых действий и чек-лист проверки перед релизом.

Каждый этап заканчивается артефактом, который можно проверить: карта сценариев, спецификация интентов, отчёт по тестам на устройствах. Так интеграция остаётся управляемой, а не превращается в набор точечных правок.

Что заказчик получает на руки после интеграции

Интеграция App Intents — это не только код в проекте. Чтобы сценарии работали предсказуемо и их можно было развивать без автора, мы передаём заказчику полный комплект артефактов.

• Описание модели интентов — какие действия приложения открыты для Siri и системы, какие параметры принимает каждый интент, какие типы данных возвращает и как связаны между собой.
• Конфигурации и разрешения — состав capabilities, entitlements и настроек проекта, необходимых для работы интентов, с пояснением, что и зачем включено.
• Схемы сценариев — карты пользовательских путей: как фраза превращается в вызов интента, где срабатывает диалог уточнения, что происходит при отсутствии данных.
• Регламенты поддержки — порядок добавления новых интентов, правила версионирования фраз и параметров, чек-лист проверки перед релизом.
• Документация для команды — инструкция по локальному запуску и отладке сценариев, описание точек расширения и типовых ошибок с причинами.
• Набор тестовых сценариев — перечень проверок для ручного и автоматического прогона, включая граничные случаи и поведение без сети.
• Матрица совместимости — на каких версиях системы и типах устройств сценарии доступны, а где деградируют до запасного поведения.

Каждый артефакт привязан к реальному коду и обновляется вместе с ним — документация не расходится с приложением после первого же релиза. Так команда заказчика может сама добавлять интенты, не возвращаясь к нам за каждой правкой.

Опишите задачу — вернёмся с оценкой и планом по объёму этих артефактов под ваш проект.

Кейс: как голосовые сценарии изменили работу приложения

Клиент — сервис доставки продуктов с приложением на iOS — пришёл с конкретной жалобой: доля повторных заказов падала, а аналитика показывала, что пользователи открывают приложение, добираются до каталога и уходят, не оформив заказ. Путь до повторной покупки занимал 6-7 экранов: найти приложение, дождаться загрузки, вспомнить, что заказывали в прошлый раз, собрать корзину заново. Для сценария «заказать то же, что и неделю назад» это неоправданно долго, и часть аудитории просто откладывала покупку.

Мы внедрили голосовые сценарии на базе App Intents: пользователь произносит «повторить последний заказ» или «добавить молоко в корзину», и система выполняет действие без открытия приложения. Интенты описывают доменные действия — повтор заказа, добавление позиции, статус доставки, — а система сама предлагает их в нужный момент: утром, по дороге домой, после предыдущей покупки. Отдельно настроили передачу параметров, чтобы голосовая команда подставляла конкретный товар, а не открывала пустой экран.

Что изменилось в метриках

Рост дал не сам голосовой ввод, а сокращение пути: там, где раньше нужно было вспоминать и собирать корзину, теперь достаточно одной фразы. Сценарии работают и на заблокированном экране, и через системного ассистента — приложение перестало быть обязательной точкой входа.

Почему это сработало

Ключевым оказался не интерфейс, а связка интентов с историей заказов: система предлагает действие тогда, когда оно уместно, а не когда пользователь сам вспомнил о приложении. Мы вынесли логику повторного заказа в отдельный слой, чтобы её могли переиспользовать и голосовые сценарии, и виджеты, и уведомления. Такой подход Apple продвигает через App Intents — действия приложения становятся доступны системе, а не только внутри самого приложения.

Через три месяца после запуска доля заказов, оформленных без открытия приложения, стабилизировалась на уровне пятой части — это не разовый всплеск, а новый канал. Если у вас похожий сценарий с повторными действиями, разберём, какие интенты дадут эффект именно в вашем приложении.

Чем App Intents отличаются от классических Shortcuts?

Классические Shortcuts — это пользовательские сценарии, которые человек собирает сам в приложении «Команды» из готовых действий. Приложение в этой схеме лишь отдаёт наружу набор операций через расширение, а логику связки шагов, условия и порядок вызовов определяет пользователь. Отсюда и ограничения: сценарий живёт в устройстве конкретного человека, не переносится между пользователями автоматически и не знает контекста системы — что открыто на экране, какой язык, какое время суток.

App Intents меняют роль приложения: оно само объявляет системе, что умеет, а система решает, когда это уместно предложить. Интент описывает не «кнопку», а намерение с параметрами и типами — система понимает, что «добавить задачу» требует текста, а «показать маршрут» — адреса. Дальше сценарий может собираться не только вручную: система подставляет действия в поиск, в подсказки на экране блокировки, в голосовой вызов и в автоматизации. Разница именно в том, кто владеет логикой — пользователь или платформа.

По гибкости сценариев выигрыш тоже структурный. Один интент с параметрами заменяет десяток жёстко зашитых действий: пользователь комбинирует их между собой и с действиями других приложений, а система сама разрешает зависимости по типам данных. Классические Shortcuts так не умеют — там каждая связка проектируется под конкретный сценарий, и добавление нового варианта означает новое действие.

Поддержка системой — ключевое отличие в долгую. App Intents развиваются как основной механизм интеграции: новые возможности платформы появляются сначала здесь, а старые расширения остаются в режиме совместимости. Для приложения это значит, что вложения в интенты не придётся переписывать при следующем обновлении системы, тогда как сценарии на устаревшем расширении постепенно теряют доступ к новым точкам входа.

По трудозатратам на поддержку разница проявляется на дистанции. Классический подход дешевле на старте — быстро выкатили набор действий и закрыли задачу. App Intents требуют аккуратной модели данных: типы параметров, описания, обработка ошибок, локализация фраз. Зато дальше добавление сценария — это чаще новый параметр, а не новый код, и тестировать приходится одно поведение вместо набора пользовательских связок.

Частые технические сомнения перед стартом

Перед стартом почти каждая команда задаёт один и тот же набор вопросов: не сломает ли интеграция текущий релиз, что с поддержкой старых устройств и сколько кода придётся переписать. Ниже — ответы по существу, без общих слов.

Придётся ли переписывать существующий код?

Нет. Интенты — это отдельный слой поверх логики, а не замена. Мы выносим нужные действия в интенты, которые вызывают уже существующие методы приложения: авторизацию, работу с данными, сетевые запросы. Ядро не трогаем, поэтому риски для текущего функционала минимальны, а регресс ограничивается новыми сценариями. Если логика была жёстко связана с интерфейсом, её аккуратно разделяют — это и есть основной объём доработок.

Насколько это большая доработка по срокам?

Объём зависит от числа сценариев, а не от самой технологии. Один-два интента — это точечная задача, которая не задерживает релиз. Полноценный набор с голосовыми фразами, параметрами и виджетами — отдельный этап, который планируется заранее. Мы всегда начинаем с одного сценария, проверяем его на реальных пользователях и только потом расширяем.

Что с поддержкой и обновлениями системы?

Apple периодически меняет требования к интентам и добавляет новые типы. Мы закладываем совместимость так, чтобы выход очередной версии системы не ломал уже работающие сценарии, и сопровождаем интеграцию вместе с приложением. Это часть поддержки, а не разовая настройка.

Если остались сомнения по вашей кодовой базе — опишите задачу, вернёмся с оценкой и планом.

Обсудим вашу задачу по интеграции App Intents

Чтобы оценка интеграции App Intents была предметной, а не «на глаз», нам нужны исходные данные по приложению и сценариям, которые вы хотите вывести в Siri и системные шорткаты. Чем точнее вводные, тем меньше допущений в плане и тем предсказуемее сроки. Ниже — что уточняем и в каком виде присылать.

• Сценарии пользователя. Список действий, которые должны запускаться голосом или из шорткатов: что открыть, что создать, какие параметры передаются. Опишите фразы, которыми люди реально будут это вызывать.
• Текущая архитектура. Как устроено приложение: язык, слои, где живёт бизнес-логика, есть ли фоновая обработка. От этого зависит, выносим ли мы логику в отдельный модуль или переиспользуем существующий.
• Модель данных и права доступа. Какие сущности участвуют в сценариях, где хранятся, что нужно отдавать наружу через App Intents, а что остаётся закрытым.
• Целевые версии системы. Минимальная поддерживаемая версия iOS и доля устройств на ней — определяет, какие возможности App Intents доступны, а какие придётся обходить.
• Сценарии отказа. Что должно происходить, если действие нельзя выполнить: показать уведомление, предложить альтернативу, тихо завершиться. Это влияет на объём работы.
• Доступы и окружение. Тестовые сборки, учётные записи, доступ к репозиторию и системам аналитики — без них не проверим сценарии на реальных устройствах.

По этим пунктам мы возвращаемся с оценкой и планом: разбивка на этапы, что делаем в первую очередь, где риски и как проверяем результат. Следующий шаг — короткий разбор задачи: опишите приложение и сценарии, а мы уточним недостающее и предложим порядок работ.