# Библиотека запросов AI Assistant
Четкие, конкретные запросы помогают [AI Assistant](/ru/product/pushwoosh-ai/ai-assistant/) давать точные, релевантные и полезные ответы. Используйте следующие стратегии и примеры, чтобы улучшить результаты. Примеры запросов сгруппированы по задачам так же, как предложенные запросы в новом диалоге: **Creation**, **Analysis** и **Configuration**.
## Стратегии и лучшие практики составления запросов
| Делайте | Не делайте | Почему |
| :---- | :---- | :---- |
| Конкретно формулируйте, что вам нужно | Давайте расплывчатые инструкции | Четкие запросы дают точные результаты |
| Указывайте идентификаторы (коды приложений, названия кампаний, UUID Journey, названия сегментов) | Ссылайтесь на ресурсы расплывчато | AI Assistant находит нужный объект |
| Пишите подробные запросы с контекстом, ожидаемым результатом и ограничениями | Отправляйте запросы в одну строку | Больше контекста — меньше уточняющих итераций |
| Используйте единообразные названия для событий, Journey, тегов и кампаний | Смешивайте разные правила именования | Это избавляет от путаницы, когда AI Assistant ищет объекты |
| Добавляйте понятные описания к пользовательским событиям, сегментам и тегам | Оставляйте их без описания | Это помогает AI Assistant правильно их интерпретировать |
| Проверяйте результат после каждого действия или ответа | Считайте, что все сработало | Ошибки выявляются до того, как начнут накапливаться |
| Читайте каждый шаг, прежде чем двигаться дальше, особенно при необратимых изменениях | Торопитесь при многошаговых действиях | Необратимые изменения нужно проверить до того, как они произойдут |
| Читайте причину на карточке решения (Decision card), прежде чем подтвердить ее | Подтверждайте, не читая | Карточка — ваш последний шанс заметить ошибку |
### Эффективные и менее эффективные запросы
| Эффективный запрос | Менее эффективный запрос |
| :---- | :---- |
| *«Создай сегмент для пользователей, которые бросили корзину за последние 7 дней».* | *«Почини мои пуши».* |
| *«Покажи статистику push-уведомлений для кампании "Летняя распродажа" с 1 по 15 июня».* | *«Покажи статистику».* |
| *«Помоги разобраться, почему мои push-уведомления на iOS не доставляются».* | *«Что-то не так».* |
| *«Journey "Приветственный поток" (UUID: abc-123) перестал отправлять email вчера в 15:00».* | *«Мой Journey не работает».* |
| *«Создай сегмент для пользователей, которые просмотрели товар, но не совершили покупку за последние 14 дней. Цель — отправить им последующее email-сообщение».* | *«Помоги нацелиться на пользователей».* |
## Создание
Создавайте что-то новое. Собственные стартовые запросы чата в этой категории: *"Build a complete marketing strategy"*, *"Create an onboarding journey"*, *"Create a re-engagement push campaign"*.
### Сегменты и аудитория
> *«Создай сегмент пользователей, которые не открывали приложение последние 30 дней и совершили хотя бы одну покупку в прошлом, исключая тех, кто отписался от уведомлений».*
**Что делает AI Assistant:** создает сегмент с описанными условиями фильтрации.
**Что проверить:** убедитесь, что размер сегмента выглядит правдоподобно и что исключенные пользователи (в данном случае отписавшиеся) действительно исключены.
### Customer Journey
##### Создание Journey по описанию
> *«Создай Journey, который начинается, когда клиент добавляет обувь в корзину и уходит, не совершив покупку.*
>
> *Подожди 1 час, чтобы проверить, произошла ли покупка. Если да, отправь благодарственное сообщение и заверши Journey. Если нет, отправь первое напоминание и подожди еще 23 часа.*
>
> *Если клиент совершит покупку в этот период, отправь благодарственное сообщение и заверши Journey. Если он все еще не купил, отправь второе напоминание со скидкой, подожди еще 1 час, а затем заверши Journey».*
**Что делает AI Assistant:** создает полный Journey с описанной логикой ветвления.
**Что проверить:** откройте Journey в конструкторе и убедитесь, что ветки, задержки и сообщения соответствуют вашему замыслу, прежде чем активировать его.
##### Редактирование уже созданного Journey
В том же диалоге попросите изменить Journey. AI Assistant редактирует существующий Journey и его сообщения, а не создает новые.
> *«Теперь измени скидку во втором напоминании с 10% на 15%».*
**Что делает AI Assistant:** показывает карточку решения с таблицей «до/после» именно для того, что меняется (заголовок push-уведомления, текст push-уведомления, название шага), и отмечает, что нужно проверить: новый промокод должен существовать в вашем магазине, а большая скидка снижает маржу с каждого заказа. Ничего не меняется, пока вы не подтвердите.
**Что проверить:** откройте Journey и убедитесь, что в нем по-прежнему те же два сообщения и изменился только контент второго.
Если Journey уже запущен, сначала приостановите его. AI Assistant не может редактировать запущенный Journey, а пока он приостановлен, пользователи ничего не получают, поэтому запланируйте правку на спокойное время.
### Контент
##### Генерация шаблона email
> *«Создай контент email для интернет-магазина, нацеленный на реактивацию прошлых покупателей с помощью специальных стимулов, таких как скидки или эксклюзивные предложения. Цель — поощрить повторные покупки и вернуть клиентов, которые давно не делали покупок. Сосредоточься на четком, убедительном сообщении, которое подчеркивает ценность предложения и содержит сильный призыв к действию».*
**Что делает AI Assistant:** сохраняет сгенерированный email как шаблон и отвечает ссылкой для его открытия в редакторе email. Сам он не добавляет изображения, но это может сделать панель **Generate with AI** блока изображения в редакторе по короткому описанию, которое вы там напишете.
**Что проверить:** просмотрите текст, изображения и ссылки в редакторе, прежде чем отправлять тестовое сообщение.
##### Редактирование существующего шаблона email
Когда шаблон уже создан, вам не нужно создавать его заново, чтобы внести изменения. Попросите AI Assistant отредактировать определенные части (контентные блоки, тему, прехедер, отправителя или палитру), и он обновит сохраненный шаблон на месте.
> *«В шаблоне email "Win-back: 20% off for returning customers" измени тему письма, чтобы она прямее упоминала скидку 20%, и замени карточку "Free gift wrapping" новой — о простом возврате без лишних хлопот».*
**Что делает AI Assistant:** предлагает оба изменения в одной карточке решения, где расписаны старая и новая темы письма и текст заменяемой карточки. Шаблон обновляется после вашего подтверждения. Остальной контент остается нетронутым.
**Что проверить:** убедитесь, что тема письма и замененная карточка выглядят правильно и что больше ничего в шаблоне не изменилось.
### In-App сообщения и Rich Media
> *«Создай In-App сообщение, которое показывается при запуске приложения, с заголовком "С возвращением!", кнопкой закрытия и одной CTA-кнопкой с надписью "Посмотреть новинки", ведущей на главный экран приложения».*
**Что делает AI Assistant:** предлагает карточку решения с полным контентом и макетом, в которой отмечены угаданные значения (например, deep link), чтобы вы их подтвердили. In-App сохраняется после вашего подтверждения. Его никто не увидит, пока он не будет привязан к триггеру, например к событию запуска приложения в Journey. AI Assistant не добавляет изображения в In-App. Поле Image в самом редакторе принимает только URL или файл из медиахранилища, встроенного генератора в нем нет.
**Что проверить:** убедитесь, что контент и все ссылки верны, затем привяжите сообщение к триггеру, чтобы оно могло дойти до пользователей.
### Ваучеры и промокоды
> *«Создай пул ваучеров с названием "Весенняя распродажа" с 10 одноразовыми промокодами без срока действия».*
**Что делает AI Assistant:** создает пул напрямую, без карточки решения. AI Assistant сам генерирует коды (или использует те, что вы перечислили в запросе), а затем сообщает их вместе с количеством еще неиспользованных. Pushwoosh гарантирует, что каждый код достанется только одному пользователю. Pushwoosh не отслеживает, был ли код действительно использован, поэтому обеспечивать однократное погашение должны ваше оформление заказа или бэкенд.
**Что проверить:** убедитесь, что в пуле ожидаемое количество кодов, прежде чем использовать его в сообщении или Journey.
### Геозоны
> *«Создай круглую геозону с названием "Магазин в центре" с центром в точке [широта], [долгота] и радиусом 500 метров».*
**Что делает AI Assistant:** создает геозону напрямую, без карточки решения, и сообщает ее статус и радиус действия. Сообщение необязательно. Без него зона генерирует событие `PW_GeozoneEntered`, когда устройство входит в нее. Используйте это событие для запуска Journey и выберите в нем сообщение и аудиторию. API требует минимальный интервал между повторными входами (cooldown), значения по умолчанию нет. Если вы его не укажете, AI Assistant выберет значение сам, а не оставит его пустым, чтобы человек, задержавшийся у границы зоны, не вызывал ее срабатывание снова и снова.
**Что проверить:** убедитесь, что местоположение и радиус соответствуют вашему замыслу, а у приложения есть разрешение на доступ к геолокации и в SDK включена функция геолокации. Координата, равная ровно 0 (точка на экваторе или нулевом меридиане), сейчас отклоняется как отсутствующая.
## Анализ
Исследуйте данные. Стартовые запросы: *"Diagnose underperforming campaigns"*, *"Analyze revenue by segment and channel"*, *"Find drop-off points in user journey"*.
### Аналитика и дашборды
##### Получение отчета об эффективности кампаний
> *«Сформируй подробный отчет о показателях доставки, открытий и кликабельности для всех кампаний push-уведомлений, запущенных в этом приложении, с разбивкой по типу кампании и содержанию сообщения».*
**Что делает AI Assistant:** возвращает отчет с разбивкой по типу кампании и содержанию сообщения, с показателями доставки, открытий и кликабельности для каждой, и отмечает найденные по ходу оговорки о качестве данных, например, что CTR push-уведомлений рассчитывается по открытиям (в Pushwoosh нет отдельного счетчика кликов по push-уведомлениям) или что число доставок занижено из-за отсутствующей настройки iOS.
**Что проверить:** выборочно сверьте пару кампаний с цифрами, которые вы уже знаете.
##### Создание дашборда
> *«Создай дашборд только для этой In-App кампании: показы, клики по нижней кнопке и выполнения события X уникальными пользователями».*
**Что делает AI Assistant:** уточняет, какой In-App вы имеете в виду, и реальное название события, если чего-то из этого не хватает, предупреждает, что дашборды не могут фильтровать напрямую по In-App или считать клики по отдельной кнопке, а затем создает максимально близкий вариант: три запрошенные метрики в виде виджетов (для метрики кликов по кнопке используется приближенный показатель «interactions»), а также график тренда.
**Что проверить:** убедитесь, что дашборд ограничен только этим In-App и что виджет interactions не учитывается повторно как точный клик по кнопке.
##### Пересчет сегмента
> *«Пересчитай сегмент "High-value churners" и скажи, сколько пользователей в него сейчас входит».*
**Что делает AI Assistant:** запускает пересчет и сообщает обновленное число пользователей, когда он будет готов.
**Что проверить:** сравните новое число с ожидаемым с учетом недавней активности.
### Анализ дохода
##### Расчет роста неделя к неделе
> *«Получи данные о доставках и доходе за последние 30 дней и рассчитай рост неделя к неделе».*
**Что делает AI Assistant:** возвращает итоговые показатели доставок и дохода за период, а также темп роста неделя к неделе, если в аккаунте есть данные о доходе для его расчета. Если ничего не отслеживается (нет подключенного платежного провайдера, не срабатывает ни одно событие с доходом), он сообщает об этом вместо того, чтобы выдавать показатель.
**Что проверить:** убедитесь, что диапазон дат соответствует запрошенному.
##### Сравнение Journey с его контрольной группой
> *«Сравни доход этого Journey с его контрольной группой».*
**Что делает AI Assistant:** проверяет, есть ли у Journey собственное разделение на holdout и настроено ли событие с доходом. Если чего-то из этого нет, он точно объясняет, что нужно добавить, а не угадывает результат. Если в аккаунте есть только контрольная группа на уровне всего аккаунта, он поясняет, что такая группа измеряет весь маркетинг сразу и не заменяет holdout на уровне Journey.
**Что проверить:** убедитесь в проценте holdout и в том, что он привязан к самому Journey, а не опирается только на контрольную группу всего аккаунта.
##### Поиск кампаний без дохода
> *«Найди кампании за последние 30 дней, которые не принесли никакого дохода».*
**Что делает AI Assistant:** перед ответом проверяет, отслеживается ли доход вообще. Если нет, под условие формально подошла бы каждая кампания, поэтому он сообщает о пробеле в отслеживании и о реальной активности отправок в аккаунте вместо бессмысленного списка «все кампании».
**Что проверить:** если отслеживание дохода уже настроено, убедитесь в диапазоне дат и в том, что приостановленные кампании и черновики не включены, если вы о них не просили.
### Стратегия аккаунта
> *«Проанализируй мой аккаунт и предложи план, ориентированный на доход: целевые сегменты, каналы и график кампаний».*
**Что делает AI Assistant:** прежде чем строить план, проверяет аккаунт на то, что может мешать доходу (пробелы в отслеживании, недоступная аудитория, пустые сегменты). Если проверка проходит без замечаний, как в этом примере, он сразу переходит к тому, на какие сегменты нацеливаться, какие каналы использовать, и к графику кампаний, чтобы вы проверили все это, прежде чем действовать.
**Что проверить:** убедитесь, что предложенные сегменты и график соответствуют вашим текущим кампаниям, и устраните пробелы в данных, отмеченные аудитом, прежде чем доверять последующим цифрам.
## Настройка
Настраивайте что-либо. Стартовые запросы: *"Set up mobile SDK (iOS/Android)"*, *"Set up web SDK"*, *"Set up email sending"*.
### Настройки доставки
> *«Установи для этого приложения frequency capping для push-уведомлений: 1 сообщение на пользователя в неделю».*
**Что делает AI Assistant:** предлагает в виде карточки решения новый лимит frequency capping для push-уведомлений для всего приложения. Лимит меняется после вашего подтверждения. Frequency capping применяется на уровне приложения и канала, а не сегмента или кампании.
**Что проверить:** убедитесь в новом лимите в настройках frequency capping приложения и проверьте, что он не лишает многошаговый Journey его последующих сообщений.
### Тестовые устройства
> *«Зарегистрируй мой телефон как тестовое устройство для тестирования push-уведомлений на iOS».*
**Что делает AI Assistant:** включает **Add test devices from the app** на странице **Test Devices** на 1 час. Оставшееся время отображается рядом с переключателем. Пока опция включена, одного открытия приложения недостаточно: сверните приложение и снова откройте его 6 раз в течение 30 секунд, и телефон зарегистрируется сам. Если вы уже знаете push-токен телефона или ID устройства (HWID), добавьте его в запрос, и AI Assistant зарегистрирует устройство напрямую.
**Что проверить:** убедитесь, что новое устройство появилось в списке тестовых устройств с правильной платформой.
### Интеграции
> *«Создай интеграцию с вебхуком, которая отправляет запрос на [URL вашего сервера] при отправке сообщения».*
**Что делает AI Assistant:** сначала проверяет текущую настройку вебхука в приложении, поскольку у каждого приложения он только один и создание нового заменяет его, затем предлагает карточку решения с целевым URL, охватываемыми событиями и состоянием заголовка авторизации. Если что-то будет перезаписано, на карточке об этом сказано. Интеграция начинает срабатывать только после вашего подтверждения.
**Что проверить:** убедитесь, что целевой URL, охватываемые события и область действия (все сообщения или определенные) соответствуют вашему замыслу, и добавьте заголовок авторизации, если ваш сервер должен проверять, что вызовы действительно приходят от Pushwoosh.
### Пользователи и доступ
> *«Пригласи [email] в этот аккаунт с доступом [группа]».*
**Что делает AI Assistant:** предлагает карточку решения с названием группы, которую назначает приглашение. Права задаются на уровне группы, у каждой группы есть права See, Modify и Send push для каждого приложения. Группа — это не фиксированная роль с жестко заданными возможностями, поэтому то, что группа может делать на самом деле, зависит от того, как она настроена в вашем аккаунте. Письмо с приглашением отправляется только после вашего подтверждения.
**Что проверить:** откройте права группы (как на скриншоте выше) и убедитесь, что See, Modify и Send push настроены для этого человека так, как вам нужно, для каждого приложения.
### Поддержка
> *«Создай тикет в поддержку по этой проблеме и добавь в него подробности из этого диалога».*
**Что делает AI Assistant:** создает тикет в поддержку и подтверждает его отправку — это альтернатива самостоятельному переходу в [службу поддержки Pushwoosh](https://help.pushwoosh.com/hc/en-us/requests/new).
**Что проверить:** запишите номер тикета. Дальше с вами свяжется служба поддержки Pushwoosh.
## Связанные материалы
Для диагностики конкретной проблемы, например остановившегося Journey или неудачной доставки, см. [Устранение неполадок с помощью AI Assistant](/ru/product/pushwoosh-ai/troubleshoot-with-ai/) — там собраны шаблоны запросов, сгруппированные по типам проблем.