Saltearse al contenido
Nappai Documentation

Shopify Webhook

Este componente funciona como un puente inteligente entre tu tienda de Shopify y el sistema de automatización Nappai. Su propósito principal es recibir señales cada vez que ocurre un cambio importante en tu tienda (como un nuevo pedido, la creación de un producto o la actualización de un cliente) y preparar esa información de forma organizada para que puedas usarla en tus siguientes pasos de automatización.

¿Cómo funciona?

Imagina que este componente es un “sentinela” que escucha activamente a tu tienda Shopify. Cuando alguien compra algo, agregas un nuevo producto o editas el precio de un ítem, Shopify envía una notificación (un “webhook”) a este componente.

El componente intercepta esa notificación, lee los detalles del cambio y los transforma en un formato estructurado y fácil de entender. Luego, envía esta información estructurada al siguiente paso de tu flujo de trabajo (por ejemplo, para que un asistente de IA analice el pedido o para enviar un email de confirmación).

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio externo:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial del tipo especificado para este componente y guarda los campos requeridos (claves de API, tokens, etc.).
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este nodo.

Entradas

Los siguientes campos están disponibles para configurar este componente.

  • resource_type: Especifica qué tipo de recurso de Shopify deseas monitorear para detectar modificaciones.

    • Visible en: Todas las configuraciones
    • Tipo: Menú desplegable. Por defecto, está configurado para vigilar orders (pedidos).

  • events: Define los cambios específicos que quieres vigilar en el recurso seleccionado (por ejemplo, si algo se crea o se actualiza).

    • Visible en: Todas las configuraciones
    • Tipo: Selección múltiple. Te permite elegir varias opciones (como “Creación” y “Actualización”) al mismo tiempo.

  • Credential: Selecciona una credencial de tipo Shopify API previamente configurada en tu panel de Nappai para autorizar la conexión segura con tu tienda.

    • Visible en: Todas las configuraciones

Salidas

Data

El componente produce una salida llamada Data. Esta salida contiene la información estructurada del evento recibido, incluyendo metadatos clave como el ID del registro, el título (o nombre), la fecha de actualización y el tipo de evento (por ejemplo, “order_created”).

Puedes conectar esta salida a otros componentes (como LLMs, acciones de API o transformadores) para realizar acciones automatizadas basadas en los cambios de tu tienda.

Ejemplo de Respuesta JSON

A continuación, se muestra un ejemplo de cómo se ve la estructura de los datos que este componente devuelve al ejecutarse con éxito. Esto te ayudará a saber qué información puedes usar en los siguientes nodos de tu flujo: json { “event”: “order_created”, “resource_type”: “orders”, “id”: “gid://shopify/Order/123456789”, “title”: “Order #1001”, “updated_at”: “2023-10-27T14:30:00”, “record”: { “id”: 123456789, “name”: “#1001”, “email”: “cliente@ejemplo.com”, “total_price”: “100.00”, “currency”: “USD”, “status”: “pending” } }

Conectividad

Este componente se conecta típicamente hacia otros nodos de procesamiento en tu flujo de trabajo (como Langflow).

  • Flujo Lógico: Una vez que este componente recibe y estructura los datos de un cambio en Shopify, generalmente se conecta a:
    • Nodos de LLM (IA): Para analizar el pedido o redactar respuestas.
    • Acciones de API: Para enviar datos a otra herramienta (como un CRM o correo electrónico).
    • Lógica Condicional: Para decidir qué hacer si el evento es de “alta prioridad” o “bajo valor”.

Ejemplo de Uso

Escenario: Quieres automatizar el seguimiento de nuevos pedidos.

  1. Configuras este componente para vigilar orders (Pedidos).
  2. En events, seleccionas “Order Created” (Pedido Creado).
  3. Conectas la salida Data a un nodo de “Enviar Email”.
  4. Cuando un cliente realiza una compra en Shopify, el webhook se activa, recibe los datos del pedido y los envía automáticamente al nodo de email para confirmar la compra.

Consejos y Mejores Prácticas

  • Permisos de API: Asegúrate de que tu credencial de Shopify tenga los permisos necesarios (scopes) para leer el tipo de recurso que estás monitoreando (ej. read_orders para pedidos).
  • Selección de Eventos: No selecciones más eventos de los necesarios. Vigilar solo lo que realmente necesitas (ej. solo “Crear” y no “Actualizar”) ayuda a mantener el flujo de automatización más limpio y eficiente.
  • Manejo de Errores: El componente está diseñado para ser resistente; si recibe datos vacíos o mal formados, no romperá el flujo, sino que devolverá un estado indicando “No data provided”.

Consideraciones de Seguridad

  • Protección de Claves: Nunca compartas tus claves de API (API Client ID / API Secret Key) públicamente. Asegúrate de usar credenciales con acceso mínimo necesario (principio de menor privilegio) en la configuración de tu app en Shopify.
  • HTTPS: Asegúrate de que tu entorno de automatización (Nappai) esté configurado correctamente para recibir webhooks de forma segura.