Plugin de WordPress y WooCommerce
El plugin ORYKSA AI Employees pone al empleado de IA en un sitio WordPress o una tienda WooCommerce: chat con el nombre y la foto del dueño, aprendizaje de páginas y productos, acciones de carrito y checkout, y avisos de venta.
Solo para clientes. Este canal atiende a los clientes de la empresa (preguntas, ventas, reservas) con tu Brain, productos y servicios. Nunca es una interfaz del dueño: no cambia ajustes, no lee Actividades ni acepta órdenes del dueño, aunque alguien diga que es el dueño. El dueño habla con ORYKSA solo en la app oficial de ORYKSA, el panel y la extensión del navegador. Más información
| Plugin | Versión | Última actualización | Requisitos | Licencia |
|---|---|---|---|---|
| ORYKSA AI Employees (descarga directa; publicación en WordPress.org en preparación) | 1.1.6 | 2026-10-01 | WordPress 5.8+, PHP 7.2+, compatible con HPOS de WooCommerce | GPL-2.0+ |
Instalar (sin código)
Actualización: si tenías instalada la versión anterior, desactívala y bórrala antes de activar esta.
- Plugins > Añadir nuevo > Subir plugin, elige el zip, Instalar ahora, Activar.
- Ajustes > ORYKSA AI Employees > Conectar con ORYKSA > Conectar sitio: el dueño inicia sesión en ORYKSA y aprueba. Nada que copiar.
- El chat queda activo en el sitio. En WooCommerce la IA también abre productos, los añade al carrito y abre el checkout.
Flujo de conexión
El botón Conectar sitio usa un código de un solo uso: dura 10 minutos, la URL de retorno debe ser /wp-admin/ en el mismo host, y el state se comprueba con un transient de 30 minutos. El plugin intercambia el código de servidor a servidor y guarda el token del widget.
GET https://auth.oryksa.com/wordpress/connect?site=&return=&state=&lang=&woo=
-> the owner signs in and approves
<- browser returns to <return>?oryksa_code=...&state=...
POST https://app.oryksa.com/wordpress/exchange {code, site} (server to server)
<- {token, name}
El chat
El plugin carga el mismo widget que cualquier otro sitio, así que la apariencia, los idiomas, la voz y las reglas del plan son iguales. El nombre y la foto vienen de Tu IA en ORYKSA; el plugin nunca los cambia.
<script src="https://app.oryksa.com/static/oryksa-widget.js"
data-token="..." data-position="right" data-lang="auto"
data-platform="woocommerce" data-checkout="/checkout/"></script>
Qué hace la IA en el sitio
| Acción | Chat del sitio | WhatsApp y Telegram |
|---|---|---|
[OPEN:url] | Abre la página | Envía el enlace |
[CART:id:qty] | POST /?wc-ajax=add_to_cart (id del producto o de la variación) y actualiza el minicarrito | Envía /?add-to-cart=ID&quantity=N |
[CHECKOUT] | Abre el checkout | Envía /checkout/ |
Sincronización
Las páginas, entradas y productos publicados (precio, stock, id de carrito por producto y opción) van al Brain del agente: hasta 300 elementos de 4.000 caracteres. Se ejecuta a diario, 2 minutos después de publicar, y bajo demanda con Actualizar ahora.
POST https://app.oryksa.com/wordpress/sync
{ "token": "...", "site_url": "https://shop.example", "platform": "woocommerce",
"pages": [ { "title": "Delivery", "url": "https://shop.example/delivery", "content": "..." } ] }
Ventas (WooCommerce)
El widget crea una cookie propia oryksa_visitor (30 días). En el checkout el plugin la guarda en el meta del pedido _oryksa_visitor; en pago completado, procesando o completado informa de la venta. ORYKSA registra una conversión de venta, avisa al dueño (campana, push, email) y etiqueta la conversación como "venta".
POST https://app.oryksa.com/wordpress/sale
{ "token": "...", "visitor_id": "oryksa_visitor cookie", "order_id": 1043, "order_name": "#1043",
"total": "59.90", "currency": "EUR", "items": [ { "name": "Blue mug", "qty": 2 } ] }
Nunca se envían: datos de pago ni direcciones de clientes. Coste: cada respuesta de la IA es una interacción (canal web). Además del plugin puedes usar la API v1 (por ejemplo POST /v1/conversions) y la herramienta de widget del MCP.
Preguntas frecuentes
- ¿Funciona sin WooCommerce? Sí: chat más aprendizaje de páginas y entradas.
- ¿De dónde vienen el nombre y la foto? De Tu IA en ORYKSA; el plugin nunca los cambia.
- ¿Cómo lo quito? Desconectar en Ajustes > ORYKSA AI Employees, o desactivar el plugin.

