Saltearse al contenido
Nappai Documentation

ActiveCampaign E-commerce Orders

Bienvenido al nodo ActiveCampaign E-commerce Orders. Este componente es tu puente directo entre tu sistema de ventas y la plataforma de automatización de ActiveCampaign. Su función principal es permitirte recuperar, crear o actualizar pedidos junto con la lista de productos que los componen, facilitando la sincronización automática entre tu e-commerce y tus campañas de marketing o CRM.

¿Cómo funciona?

Imagina este componente como un mensajero inteligente y seguro. Cuando lo agregas a tu flujo de trabajo en Nappai, se conecta a la API oficial de ActiveCampaign para leer o enviar información de pedidos. Internamente, toma los datos que le proporciones (como el identificador de una orden, su fecha, precio o lista de productos) y los envía en un formato estructurado que ActiveCampaign entiende. A cambio, recibe toda la información del pedido actualizado en un formato listo para usar en los siguientes pasos de tu automatización. El componente se encarga de toda la comunicación técnica, para que tú solo te preocupes por tomar decisiones basadas en tus ventas.

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 ActiveCampaign y guarda los campos requeridos (API URL y API Key). Puedes obtener estos datos accediendo a tu cuenta de ActiveCampaign, yendo al menú Settings > Developer.
  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. Cada campo puede estar visible en diferentes operaciones:

  • Operation: Permite elegir la acción principal que deseamos realizar con el componente en el flujo.
  • Get By: Define si queremos recuperar un pedido específico por su ID interno o obtener un listado completo de pedidos.
  • Order ID: Identificador interno único que ActiveCampaign asigna a cada pedido para poder consultarlos o eliminarlos.
  • Limit: Número máximo de pedidos que deseamos recuperar en una sola consulta para evitar sobrecargar el sistema.
  • Service ID Mode: Indica si ingresaremos el identificador del servicio de e-commerce manualmente o si lo seleccionaremos dinámicamente desde nuestras conexiones guardadas.
  • Service ID: Identificador único de la conexión de integración de e-commerce (por ejemplo, Shopify, WooCommerce) que estamos utilizando.
  • Service: Permite seleccionar una conexión de e-commerce previamente registrada en tu cuenta de ActiveCampaign.
  • Customer Mode: Define si ingresaremos el identificador del cliente de ActiveCampaign manualmente o si lo seleccionaremos desde clientes existentes de tu tienda.
  • AC Customer ID: Identificador interno que ActiveCampaign utiliza para reconocer a cada cliente en su plataforma.
  • Customer: Permite seleccionar un cliente de e-commerce ya existente en tu base de datos de ActiveCampaign.
  • External Order ID: Identificador único del pedido tal como aparece en la plataforma externa de tu tienda online.
  • Order Number: Número de pedido legible para humanos (por ejemplo, #1001) que facilita la identificación visual.
  • Order URL: Enlace directo que redirige al pedido dentro de la plataforma externa de tu tienda.
  • Order Date: Fecha exacta en la que se realizó el pedido. Debe escribirse en formato ISO 8601 (ej. 2024-01-15T10:30:00-05:00).
  • Customer Email: Correo electrónico del cliente que realizó la compra, necesario para personalizar seguimientos y notificaciones.
  • Total Price: Valor total del pedido en centavos o unidades mínimas (ej. 7000 equivale a $70.00).
  • Currency: Moneda en la que se ejecutará la transacción del pedido.
  • Shipping Amount: Costo total del envío del pedido.
  • Tax Amount: Monto total de impuestos aplicados a la orden.
  • Discount Amount: Porcentaje o monto de descuento aplicado al pedido.
  • Order Status: Estado actual del pedido (por ejemplo, pendiente, completado, cancelado o enviado).
  • Number of Products: Cantidad de productos que agregaremos a este pedido. Al indicarlo, se despliega automáticamente un campo adicional por cada artículo para detallar sus propiedades.

Salidas

Qué produce el componente

  • Data: Contiene toda la información estructurada del pedido consultado o creado. Incluye identificadores, estados, fechas, totales, datos del cliente y la lista detallada de productos. Esta salida está lista para ser arrastrada y conectada a otros nodos (como emails de seguimiento, actualizaciones de CRM o reportes de inventario).

Ejemplo de Respuesta JSON

Al ejecutar el componente con éxito, recibirás una estructura similar a la siguiente en la salida Data. Esta es la referencia que puedes usar para mapear valores en los siguientes nodos de tu automatización: json { “id”: 45892, “status”: “completed”, “external_order_id”: “ECM-7782”, “order_number”: “#10042”, “order_date”: “2024-05-12T14:30:00-05:00”, “order_url”: “https://tutienda.com/orders/10042”, “customer”: { “email”: “cliente@ejemplo.com”, “ac_customer_id”: “AC-3321” }, “financials”: { “total_price”: 7500, “currency”: “USD”, “shipping_amount”: 400, “tax_amount”: 150, “discount_amount”: 200 }, “products”: [ { “product_id”: “PROD-01”, “name”: “Camiseta Básica”, “quantity”: 2, “price”: 3500 } ] }

Conectividad

Este componente suele conectarse como un puente de datos en el centro de tus flujos de automatización:

  • Entrada lógica: Recibe información de nodos que monitorizan tiendas online (Shopify, WooCommerce, PrestaShop) o de formularios de pago.
  • Salida lógica: Sus datos típicamente alimentan nodos de email marketing (para enviar comprobantes o seguimiento postventa), CRM (para actualizar el estado del cliente) o tablas de analítica (para generar reportes de ventas). Su estructura estructurada lo hace ideal para alimentar automatizaciones que dependen de valores precisos como precios, estados de envío o correos electrónicos.

Ejemplo de Uso

Escenario: Seguimiento automatizado post-compra

  1. Tu sistema detecta una nueva venta en tu tienda online y envía los datos a Nappai.
  2. Usas ActiveCampaign E-commerce Orders para recuperar los detalles completos de esa orden usando su ID externo.
  3. El nodo devuelve la salida Data con el correo del cliente, el total pagado y el estado del pedido.
  4. Conectas esa salida a un nodo de Email Marketing que activa un mensaje personalizado: “Gracias por tu compra #10042. Tu pedido está en camino”.
  5. Si el estado del pedido cambia a cancelled, el flujo puede reenviar automáticamente un email de confirmación de reembolso. El componente se encarga de mantener sincronizada toda esta información en tiempo real.

Consejos y Mejores Prácticas

  • Utiliza el modo dinámico (Service ID Mode y Customer Mode) cuando manejas múltiples tiendas o clientes; te ahorrará configurar manualmente los IDs en cada nodo.
  • Verifica siempre que las fechas ingresadas en Order Date sigan estrictamente el formato ISO 8601 para evitar errores de validación en la API.
  • Si tu tienda genera un volumen alto de pedidos, configura un Limit adecuado para no exceder los límites de consultas de ActiveCampaign y mantener tu automatización estable.
  • Usa los campos de estado (Order Status) como filtros condicionales en tus flujos para dirigir caminos diferentes a clientes según si su pedido está pendiente, completado o cancelado.

Consideraciones de Seguridad

  • Nunca compartas ni expongas tus credenciales de API en espacios públicos o en el código de tus flujos. La sección de Credenciales de Nappai está diseñada para almacenarlas de forma encriptada y segura.
  • Revisa periódicamente los permisos de tu cuenta de ActiveCampaign y revoca el acceso a credenciales que ya no necesites.
  • Mantén un registro simple de los IDs de servicios y clientes que uses frecuentemente para agilizar futuras automatizaciones y reducir errores de mapeo.