Примечание: Устаревшая документация для этого элемента отсутствует, поэтому вы видите текущую документацию.
PushEngage регистрирует набор возможностей WordPress, чтобы ИИ-помощники и клиенты MCP могли управлять вашими push-уведомлениями непосредственно с вашего сайта WordPress. Каждая возможность представляет собой одно четко описанное действие, такое как отправка уведомления, перечисление сегментов или получение отчета об аналитике, которое помощник может обнаружить и вызвать с вашего разрешения. Это руководство объясняет, что такое возможности, что требуется для их использования и что может сделать агент.
Прежде чем начать
- Вам нужен плагин PushEngage версии 4.2.3 или новее. Этот выпуск регистрирует возможности PushEngage в API возможностей WordPress.
- Вашему сайту требуется WordPress 7.0 или новее. API возможностей является частью ядра WordPress начиная с версии 7.0.
- Вы должны быть администратором. Каждая возможность PushEngage требует права
manage_options, и помощник аутентифицируется как пользователь WordPress через пароль приложения. - Чтобы предоставить доступ к возможностям внешнему ИИ-клиенту через MCP, добавьте бесплатный плагин WP MCP Adapter. Вы можете увидеть его статус и остальную часть вашего ИИ-инструментария на странице «Инструменты PushEngage» по адресу PushEngage » Инструменты.
- Некоторые возможности доступны только при активном WooCommerce.
Как работают возможности PushEngage
Когда ваш сайт загружается, плагин PushEngage регистрирует категорию возможностей pushengage и ее возможности через API возможностей WordPress. Каждая возможность объявляет одно право, которое ИИ-помощник может обнаружить и вызвать в машиночитаемом формате, совместимом с MCP.
Доступ наследуется от WordPress, а не от отдельной системы, созданной PushEngage:
- Разрешение. Каждая возможность требует права
manage_options, объявленного черезpermission_callbackAPI возможностей. Помощник аутентифицируется против пользователя WordPress с помощью пароля приложения — стандартного механизма WordPress с версии 5.6. Помощник, подключенный как администратор, может использовать возможности. Подключенный как редактор — нет. - Подтверждение. Только одна возможность помечена как деструктивная — «Отправить уведомление», поэтому осведомленный о MCP помощник подтверждает с вами перед отправкой. Обновления настроек и создание сегментов не являются деструктивными.
- Минимальные привилегии. «Получить журнал отладки» возвращает контент административного уровня, такой как URL-адреса и полезные данные запросов, и имеет те же права администратора, что и все остальное. Помощник имеет такой же доступ, как и запускающий его человек-администратор, и не более того.
Чтобы получить доступ к возможностям внешнего помощника, установите бесплатный адаптер WP MCP Adapter, который связывает зарегистрированные возможности с протоколом MCP, который использует ваш помощник. Пока адаптер или клиент MCP не подключены, возможности зарегистрированы, но ни один агент не может получить к ним доступ.
Что может делать агент
PushEngage регистрирует 22 возможности, сгруппированные ниже по выполняемой ими работе. Точное количество, отображаемое на вашей странице «Инструменты», может отличаться в зависимости от того, что активно на вашем сайте, поскольку некоторые возможности регистрируются только при наличии WooCommerce. «Тип» показывает, только ли возможность считывает данные или также записывает изменения.
Отправлять push-уведомления
| Возможность | Что он делает | Тип |
|---|---|---|
| Отправить уведомление | Отправляет push-уведомление подписчикам. | Запись |
| Получить уведомление | Возвращает сведения об одном уведомлении. | Только чтение |
| Список уведомлений | Возвращает список уведомлений с возможностью фильтрации по статусу и пагинацией. | Только чтение |
| Получить статус подключения | Возвращает информацию о том, подключен ли сайт к учетной записи PushEngage. | Только чтение |
Создавать и нацеливать сегменты
| Возможность | Что он делает | Тип |
|---|---|---|
| Список сегментов | Возвращает список сегментов подписчиков. | Только чтение |
| Список групп аудиторий | Возвращает список групп аудиторий, доступных для таргетинга. | Только чтение |
| Создать сегмент | Создает новый сегмент подписчиков. | Запись |
| Добавить подписчиков в сегмент | Добавляет подписчиков в существующий сегмент. | Запись |
Читать вашу аналитику
| Возможность | Что он делает | Тип |
|---|---|---|
| Сводка уведомлений | Возвращает агрегированные данные об отправленных, просмотренных и кликнутых уведомлениях по всем уведомлениям. | Только чтение |
| Обзор аналитики | Возвращает данные о подписчиках, показах и кликах за указанный период, сгруппированные по дням, неделям или месяцам. | Только чтение |
| Аналитика подписчиков | Возвращает еженедельных активных и общих активных подписчиков. | Только чтение |
Настроить авто-отправку
| Возможность | Что он делает | Тип |
|---|---|---|
| Получить настройки авто-отправки | Возвращает конфигурацию авто-отправки, включая включенные типы сообщений и функциональные флаги. | Только чтение |
| Обновить настройки авто-отправки | Обновляет авто-отправку, включая переключатель, типы сообщений, значок и функциональные флаги. | Запись |
| Список категорий | Перечисляет категории записей WordPress, а также категории продуктов WooCommerce, если WooCommerce активен. | Только чтение |
| Список сопоставлений категорий | Перечисляет сопоставление категорий WordPress с сегментами PushEngage. | Только чтение |
| Получить сопоставления атрибутов | Возвращает сопоставление атрибутов подписчиков PushEngage с ключами метаданных пользователей WordPress. | Только чтение |
Запустить автоматизацию WooCommerce и WhatsApp
Эти возможности доступны только при активном WooCommerce. Получение статуса WhatsApp также требует действительных учетных данных WhatsApp.
| Возможность | Что он делает | Тип |
|---|---|---|
| Список кампаний автоматизации Push | Перечисляет кампании автоматизации Push для WooCommerce с конфигурациями администратора и клиента. | Только чтение |
| Обновить кампанию автоматизации Push | Включает, отключает или настраивает кампанию автоматизации Push для WooCommerce. | Запись |
| Список кампаний автоматизации WhatsApp | Перечисляет кампании автоматизации WhatsApp, настроенные для событий WooCommerce. | Только чтение |
| Получить статус WhatsApp | Возвращает информацию о том, действительны ли учетные данные интеграции WhatsApp. | Только чтение |
Диагностика и проверка
| Возможность | Что он делает | Тип |
|---|---|---|
| Получить информацию о плагине | Возвращает версию плагина, состояние подключения и ключевую конфигурацию. | Только чтение |
| Получить среду сайта | Возвращает сведения о WordPress, PHP и сервере для диагностики. | Только чтение |
| Получить журнал отладки | Перечисляет файлы журнала отладки и считывает определенный файл при указании имени файла. Только для администраторов, так как содержимое журнала может включать URL-адреса и полезные данные запросов. | Только чтение |
Что вы можете спросить у своего помощника
Как только клиент MCP будет подключен, вы описываете задачу простыми словами, а помощник вызывает нужные функции. Например:
- «Найди мой сегмент покупателей, проявивших интерес, затем отправь всем из него push-уведомление с заголовком „Распродажа заканчивается в полночь“, ведущее на мою страницу распродажи». Помощник перечисляет сегменты для поиска ID, затем отправляет уведомление, подтверждая перед отправкой.
- «Покажи мне еженедельный отчет аналитики за последние 30 дней и какие кампании привели к наибольшему количеству кликов». Помощник извлекает обзор аналитики и сопоставляет отправки с заголовками.
- «Отключи мою кампанию WooCommerce по брошенным корзинам до вторника». Помощник перечисляет автоматизированные кампании и обновляет нужную.
- «Создай сегмент под названием „посетители страницы цен“, который включает всех, кто посетил /pricing за последние семь дней». Помощник создает сегмент на основе вашего описания.
Часто задаваемые вопросы
Кто может использовать эти функции?
Только администраторы. Каждая функция PushEngage требует возможности manage_options, а помощник аутентифицируется как пользователь WordPress через пароль приложения. Помощник, подключенный как администратор, может выполнять функции, а подключенный как редактор — нет.
Нужен ли мне MCP Adapter?
Он нужен вам для доступа к функциям из внешнего ИИ-клиента через MCP. Функции регистрируются в WordPress Abilities API самостоятельно, но бесплатный WP MCP Adapter связывает их с протоколом MCP, на котором говорит ваш помощник. Вы можете проверить его статус на странице PushEngage Tools.
Почему на моей странице Tools отображается другое количество функций?
PushEngage регистрирует в общей сложности 22 функции, но функции автоматизации WooCommerce и WhatsApp регистрируются только при активном WooCommerce, поэтому количество, отображаемое на вашем сайте, зависит от того, что активно.
Изменит ли агент мой аккаунт без спроса?
Функции только для чтения только возвращают данные. Только «Отправить уведомление» помечено как деструктивное, поэтому осведомленный о MCP помощник подтверждает с вами перед отправкой. Обновления настроек и создание сегментов не являются деструктивными и выполняются без запроса.
Какие версии плагина и WordPress мне нужны?
PushEngage 4.2.3 или новее для функций и WordPress 7.0 или новее для Abilities API. Рекомендуется обновлять плагин, так как более поздние версии улучшают функции и их ответы ИИ и MCP.
Если у вас возникнут какие-либо проблемы, пожалуйста, свяжитесь с нами, нажав здесь. Наша служба поддержки сможет вам помочь.
