Aviso: No hay documentación heredada disponible para este elemento, por lo que está viendo la documentación actual.
PushEngage registra un conjunto de Habilidades de WordPress para que los asistentes de IA y los clientes de MCP puedan operar tus notificaciones push directamente desde tu sitio de WordPress. Cada habilidad es una acción única y bien descrita, como enviar una notificación, listar segmentos o extraer un informe de análisis, que un asistente puede descubrir y llamar con tu permiso. Esta guía explica cuáles son las habilidades, qué se requiere para usarlas y todo lo que un agente puede hacer.
Antes de empezar
- Necesitas la versión 4.2.3 o posterior del plugin PushEngage. Esta versión registra las habilidades de PushEngage en la API de Habilidades de WordPress.
- Tu sitio necesita WordPress 7.0 o posterior. La API de Habilidades forma parte del núcleo de WordPress a partir de la versión 7.0.
- Debes ser administrador. Cada habilidad de PushEngage requiere la capacidad
manage_options, y el asistente se autentica como un usuario de WordPress a través de una contraseña de aplicación. - Para exponer las habilidades a un cliente de IA externo a través de MCP, añade el plugin gratuito WP MCP Adapter. Puedes ver su estado y el resto de tu kit de herramientas de IA en la página de Herramientas de PushEngage en PushEngage » Herramientas.
- Algunas habilidades solo están disponibles cuando WooCommerce está activo.
Cómo funcionan las Habilidades de PushEngage
Cuando tu sitio se carga, el plugin PushEngage registra una categoría de habilidad pushengage y sus habilidades a través de la API de Habilidades de WordPress. Cada habilidad declara una única capacidad que un asistente de IA puede descubrir y llamar, en un formato legible por máquina y compatible con MCP.
El acceso se hereda de WordPress, no es un sistema separado que PushEngage haya creado:
- Permiso. Cada habilidad requiere la capacidad
manage_options, declarada a través de lapermission_callbackde la API de Habilidades. El asistente se autentica contra un usuario de WordPress con una contraseña de aplicación, el mecanismo estándar de WordPress desde la versión 5.6. Un asistente conectado como administrador puede ejecutar las habilidades. Uno conectado como colaborador no puede. - Confirmación. Solo una habilidad está marcada como destructiva, Enviar Notificación, por lo que un asistente compatible con MCP te confirma antes de enviar. Las actualizaciones de configuración y la creación de segmentos no son destructivas.
- Mínimo privilegio. Obtener Registro de Depuración devuelve contenido de nivel de administrador, como URLs y cargas útiles de solicitudes, y está restringido al mismo permiso de administrador que todo lo demás. El asistente tiene el mismo acceso que el administrador humano que lo ejecuta, y nada más.
Para acceder a las capacidades de un asistente externo, instala el Adaptador WP MCP gratuito, que conecta las capacidades registradas con el protocolo MCP que habla tu asistente. Hasta que no se conecte un adaptador o cliente MCP, las capacidades se registran pero ningún agente puede acceder a ellas todavía.
Lo que un agente puede hacer
PushEngage registra 22 capacidades, agrupadas a continuación por el trabajo que realizan. El número exacto que se muestra en tu página de Herramientas puede variar según lo que esté activo en tu sitio, ya que algunas capacidades solo se registran cuando WooCommerce está presente. "Tipo" muestra si una capacidad solo lee datos o también escribe cambios.
Enviar notificaciones push
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Enviar notificación | Envía una notificación push a los suscriptores. | Escribir |
| Obtener notificación | Devuelve detalles de una notificación individual. | Solo lectura |
| Listar notificaciones | Enumera las notificaciones, con filtro de estado opcional y paginación. | Solo lectura |
| Obtener estado de conexión | Devuelve si el sitio está conectado a una cuenta de PushEngage. | Solo lectura |
Crear y segmentar audiencias
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Listar segmentos | Enumera los segmentos de suscriptores. | Solo lectura |
| Listar grupos de audiencia | Enumera los grupos de audiencia disponibles para la segmentación. | Solo lectura |
| Crear segmento | Crea un nuevo segmento de suscriptores. | Escribir |
| Añadir suscriptores a un segmento | Añade suscriptores a un segmento existente. | Escribir |
Leer tus análisis
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Obtener resumen de notificaciones | Devuelve recuentos agregados de envíos, visualizaciones y clics en todas las notificaciones. | Solo lectura |
| Obtener vista general de análisis | Devuelve suscriptores, impresiones y clics en un rango de fechas, agrupados por día, semana o mes. | Solo lectura |
| Obtener análisis de suscriptores | Devuelve suscriptores activos semanales y totales. | Solo lectura |
Configurar auto-push
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Obtener configuración de auto-push | Devuelve la configuración de auto-push, incluyendo tipos de publicaciones habilitados y flags de características. | Solo lectura |
| Actualizar configuración de auto-push | Actualiza el auto-push, incluyendo el interruptor, tipos de publicaciones, icono y flags de características. | Escribir |
| Listar categorías | Enumera las categorías de publicaciones de WordPress, además de las categorías de productos de WooCommerce cuando WooCommerce está activo. | Solo lectura |
| Listar mapeos de categorías | Enumera el mapeo de categorías de WordPress a segmentos de PushEngage. | Solo lectura |
| Obtener mapeos de atributos | Devuelve el mapeo de atributos de suscriptores de PushEngage a claves de meta de usuario de WordPress. | Solo lectura |
Ejecutar automatizaciones de WooCommerce y WhatsApp
Estas capacidades solo están disponibles cuando WooCommerce está activo. Obtener estado de WhatsApp también requiere credenciales válidas de WhatsApp.
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Listar campañas de automatización de push | Enumera las campañas de automatización de push de WooCommerce con configuraciones de administrador y cliente. | Solo lectura |
| Actualizar campaña de automatización de push | Habilita, deshabilita o configura una campaña de automatización de push de WooCommerce. | Escribir |
| Listar campañas de automatización de WhatsApp | Enumera las campañas de automatización de WhatsApp configuradas para eventos de WooCommerce. | Solo lectura |
| Obtener estado de WhatsApp | Devuelve si las credenciales de integración de WhatsApp son válidas. | Solo lectura |
Diagnosticar y verificar
| Capacidad | Lo que hace | Tipo |
|---|---|---|
| Obtener información del plugin | Devuelve la versión del plugin, el estado de la conexión y la configuración clave. | Solo lectura |
| Obtener entorno del sitio | Devuelve detalles de WordPress, PHP y del servidor para diagnósticos. | Solo lectura |
| Obtener registro de depuración | Enumera los archivos de registro de depuración y lee un archivo específico cuando se proporciona un nombre de archivo. Solo para administradores, ya que el contenido del registro puede incluir URL y cargas útiles de solicitud. | Solo lectura |
Qué puedes preguntarle a tu asistente
Una vez que un cliente MCP está conectado, describes el trabajo en lenguaje claro y el asistente llama a las capacidades correctas. Por ejemplo:
- “Encuentra mi segmento de compradores interesados, luego envía a todos en él un push titulado ‘La oferta flash termina a medianoche’ enlazando a mi página de ofertas.” El asistente enumera los segmentos para encontrar el ID, luego envía la notificación, confirmando antes de que se active.
- “Muéstrame un informe de análisis semana a semana de los últimos 30 días, y qué campañas generaron más clics.” El asistente extrae la descripción general de análisis y mapea los envíos a los títulos.
- “Desactiva mi campaña de abandono de carritos de WooCommerce hasta el martes.” El asistente enumera las campañas de automatización y actualiza la correcta.
- “Crea un segmento llamado visitantes-de-la-página-de-precios que capture a cualquiera que haya visitado /pricing en los últimos siete días.” El asistente crea el segmento a partir de tu descripción.
Preguntas frecuentes
¿Quién puede usar estas capacidades?
Solo los administradores. Cada capacidad de PushEngage requiere la capacidad manage_options, y el asistente se autentica como un usuario de WordPress a través de una contraseña de aplicación. Un asistente conectado como administrador puede ejecutar las capacidades, mientras que uno conectado como colaborador no puede.
¿Necesito el Adaptador MCP?
Lo necesitas para acceder a las capacidades desde un cliente de IA externo a través de MCP. Las capacidades se registran en la API de Capacidades de WordPress por sí solas, pero el Adaptador WP MCP gratuito es lo que las conecta al protocolo MCP que habla tu asistente. Puedes verificar su estado en la página de Herramientas de PushEngage.
¿Por qué mi página de Herramientas muestra un número diferente de capacidades?
PushEngage registra 22 capacidades en total, pero la automatización de push de WooCommerce y las capacidades de WhatsApp solo se registran cuando WooCommerce está activo, por lo que el recuento que se muestra en tu sitio depende de lo que esté activo.
¿Cambiará un agente mi cuenta sin preguntar?
Las capacidades de solo lectura solo devuelven datos. Solo Enviar Notificación está marcada como destructiva, por lo que un asistente consciente de MCP confirma contigo antes de activar un envío. Las actualizaciones de configuración y la creación de segmentos no son destructivas y se ejecutan sin solicitud.
¿Qué versiones de plugin y WordPress necesito?
PushEngage 4.2.3 o posterior para las capacidades, y WordPress 7.0 o posterior para la API de Capacidades. Se recomienda mantener el plugin actualizado, ya que las versiones posteriores refinan las capacidades y sus respuestas de IA y MCP.
Si tienes algún problema, no dudes en contactarnos haciendo clic aquí. Nuestro equipo de soporte podrá ayudarte.
