Visión General de la Plataforma

Qué es la Plataforma de Plugins de Whatalo, qué puedes construir y cómo funciona la distribución.

¿Qué es la Plataforma de Plugins?

La Plataforma de Plugins de Whatalo permite a los desarrolladores extender el admin de Whatalo con aplicaciones web personalizadas. Cada plugin se ejecuta en un iframe con sandbox en la barra lateral del admin y se comunica con el host a través del App Bridge — un protocolo postMessage en @whatalo/plugin-sdk.

Tú alojas tu plugin en tu propia infraestructura. Whatalo nunca ejecuta tu código en sus servidores. Eres dueño de tu despliegue, tu pipeline de datos y tu stack.

Qué Pueden Hacer los Plugins

Extensión de la UI del Admin

Cada plugin puede registrar una o más vistas de página completa en la barra lateral del admin. Las páginas se definen en el manifiesto (whatalo.app.ts) bajo adminUI.pages. El dueño de la tienda navega a tu plugin haciendo clic en su nombre en la barra lateral.

Barra lateral
├── Pedidos
├── Productos
├── Integraciones
│   └── Mi Plugin de Analíticas    ← nombre de tu plugin (enlaza al dashboard)
│       ├── Dashboard               ← primera página (predeterminada)
│       └── Reportes                ← páginas adicionales se expanden abajo

Acceso a Datos de la Tienda vía REST API

Los plugins acceden a los datos de la tienda a través de la REST API de Whatalo usando un token de acceso con permisos limitados. El token está vinculado a la tienda específica donde está instalado el plugin.

Los 15 alcances de permisos disponibles:

Alcance	Descripción
`read:products`	Listar y obtener productos
`write:products`	Crear, actualizar y eliminar productos
`read:orders`	Listar y obtener pedidos
`write:orders`	Actualizar estado y datos de pedidos
`read:customers`	Listar y obtener clientes
`write:customers`	Crear y actualizar clientes
`read:inventory`	Leer niveles de inventario
`write:inventory`	Ajustar inventario
`read:store`	Leer configuración y ajustes de la tienda
`write:store`	Actualizar configuración de la tienda
`read:webhooks`	Listar suscripciones de webhooks
`write:webhooks`	Crear y eliminar suscripciones de webhooks
`read:discounts`	Listar y obtener códigos de descuento
`write:discounts`	Crear y gestionar códigos de descuento
`read:analytics`	Acceder a datos de analíticas e informes

Solo solicita los alcances que tu plugin realmente necesita. Los dueños de tiendas ven la lista de permisos durante la instalación y pueden rechazar plugins que soliciten acceso excesivo.

Eventos en Tiempo Real vía Webhooks

Los plugins se suscriben a eventos webhook en su manifiesto. Whatalo entrega solicitudes HTTP POST a tu webhookUrl cuando ocurren eventos en la tienda.

Los 13 eventos soportados:

Evento	Cuándo se dispara
`order.created`	Se realiza un nuevo pedido
`order.updated`	Los datos del pedido cambian
`order.status_changed`	El pedido pasa a un estado diferente
`order.cancelled`	Se cancela un pedido
`product.created`	Se agrega un nuevo producto
`product.updated`	Los datos del producto cambian
`product.deleted`	Se elimina un producto
`customer.created`	Se crea un nuevo registro de cliente
`customer.updated`	Los datos del cliente cambian
`inventory.low`	El stock cae por debajo de un umbral
`inventory.adjusted`	El nivel de inventario se cambia manualmente
`app.installed`	El dueño de la tienda instala tu plugin
`app.uninstalled`	El dueño de la tienda desinstala tu plugin

Acciones en el Admin vía App Bridge

Desde dentro del iframe de tu plugin, puedes activar acciones en el host del admin usando el App Bridge:

Notificaciones toast — muestra banners de éxito, error, advertencia o información
Navegación — envía el admin a cualquier ruta interna (/store/...)
Modales — abre una superposición de iframe secundaria desde tu propio origen
Redimensionar — reporta la altura de tu contenido para que el admin gestione el scroll naturalmente

Facturación y Monetización

Puedes cobrar por tu plugin usando planes de suscripción definidos en el Developer Portal. Los planes soportan:

Intervalos de facturación mensuales y anuales
Períodos de prueba gratuita (días configurables por plan)
Múltiples niveles (p.ej., Básico, Pro, Enterprise)
Flujos de actualización, degradación y cancelación — todos gestionados por el host vía acciones de facturación del App Bridge

Whatalo cobra al dueño de la tienda y te paga en un calendario regular, después de deducir la comisión de la plataforma.

Distribución

Modo	Descripción
Privado	Instala directamente desde tu dashboard del Developer Portal — sin revisión requerida. Para pruebas o herramientas internas.
Público	Envía para revisión. Una vez aprobado, tu plugin aparece listado en el marketplace para que cualquier tienda Whatalo lo encuentre e instale.

El Ciclo de Vida del Desarrollo

npx create-whatalo-plugin
        ↓
   whatalo login
        ↓
   whatalo dev          ← sesión dev en vivo con túnel + vista previa en la barra lateral
        ↓
  Editar e iterar       ← los cambios del manifiesto se sincronizan automáticamente
        ↓
  whatalo validate      ← verificaciones de config, deps, seguridad
        ↓
  whatalo deploy        ← envía versión al Developer Portal
        ↓
  Solicitar revisión    ← vía dashboard del Developer Portal
        ↓
  Listado en marketplace ← una vez aprobado

Próximos Pasos

Arquitectura del Plugin — cómo funcionan técnicamente el iframe y el bridge
Requisitos Previos — qué necesitas instalar
Tu Primer Plugin — sigue el tutorial completo

On this page