---
title: "Скилл агента для Adapty Mail"
description: "Установите скилл adapty-mail, чтобы ваш AI-инструмент для разработки подключился к MCP-серверу Adapty Mail, запускал email-флоу и объяснял, почему письмо не было отправлено."
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

Скилл adapty-mail управляет вашим проектом Adapty Mail из AI-инструмента для разработки. Он работает через [MCP-сервер Adapty Mail](mail-mcp), авторизованный от вашего имени. Запускает флоу, переводит кампании, проводит отправляющий домен через 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-тесты, доставляемость и отслеживание пропавшего письма.

:::note
Ничего не дойдёт до реальных пользователей без вашего подтверждения. Сохранение флоу запускает отправку, а список сегментов, сохранённых во флоу, полностью заменяет предыдущий — поэтому скилл сначала показывает флоу в том виде, каким он будет: каждый сегмент, каждая кампания и всё, что будет удалено. Удаления, отписки, а также запуск и завершение A/B-тестов тоже ждут вашего подтверждения.
:::

## Установка скилла \{#install-the-skill\}

Скилл adapty-mail входит в состав плагина [`adapty-skills`](https://github.com/adaptyteam/adapty-skills).

Для установки плагина выполните в терминале команду:

```bash
npx adapty skills install
```

Перезапустите агент, чтобы загрузить скиллы. Другие способы установки описаны в [README плагина](https://github.com/adaptyteam/adapty-skills/blob/main/plugin/README.md#install).

Claude Code не обновляет плагин автоматически. Чтобы получать новые скиллы по мере их выхода, запустите в Claude Code команду `/plugin`, откройте **Marketplaces**, выберите `adapty` и нажмите **Enable auto-update**. Команду обновления для других агентов см. в [README плагина](https://github.com/adaptyteam/adapty-skills/blob/main/plugin/README.md#install).

Скиллу нужен MCP-сервер Adapty Mail. Если у вашего агента его ещё нет, попросите его подключить Adapty Mail. Скилл предоставит команду для вашего клиента, а вы подтвердите подключение в дашборде Adapty Mail. Шаги для каждого клиента описаны в разделе [Управление Adapty Mail с помощью ИИ-ассистентов](mail-mcp#connect-your-assistant).

## Что можно спросить \{#what-you-can-ask\}

- «Подключи Adapty Mail и покажи, чего не хватает в моём проекте.»
- «Настрой win-back флоу для пользователей, у которых истекла подписка.»
- «Переведи мою кампанию про проблемы с оплатой на немецкий и испанский.»
- «Добавь наш домен как отправляющий и объясни, что делать с DNS-записями.»
- «Какие из моих кампаний лучше всего конвертировали в прошлом месяце?»
- «Мой A/B-тест на флоу для тех, кто ещё ничего не купил, идёт уже три недели. Какой вариант должен победить?»
- «Почему этот пользователь не получил письмо об истечении триала?»

*Пример разговора с тестовым проектом. Ваши сегменты и кампании могут отличаться.*

**User:** Отправь пользователям из Германии немецкую кампанию в моём флоу для тех, кто ещё ничего не купил.

**Agent ran:** Вызвано 6 инструментов Adapty Mail

- `whoami`
- `project_list`
- `container_list`
- `campaign_list`
- `segment_meta`
- `segment_create`

**Agent:**

**Я создал сегмент для Германии и поставил его выше сегмента «Все пользователи» в вашем флоу «Не совершавшие покупок», чтобы остальные пользователи по-прежнему получали то, что получают сейчас.**

Ваш флоу сегодня содержит две строки: пользователи с платным триалом получают Trial nudge, а все остальные — Welcome series. Германия вставляется между ними. Пользователь из Германии, у которого при этом есть платный триал, всё равно получит Trial nudge — строки проверяются сверху вниз.

**Agent asks:** Сохранить флоу Never purchased

```
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
```

После сохранения рассылка уйдёт реальным пользователям. Сохранить?

1. Да, сохранить флоу
2. Нет, сначала изменить что-то

## Как это работает \{#how-it-works\}

1. **Подключение.** Скилл проверяет, что MCP-сервер отвечает и что вы авторизованы.
2. **Ориентация.** Он находит ваш проект и считывает всё, что уже настроено: бренд, адрес компании, домен отправки, кампании, флоу и время последнего поступления данных. Всё существующее он использует повторно.
3. **Планирование.** Он заранее перечисляет всё, что перед началом работы нужно сделать только вам — в дашборде.
4. **Действие.** Он последовательно вызывает инструменты сервера и показывает результат каждого шага. Всё, что отправляет письма реальным людям или не может быть отменено, ждёт вашего подтверждения.

## Почему письмо не было отправлено \{#why-an-email-didnt-send\}

Когда вы спрашиваете о конкретном пользователе, скилл читает его профиль и историю, затем проверяет следующие причины по порядку и останавливается на первой, которая объясняет проблему:

1. Профиль заблокирован: отписался, письмо вернулось, пришла жалоба или адрес не прошёл верификацию. См. [Отписка и блокировки](mail-suppression).
2. Пользователь уже находится в другом маркетинговом флоу.
3. Пользователь совершил покупку, и последовательность завершилась штатно.
4. Лимиты отправки удержали письмо во время прогрева домена.
5. Триггер не сработал. Либо никакие события покупки не поступают в Adapty Mail, либо профиль появился раньше, чем была завершена настройка.
6. Ни один сегмент в флоу не совпал с этим пользователем.
7. Включён double opt-in, и пользователь не подтвердил адрес.
8. Письмо ещё ожидает отправки в рамках временно́го окна для часового пояса пользователя.

*Пример разговора с тестовым проектом. Адрес и даты — вымышленные.*

**User:** Почему sam@example.com не получил письмо об истечении пробного периода?

**Agent ran:** Вызваны 3 read-only инструмента Adapty Mail

- `profile_list`
- `profile_get`
- `profile_journey`

**Agent:**

**Этот адрес отписался 12 октября, поэтому Adapty Mail больше не отправляет ему маркетинговые письма.**

Отписка пришла по ссылке во втором письме кампании Trial expired. Триал закончился 15 октября, поэтому флоу для этого пользователя так и не стартовал. Письма с подтверждением покупок и другие транзакционные письма до адреса доходят.

Снять блокировку может только поддержка Adapty, и только по запросу самого пользователя, который отписался.