1. Inicio
  2. Base de Conocimientos
  3. Advanced Coupons
  4. Integraciones
  5. Cómo usar la API de Habilidades de WordPress con Advanced Coupons

Cómo usar la API de Habilidades de WordPress con Advanced Coupons

Gestionar cupones normalmente significa hacer clic en el administrador de WooCommerce, una pantalla a la vez. Si trabajas con un asistente de IA como Claude o ChatGPT, Advanced Coupons puede tomar esas instrucciones directamente a través de la API de Habilidades de WordPress, agregada en la versión 4.7.4, para que puedas pedirle a tu asistente que liste, cree, actualice, programe o elimine cupones.

¿Qué es la API de Habilidades de WordPress?

La API de Habilidades de WordPress es un estándar, disponible en las versiones actuales de WordPress, que permite a los plugins describir lo que pueden hacer en un formato que el software puede leer. En lugar de que cada herramienta de IA necesite una integración personalizada para tu tienda, un plugin registra sus habilidades una vez, y cualquier herramienta compatible puede usarlas.

Esas habilidades llegan a un asistente de IA a través de un conector llamado adaptador MCP. MCP (Protocolo de Contexto de Modelo) es el lenguaje común que los asistentes de IA utilizan para hablar con herramientas externas. Advanced Coupons registra un conjunto de habilidades de cupones en este estándar, todas agrupadas bajo una única categoría Advanced Coupons para que un asistente conectado pueda encontrarlas juntas. Dependiendo del adaptador que uses, tu asistente puede listar cada habilidad directamente o descubrirlas bajo petición.

Las habilidades se registran automáticamente una vez que la API de Habilidades está presente, lo que ocurre en WordPress 7.0 y versiones posteriores. En versiones anteriores de WordPress, se registran solo si el plugin de características separado de la API de Habilidades está activo.

Qué puedes hacer con ella

Advanced Coupons registra ocho habilidades. Tres son de solo lectura y cinco realizan cambios en tus cupones. Las que cambian datos están marcadas para que tu asistente de IA te pida confirmación antes de ejecutarlas.

HabilidadQué hace¿Cambia datos?
Listar cuponesDevuelve una lista filtrada de cupones (por tipo, estado, recuento de uso o fecha de caducidad).No
Obtener cupónDevuelve la configuración completa de un solo cupón, incluidas las condiciones del carrito, la configuración BOGO, las restricciones de rol, el disparador de URL y la programación.No
Obtener resumen de cuponesDevuelve los totales de uso y descuento de cupones para un rango de fechas, además de tus códigos de mejor rendimiento.No
Crear cupónCrea un nuevo cupón con opciones de Advanced Coupons.
Actualizar cupónActualiza un cupón existente. Solo se cambian los campos que proporcionas.
Eliminar cupónMueve un cupón a la papelera.
Establecer disparador de URL de cupónActiva o desactiva el disparador de cupón por URL y establece sus opciones relacionadas.
Establecer programación de cupónActiva o desactiva la programación de rango de fechas de un cupón y establece sus fechas de inicio y fin.

En la práctica, esto significa que puedes pedirle a tu asistente cosas como “muéstrame todos los cupones que caducan este mes”, “crea un cupón del 15% de descuento llamado SPRING15 que caduca en 30 días”, o “¿qué cinco cupones generaron más descuento el último trimestre?” y utilizará la habilidad correspondiente para responder o actuar.

Lo que necesitarás

  • WordPress 7.0 o posterior (la API de Habilidades está integrada) o una versión anterior con el plugin de características API de Habilidades activo.
  • WooCommerce activo, con Advanced Coupons 4.7.4 o posterior instalado y en ejecución (la integración de la API de Habilidades se añadió en la 4.7.4).
  • Un plugin adaptador MCP que conecta WordPress a tu asistente de IA (consulta la guía del adaptador MCP de WordPress). Advanced Coupons registra las habilidades; no incluye el adaptador en sí.
  • Una cuenta de usuario que pueda administrar WooCommerce (un Gestor de Tienda o Administrador). Tu asistente actúa como ese usuario conectado.

