ORYKSAORYKSADevelopers
Obtener claves de API

App de Shopify

Instala ORYKSA en una tienda Shopify con un clic: chat en la tienda, memoria del catálogo, carrito, estado de los pedidos 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

Qué hace la app

  • Pone el chat de ORYKSA en la tienda online como incrustación de aplicación del tema: el comerciante lo activa con un clic (sin código, sin tokens).
  • Aprende los productos (precio, variantes, marca, descripción), las páginas y las políticas en una memoria propia de esa tienda.
  • En el chat de la tienda ORYKSA actúa por el cliente: abre la página del producto, añade la variante exacta al carrito y abre el checkout. En WhatsApp y Telegram envía enlaces de añadir al carrito (/cart/add?id=VARIANTE&quantity=1) y de comprar ya (/cart/VARIANTE:1). Los carritos llevan el atributo oryksa=chat.
  • Da el estado del pedido solo cuando el cliente indica el número y el email correcto.
  • Avisa al dueño (campana, push, email) de cada pedido hecho por el chat de ORYKSA, con el resumen del pedido, y lo cuenta en Conectores > Shopify.
  • Las conversaciones de la tienda aparecen en Actividad en el panel, donde el dueño puede responder en directo (la IA se pausa para ese visitante).

Instalar

Los comerciantes la instalan en Conectores > Shopify en el panel, o con un enlace de instalación. Desde una herramienta de programación con IA, la herramienta MCP oryksa_shopify devuelve el enlace:

oryksa_shopify { "action": "install_link", "shop": "mi-tienda.myshopify.com" }
oryksa_shopify { "action": "status" }
oryksa_shopify { "action": "sync", "store_id": "shp_..." }

Activar el chat

  1. Instala la app y pulsa Conectar la tienda en la página de ORYKSA.
  2. Pulsa Activar el chat en la tienda. El editor del tema se abre en Incrustaciones de aplicaciones con ORYKSA chat ya activado.
  3. Pulsa Guardar. El chat aparece en todas las páginas de la tienda online.
  4. A mano: Tienda online > Temas > Personalizar > Incrustaciones de aplicaciones (barra lateral) > activar ORYKSA chat > Guardar.

El chat es una incrustación de aplicación del tema: no se cambia el código del tema, y desactivarlo o desinstalar la app lo elimina.

Permisos

PermisoPara qué
read_productsCatálogo, precios y variantes
read_online_store_pagesPáginas de la tienda (envíos, FAQ, sobre nosotros)
read_legal_policiesPolíticas de devolución, privacidad y envío
read_ordersEstado de los pedidos, solo tras verificar el email
write_customersGuarda en los Clientes de la tienda los contactos dejados en el chat

La app nunca lee pagos ni cambia productos o pedidos. Desinstalarla elimina el chat y la memoria de la tienda.

Webhooks

Las actualizaciones de conocimiento de la tienda emiten el webhook knowledge.updated con "source": "shopify".