Скилл агента для Adapty Mail
Скилл adapty-mail управляет вашим проектом Adapty Mail из AI-инструмента для разработки. Он работает через MCP-сервер Adapty Mail, авторизованный от вашего имени. Запускает флоу, переводит кампании, проводит отправляющий домен через DNS и верификацию, читает результаты кампаний и A/B-тестов, а также выясняет, почему пользователь не получил письмо.
The MCP server alone gives your agent the tools. The skill adds what an agent gets wrong without it:
- Подключение сервера: проверяет, подключён ли сервер и выполнен ли вход. Если нет — даёт инструкцию по настройке для вашего клиента.
- Почта или остальные функции Adapty: флоу, сегменты и профили означают разные вещи в Adapty Mail и в пейволах Adapty. Скилл уточняет, что именно вы имеете в виду, прежде чем вносить какие-либо изменения.
- Что доступно только в дашборде: скилл сообщит, когда запрос требует указания адреса компании, настройки веб-чекаута или включения отправки данных, и приводит ссылку на соответствующую страницу.
- Работа после запуска: результаты, A/B-тесты, доставляемость и отслеживание пропавшего письма.
Ничего не дойдёт до реальных пользователей без вашего подтверждения. Сохранение флоу запускает отправку, а список сегментов, сохранённых во флоу, полностью заменяет предыдущий — поэтому скилл сначала показывает флоу в том виде, каким он будет: каждый сегмент, каждая кампания и всё, что будет удалено. Удаления, отписки, а также запуск и завершение A/B-тестов тоже ждут вашего подтверждения.
Установка скилла
Скилл adapty-mail входит в состав плагина adapty-skills.
Для установки плагина выполните в терминале команду:
npx adapty skills install
Перезапустите агент, чтобы загрузить скиллы. Другие способы установки описаны в README плагина.
Claude Code не обновляет плагин автоматически. Чтобы получать новые скиллы по мере их выхода, запустите в Claude Code команду /plugin, откройте Marketplaces, выберите adapty и нажмите Enable auto-update. Команду обновления для других агентов см. в README плагина.
Скиллу нужен MCP-сервер Adapty Mail. Если у вашего агента его ещё нет, попросите его подключить Adapty Mail. Скилл предоставит команду для вашего клиента, а вы подтвердите подключение в дашборде Adapty Mail. Шаги для каждого клиента описаны в разделе Управление Adapty Mail с помощью ИИ-ассистентов.
Что можно спросить
- «Подключи Adapty Mail и покажи, чего не хватает в моём проекте.»
- «Настрой win-back флоу для пользователей, у которых истекла подписка.»
- «Переведи мою кампанию про проблемы с оплатой на немецкий и испанский.»
- «Добавь наш домен как отправляющий и объясни, что делать с DNS-записями.»
- «Какие из моих кампаний лучше всего конвертировали в прошлом месяце?»
- «Мой A/B-тест на флоу для тех, кто ещё ничего не купил, идёт уже три недели. Какой вариант должен победить?»
- «Почему этот пользователь не получил письмо об истечении триала?»
Вызвано 6 инструментов Adapty Mail
whoamiproject_listcontainer_listcampaign_listsegment_metasegment_create
Я создал сегмент для Германии и поставил его выше сегмента «Все пользователи» в вашем флоу «Не совершавшие покупок», чтобы остальные пользователи по-прежнему получали то, что получают сейчас.
Ваш флоу сегодня содержит две строки: пользователи с платным триалом получают Trial nudge, а все остальные — Welcome series. Германия вставляется между ними. Пользователь из Германии, у которого при этом есть платный триал, всё равно получит Trial nudge — строки проверяются сверху вниз.
Flow: Never purchased, marketing
1. Paid trial users → Trial nudge (unchanged)
2. Germany → Welcome series DE (new)
3. All users → Welcome series (moved from 2)
Removed: nothingПосле сохранения рассылка уйдёт реальным пользователям. Сохранить?
- Да, сохранить флоу
- Нет, сначала изменить что-то
Как это работает
- Подключение. Скилл проверяет, что MCP-сервер отвечает и что вы авторизованы.
- Ориентация. Он находит ваш проект и считывает всё, что уже настроено: бренд, адрес компании, домен отправки, кампании, флоу и время последнего поступления данных. Всё существующее он использует повторно.
- Планирование. Он заранее перечисляет всё, что перед началом работы нужно сделать только вам — в дашборде.
- Действие. Он последовательно вызывает инструменты сервера и показывает результат каждого шага. Всё, что отправляет письма реальным людям или не может быть отменено, ждёт вашего подтверждения.
Почему письмо не было отправлено
Когда вы спрашиваете о конкретном пользователе, скилл читает его профиль и историю, затем проверяет следующие причины по порядку и останавливается на первой, которая объясняет проблему:
- Профиль заблокирован: отписался, письмо вернулось, пришла жалоба или адрес не прошёл верификацию. См. Отписка и блокировки.
- Пользователь уже находится в другом маркетинговом флоу.
- Пользователь совершил покупку, и последовательность завершилась штатно.
- Лимиты отправки удержали письмо во время прогрева домена.
- Триггер не сработал. Либо никакие события покупки не поступают в Adapty Mail, либо профиль появился раньше, чем была завершена настройка.
- Ни один сегмент в флоу не совпал с этим пользователем.
- Включён double opt-in, и пользователь не подтвердил адрес.
- Письмо ещё ожидает отправки в рамках временно́го окна для часового пояса пользователя.
Вызваны 3 read-only инструмента Adapty Mail
profile_listprofile_getprofile_journey
Этот адрес отписался 12 октября, поэтому Adapty Mail больше не отправляет ему маркетинговые письма.
Отписка пришла по ссылке во втором письме кампании Trial expired. Триал закончился 15 октября, поэтому флоу для этого пользователя так и не стартовал. Письма с подтверждением покупок и другие транзакционные письма до адреса доходят.
Снять блокировку может только поддержка Adapty, и только по запросу самого пользователя, который отписался.