Conecta tu asistente de IA

Los pasos exactos dependen del adaptador MCP que utilices, pero el flujo es el mismo:

  1. Confirma que estás en WordPress 7.0 o posterior, con WooCommerce y Advanced Coupons activos.
  2. Instala y configura un plugin adaptador MCP, y conéctalo a tu asistente de IA siguiendo las instrucciones de ese adaptador.
  3. Autentícate como un usuario que pueda administrar WooCommerce, para que las habilidades de los cupones estén disponibles.
  4. En tu asistente de IA, pregunta qué puede hacer con tus cupones, para que descubra las habilidades disponibles de Advanced Coupons.
  5. Empieza con una solicitud de solo lectura como “listar mis cupones activos” para confirmar que la conexión funciona antes de realizar cualquier cambio.

Permisos y seguridad

Cada una de las ocho habilidades, incluidas las de solo lectura, requiere un usuario que pueda administrar WooCommerce. Los datos de los cupones, como códigos, importes de descuento, límites de uso y resúmenes de ingresos, son información del propietario de la tienda, por lo que una cuenta de cliente o suscriptor no puede ejecutar ninguna de estas habilidades.

Las cinco habilidades que cambian datos están marcadas como destructivas. Un asistente de IA bien diseñado te muestra una solicitud de confirmación antes de ejecutarlas, para que nada se cree, cambie o elimine sin tu permiso.

Cuando tu asistente crea o actualiza un cupón, pasa por el mismo proceso de guardado que la pantalla de edición de Advanced Coupons. No hay una ruta de "IA" separada, por lo que los cupones creados de esta manera se comportan de manera idéntica a los que creas manualmente, y cualquier integración conectada sigue funcionando normalmente.

Dos habilidades dependen de que su característica esté activada. Establecer disparador de URL de cupón solo funciona cuando la característica de Cupones por URL (Cómo aplicar un cupón con una URL) está habilitada, y Establecer programación de cupón solo funciona cuando la característica de Programador (Cómo programar cupones) está habilitada. Si la característica está desactivada, la habilidad devuelve un mensaje claro en lugar de realizar un cambio.

Desactivar habilidades (para desarrolladores)

Si prefieres que Advanced Coupons no registre ninguna habilidad, puedes desactivarlas en el código. Define esta constante (por ejemplo, en wp-config.php):

define( 'ACFWF_DISABLE_ABILITIES', true );

O usa el filtro:

add_filter( 'acfwf_disable_abilities', '__return_true' );

Preguntas frecuentes

¿Con qué asistentes de IA funciona esto?
Cualquier asistente que admita MCP, como Claude Desktop o la aplicación de escritorio ChatGPT, una vez que lo hayas conectado a tu sitio a través de un adaptador MCP. Advanced Coupons no favorece a ningún asistente en particular.

¿Puede mi asistente de IA ver datos de clientes u pedidos a través de esto?
No. Estas capacidades solo cubren los cupones y los resúmenes de uso de cupones. También requieren un usuario que pueda administrar WooCommerce, por lo que las cuentas de clientes no pueden ejecutarlas.

¿Los cupones que crea mi asistente se comportarán de manera diferente a los que creo manualmente?
No. Se guardan a través del mismo proceso que la pantalla de edición de cupones, por lo que se comportan exactamente igual.

¿Necesito escribir algún código para usar esto?
No. El uso de las capacidades solo requiere WordPress 7.0, WooCommerce y un adaptador MCP. El código solo se involucra si desea desactivar las capacidades.

¿Necesitas ayuda?

Si tienes alguna pregunta o encuentras algún problema, estamos aquí para ayudarte.

¿Te ha sido útil este artículo?

Artículos Relacionados

Completa tu compra