Imagina una agencia que se encarga de una docena de tiendas mayoristas de WooCommerce. Un cliente quiere que su asistente de IA apruebe cotizaciones. Otro quiere una lista semanal de los principales clientes mayoristas sin que nadie inicie sesión. Antes de la API de Habilidades de WordPress, cada solicitud significaba escribir y mantener un endpoint personalizado.
Las Habilidades cambian eso. Los plugins ahora pueden publicar una lista nombrada de acciones, cada una con sus propias entradas y verificación de permisos, y los agentes de IA pueden encontrarlas y ejecutarlas. La parte difícil para un desarrollador es saber qué expone un conjunto de plugins real y cómo mantenerlo bajo control.
Esta guía cubre lo que Wholesale Suite registra como habilidades, quién puede ejecutar cada grupo, cómo se registran las llamadas y cómo desactivar todo. Se basa en la documentación y el código de los propios plugins.
Qué es la API de Habilidades de WordPress
La API de Habilidades de WordPress (WordPress 6.9+) es un registro central donde los plugins declaran acciones nombradas con entradas, salidas y verificaciones de permisos definidas. Los agentes de IA y las herramientas de automatización pueden entonces descubrir esas acciones y ejecutarlas de manera consistente y predecible.
Según la documentación de la API de Habilidades de WordPress, cada habilidad tiene algunas partes centrales:
- Un nombre único: Sigue un patrón
namespace/nombre-habilidad, además de una etiqueta y descripción legibles por humanos. - Esquemas de entrada y salida: JSON Schema describe lo que la habilidad espera y lo que devuelve, para que un agente sepa cómo llamarla.
- Una categoría: Habilidades relacionadas se agrupan.
- Una devolución de llamada de permiso: Esta comprobación opcional decide si el usuario actual puede ejecutar la habilidad.
- Una devolución de llamada de ejecución: Esta es la función PHP que hace el trabajo.
Piénsalo como un menú de restaurante. La cocina sigue cocinando la comida, pero los clientes piden de una lista fija de platos con descripciones claras. La API de Habilidades da a cada plugin el mismo formato de menú, para que cualquier agente pueda leerlo. El registro se cubre en la documentación oficial. Para una agencia, la pregunta útil es qué pone un conjunto de plugins de producción en ese menú.
Cómo las Habilidades Llegan a un Agente de IA o Automatización
Las habilidades viven dentro de WordPress, por lo que un asistente de IA necesita un puente para alcanzarlas. Ese puente es MCP (Model Context Protocol). Según el manual del adaptador MCP de WordPress, el adaptador MCP traduce las habilidades de WordPress en herramientas MCP, para que asistentes como Claude y ChatGPT puedan descubrirlas e invocarlas.
WooCommerce utiliza la misma capa. Según la documentación para desarrolladores de MCP de WooCommerce, WooCommerce registra sus propias habilidades de producto y pedido en la API de Habilidades y el adaptador MCP. Esa función todavía es una vista previa para desarrolladores.
Una tienda Wholesale Suite tiene dos rutas hacia un agente:
- StoreAgent: La pestaña IA / MCP en Wholesale Suite conecta StoreAgent por ti. Su interruptor Habilitar acceso de escritura MCP controla las habilidades de escritura, pero solo para las conexiones de StoreAgent.
- Un plugin adaptador MCP: Si usas un adaptador en su lugar, el adaptador decide qué puede hacer el asistente. El interruptor StoreAgent no tiene ningún efecto allí.
De cualquier manera, cada llamada se ejecuta como el usuario autenticado de WordPress, por lo que el agente nunca obtiene más acceso del que tiene esa cuenta. Para una visión más amplia de dónde encaja esto, consulta nuestra guía de integración de sistemas de IA para Wholesale Suite.
Qué Acciones Mayoristas Expone Wholesale Suite
Wholesale Suite registra 47 habilidades en cuatro plugins. De ellas, 17 son de solo lectura y 30 realizan cambios. Necesitas WordPress 6.9 o superior, o WooCommerce 10.9 o superior, porque cualquiera de ellos proporciona la API de Habilidades.
WooCommerce Wholesale Prices 2.3.0 es el interruptor que activa esto. Añade soporte para la API de Habilidades y habilita las habilidades para cada plugin de Wholesale Suite. Los cuatro plugins se desglosan así:
| Plugin (versión mínima) | Habilidades | Ejemplos de solo lectura | Ejemplos de escritura | Quién puede ejecutar las escrituras |
|---|---|---|---|---|
| WooCommerce Wholesale Prices (2.3.0, gratis) | 3 | Obtener precio mayorista, Listar clientes mayoristas | Establecer precio mayorista | Gerente de Tienda o Administrador |
| WooCommerce Wholesale Prices Premium (2.1.3) | 15 | Listar roles mayoristas, Obtener resumen de precios, Obtener precio efectivo | Establecer regla de pedido mínimo, Establecer regla de descuento por cantidad, Crear rol mayorista | Solo administrador (todas las 12 escrituras) |
| WooCommerce Wholesale Order Form (3.1.2) | 8 | Listar formularios de pedido, Obtener análisis de formularios de pedido | Duplicar formulario de pedido, Eliminar formulario de pedido | Gerente de Tienda o Administrador |
| WooCommerce Wholesale Quotes (1.0.3) | 21 | Listar presupuestos, Obtener estadísticas de presupuestos | Aprobar presupuesto, Convertir presupuesto en pedido, Actualizar estado de presupuesto en bloque | Gestor de tienda o Administrador (configuración: solo administrador) |
| Total | 47 | 17 solo lectura | 30 realizar cambios |
Wholesale Lead Capture y Wholesale Payments aún no registran ninguna capacidad. Para cada capacidad con su descripción y permiso, consulte la lista completa de capacidades de IA de Wholesale Suite.
WooCommerce Wholesale Prices (3)
El plugin gratuito cubre lo básico. Un agente puede obtener o establecer un precio mayorista en un producto o variación, y listar clientes mayoristas con su fecha de último pedido y gasto total.
WooCommerce Wholesale Prices Premium (15)
Premium añade las reglas de precios. Tres capacidades de lectura listan roles, cuentan las reglas de precios por nivel y calculan el precio efectivo que paga un cliente. Sus 12 capacidades de escritura cubren descuentos globales, por categoría y por cantidad, descuentos en el subtotal del carrito, pedidos mínimos, envío, pagos y asignación de exención de impuestos, creación de roles, asignación de roles, visibilidad de productos y precios por roles.
WooCommerce Wholesale Order Form (8)
Cuatro capacidades de lectura listan formularios, muestran la configuración de un formulario, devuelven análisis combinados y le proporcionan el shortcode de incrustación. Las otras cuatro crean, duplican, actualizan o eliminan formularios de pedido.
WooCommerce Wholesale Quotes (21)
Presupuestos tiene el conjunto más grande. Los agentes pueden leer presupuestos, mensajes, historial, enlaces públicos, estadísticas, límites de tasa y configuraciones. En el lado derecho, pueden editar artículos, aprobar, rechazar, cancelar, convertir presupuestos en pedidos, actualizar hasta 50 presupuestos en bloque, enviar mensajes y eliminar presupuestos.
El modelo de permisos
Cada llamada a una capacidad se ejecuta como el usuario de WordPress que autenticó la conexión. Por lo tanto, la cuenta con la que se conecte decide qué puede manipular el agente.
Wholesale Suite divide el acceso en dos niveles:
- Gestores de tienda y Administradores: Ambos pueden usar todas las capacidades de lectura, la capacidad gratuita Establecer precio mayorista, todas las capacidades de Formulario de pedido y la mayoría de las capacidades de Presupuestos.
- Solo administradores: Las 12 capacidades de escritura Premium y las dos capacidades de configuración de Presupuestos. Cambian reglas, configuraciones y roles de usuario en toda la tienda, por lo que una conexión de Gestor de tienda puede leer los precios Premium pero no puede cambiarlos.
Algunas capacidades de lectura también funcionan para los clientes. Un cliente mayorista puede leer el precio de su propio rol. Cualquier cliente conectado puede usar cinco capacidades de lectura de Presupuestos solo en sus propios presupuestos: Listar presupuestos, Obtener presupuesto, Listar mensajes de presupuesto, Listar historial de presupuesto y Obtener enlace público de presupuesto.
Las capacidades que sobrescriben o eliminan datos se marcan como destructivas. Eso indica al asistente que pregunte antes de ejecutarlas, pero el asistente decide cómo pregunta. Las capacidades de escritura cambian datos en vivo, y algunas, como Eliminar presupuesto y Eliminar formulario de pedido, no se pueden deshacer.
Nuestro consejo para sitios de clientes: conéctese como el rol con menos privilegios que pueda realizar el trabajo. Un agente de informes solo necesita Gestor de tienda. Si necesita un repaso sobre cómo se apilan los roles, lea cómo funcionan los roles de cliente de WooCommerce para mayoristas.
Registro de auditoría y interruptores de apagado
Wholesale Suite te proporciona dos herramientas de gobernanza: un registro de cada llamada de habilidad y interruptores que desactivan las habilidades. Ambas están diseñadas para desarrolladores que gestionan sitios de clientes.
El registro de auditoría de habilidades
En WordPress 7.1 o superior, Wholesale Suite registra cada llamada de habilidad. Encontrarás las entradas en WooCommerce > Estado > Registros seleccionando la fuente wwp-abilities-audit. Esto te proporciona un registro para consultar cuando un cliente pregunta qué cambió un agente. Las llamadas exitosas se escriben en el nivel Info y las fallidas en el nivel Error, por lo que si la configuración de registro de tu WooCommerce solo conserva advertencias y errores, las llamadas exitosas no aparecerán.
Para mantener las habilidades en funcionamiento pero detener el registro, establece la constante WWP_DISABLE_ABILITIES_AUDIT o utiliza el filtro wwp_disable_abilities_audit.
Desactivar habilidades
Cada plugin tiene su propio interruptor. Añade la constante a wp-config.php o utiliza el filtro correspondiente en el código. Solo necesitas uno de los dos.
// All Wholesale Suite plugins (set in wp-config.php)
define( 'WWP_DISABLE_ABILITIES', true );
// Premium abilities only
define( 'WWPP_DISABLE_ABILITIES', true );
// Order Form abilities only
define( 'WWOF_DISABLE_ABILITIES', true );
// Quotes abilities only
define( 'WWQ_DISABLE_ABILITIES', true );
// Filter version of the suite-wide switch
add_filter( 'wwp_disable_abilities', '__return_true' );El interruptor de WooCommerce Wholesale Prices es para toda la suite. Desactiva las habilidades de todos los plugins de Wholesale Suite, no solo las suyas. Los otros tres filtros siguen el mismo patrón: wwpp_disable_abilities, wwof_disable_abilities y wwq_disable_abilities.
Lo que hemos visto: el detalle que vale la pena construir es Asignar usuario a rol mayorista. Reemplaza todos los roles que tiene un usuario, incluidos Gestor de la tienda o Editor, aunque no tocará a tu último Administrador. Cualquier automatización que mueva clientes entre niveles debería verificar primero sus roles actuales. Actualizar presupuesto funciona de la misma manera con los artículos, ya que la lista que envías reemplaza toda la lista de artículos.
Casos de uso de automatización para agencias
Las habilidades son más útiles cuando mapeas una solicitud de cliente a una cadena corta de acciones con nombre. Aquí hay cuatro escenarios que podrías construir:
- Resumen semanal (solo lectura): Imagina un cliente que quiere un resumen los lunes. Un agente puede ejecutar Listar clientes mayoristas, ordenados por gasto acumulado, y luego Obtener estadísticas de presupuestos de la semana pasada. Nada cambia, por lo que una conexión de Gestor de la tienda es suficiente.
- Clasificación de presupuestos: Un agente lista los presupuestos por estado, marca los que necesitan intervención humana y luego utiliza Actualizar estado de presupuesto en bloque en hasta 50 a la vez. Aprobar y Rechazar envían los correos electrónicos habituales al cliente. Cancelar no envía ninguno.
- Auditoría de precios antes del lanzamiento: Antes de que un cambio de precio se active, ejecuta Obtener resumen de precios y Obtener precio efectivo para algunos clientes de prueba. Ten en cuenta que Obtener precio efectivo excluye los descuentos por cantidad en el carrito, los descuentos por subtotal del carrito y los precios de oferta programados.
- Mantenimiento del formulario de pedido: Utiliza Duplicar formulario de pedido para copiar un formulario como borrador antes de editarlo, de modo que el formulario activo permanezca intacto.
No todos los trabajos necesitan un agente. Para cambios de nivel basados en reglas, como mover a un cliente hacia arriba después de que gaste una cantidad determinada, la automatización de roles mayoristas está integrada y no necesita ninguna conexión de IA en absoluto.
API de habilidades frente a la API REST de Wholesale Suite
Utiliza la API REST para la sincronización entre sistemas y utiliza las habilidades cuando un agente o una herramienta de automatización necesite descubrir acciones con comprobaciones de permisos integradas.
La API REST de Wholesale Suite utiliza los espacios de nombres wholesale/v1 y wwlc/v1. Ofrece puntos de conexión por lotes, además de puntos de conexión de descuentos premium y análisis. Esto la hace ideal para una sincronización ERP o una actualización masiva del catálogo, donde tu propio código sabe qué punto de conexión llamar.
Las habilidades se adaptan a un trabajo diferente. Cada una se describe a sí misma, comprueba los permisos del llamador y se registra en WordPress 7.1+. Un agente puede averiguar qué está disponible por sí mismo, sin que tengas que escribir un punto de conexión personalizado para cada cliente.
Una agencia puede usar ambas: REST para la sincronización programada, habilidades para solicitudes ad hoc a través de un asistente.
Crea tiendas mayoristas preparadas para agentes con la API de Habilidades de WordPress
La API de Habilidades de WordPress ofrece a las agencias algo que no tenían antes: una capa de acciones documentada y con comprobación de permisos que todas las tiendas de clientes comparten. En lugar de mantener puntos de conexión únicos por cliente, obtienes una lista conocida de acciones mayoristas, un registro de lo que se ejecutó y un interruptor para desactivarlo todo.
Tus próximos pasos:
- Aprende qué es la API de Habilidades para poder explicársela a los clientes.
- Elige tus habilidades mayoristas por plugin.
- Conéctate con el rol de menor privilegio que cubra cada trabajo.
- Configura el registro de auditoría y los interruptores de apagado antes de entregar un sitio.
- Elige entre habilidades y REST para cada integración.
¿Listo para crear tiendas mayoristas preparadas para agentes con la API de Habilidades de WordPress? El paquete Wholesale Suite incluye los plugins premium detrás de los cuatro conjuntos de habilidades y cubre sitios ilimitados, lo que es ideal para agencias que administran varias tiendas de clientes.
Preguntas frecuentes sobre la API de Habilidades de WordPress
¿Qué versión de WordPress necesito para la API de Habilidades?
La API de Habilidades está disponible en WordPress 6.9 y versiones posteriores. Para las habilidades de Wholesale Suite, necesitas WordPress 6.9 o una versión más reciente, o WooCommerce 10.9 o una versión más reciente, ya que cualquiera de las dos proporciona la API. También necesitas WooCommerce Wholesale Prices 2.3.0 o una versión más reciente, que activa las habilidades en toda la suite.
¿Es la API de Habilidades lo mismo que MCP?
No. La API de Habilidades es el registro dentro de WordPress donde los plugins declaran sus acciones. MCP es el protocolo que un asistente de IA utiliza para hablar con tu sitio. El adaptador MCP, o StoreAgent, se sitúa entre ambos y convierte las habilidades en herramientas que el asistente puede llamar.
¿Puedo desactivar las habilidades de Wholesale Suite en el sitio de un cliente?
Sí. Establece WWP_DISABLE_ABILITIES en true en wp-config.php, o utiliza el filtro wwp_disable_abilities, para desactivar las habilidades para todos los plugins de Wholesale Suite. Cada plugin premium también tiene su propia constante y filtro si solo deseas desactivar un conjunto.
¿Dónde puedo ver qué ha cambiado un agente de IA?
En WordPress 7.1 o posterior, Wholesale Suite registra cada llamada de habilidad. Ve a WooCommerce > Estado > Registros y elige la fuente wwp-abilities-audit. Puedes detener el registro manteniendo las habilidades activas con la constante WWP_DISABLE_ABILITIES_AUDIT o su filtro.
¿Pueden los clientes mayoristas usar habilidades?
Solo unas pocas. Un cliente mayorista puede leer el precio mayorista de su propio rol. Cualquier cliente conectado puede listar y leer sus propias cotizaciones, junto con mensajes, historial y el enlace público. Todas las demás habilidades necesitan una cuenta de Gestor de Tienda o Administrador.
