Saltearse al contenido
Nappai Documentation

ActiveCampaign Pipelines

Bienvenido a la documentación del componente ActiveCampaign Pipelines. Este nodo es tu herramienta principal para gestionar cómo se organizan las ventas y los procesos en tu cuenta de ActiveCampaign.

Imagina que este componente es un asistente personal que habla el idioma de ActiveCampaign. Su trabajo es ayudarte a crear nuevos “tubos de proceso” (pipelines), donde tus clientes pasan desde el primer contacto hasta la venta cerrada, o simplemente a consultar la información de estos procesos si ya existen.

¿Cómo funciona?

Este componente actúa como un puente seguro entre Nappai y ActiveCampaign. Cuando lo utilizas, el sistema envía una solicitud al servidor de ActiveCampaign para realizar una acción específica, como crear un pipeline nuevo o buscar la información de uno existente.

Internamente, el componente verifica que tengas los permisos adecuados (a través de tu credencial), prepara la información que necesitas enviar o pedir, y espera la respuesta del servidor. Si todo sale bien, recibirás los datos organizados listos para usarlos en pasos siguientes. Si hay algún problema (como un nombre incorrecto), te indicará qué corregir.

Conexión y Credenciales

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

  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 (URL de API y Clave de API).
    • Nota: Puedes obtener estas claves en 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

Campos de Entrada

A continuación se detallan los campos que puedes configurar para interactuar con ActiveCampaign. Recuerda que los nombres de los campos deben mantenerse en inglés tal como aparecen aquí.

  • Operation: Permite elegir la acción que deseas realizar con este componente (por ejemplo, crear un pipeline, obtener información, etc.).
  • Get By: Define cómo deseas recuperar la información de los pipelines (por ID específico o una lista general).
  • Pipeline ID: El identificador único de un pipeline existente. Es necesario si quieres consultar o modificar un pipeline ya creado.
  • Pipeline Title: El nombre descriptivo del pipeline. Es un campo obligatorio si vas a crear un nuevo pipeline.
  • Currency: La moneda predeterminada para las ofertas o tratos dentro de este pipeline (ej. USD, EUR).
  • Limit: Establece el número máximo de pipelines que se devolverán en una consulta, útil para evitar listas demasiado largas.

Salidas

El componente produce una salida principal que contiene la información procesada.

  • Data: Contiene la información estructurada devuelta por ActiveCampaign. Dependiendo de la operación seleccionada, esto puede ser un objeto con el ID y nombre del pipeline creado, una lista de pipelines existentes, o confirmaciones de éxito.

Puedes conectar esta salida a otros componentes para utilizar los datos obtenidos (por ejemplo, usar el ID del pipeline para asignar una oportunidad de venta más adelante).

Ejemplo de Respuesta JSON

Cuando el componente se ejecuta correctamente, devuelve un objeto JSON similar a este ejemplo. Esto te ayuda a saber qué variables puedes usar en los siguientes pasos de tu automatización. json { “status”: “success”, “result”: { “id”: 123456, “name”: “Proceso de Ventas 2024”, “type”: “sales”, “stages”: [ { “id”: 789, “name”: “Contacto Inicial”, “order”: 0 }, { “id”: 790, “name”: “Propuesta Enviada”, “order”: 1 } ] } }

Conectividad

Este componente es el punto de entrada para gestionar la estructura de ventas en ActiveCampaign.

  • Entradas: Se conecta generalmente al flujo principal de automatización y depende estrictamente de que una credencial de ActiveCampaign esté configurada correctamente para funcionar.
  • Salidas: La salida Data suele conectarse a componentes posteriores que necesitan detalles del pipeline, como:
    • Componentes de CRM para crear o actualizar oportunidades de venta.
    • Componentes de Email Marketing para personalizar secuencias basadas en la etapa del pipeline.
    • Componentes de Lógica para tomar decisiones (ej. “Si el pipeline es ‘Ventas’, enviar correo A”).

Ejemplo de Uso

Escenario: Quieres crear un nuevo proceso de ventas para tu equipo de marketing.

  1. Añades el componente ActiveCampaign Pipelines a tu flujo.
  2. En el campo Operation, seleccionas “Create”.
  3. En Pipeline Title, escribes “Campaña Q3 - Latam”.
  4. En Currency, seleccionas “USD”.
  5. Al ejecutar el flujo, el componente enviará la solicitud a ActiveCampaign.
  6. En el siguiente paso, puedes conectar la salida Data a un componente que cree ofertas automáticamente dentro de ese nuevo pipeline.

Consejos y Mejores Prácticas

  • Nombres descriptivos: Usa nombres claros para los pipelines (ej. “Ventas - SaaS Anual” en lugar de “Pipeline 1”) para identificarlos fácilmente en ActiveCampaign.
  • Moneda correcta: Asegúrate de configurar la moneda (Currency) según el país o moneda de tus clientes para evitar confusiones en los reportes financieros.
  • Gestión de límites: Si esperas muchos resultados, usa el campo Limit para evitar sobrecargar tu navegador o flujo con datos innecesarios.

Consideraciones de Seguridad

  • Protege tus credenciales: La Clave de API (API Key) es como una contraseña maestra. Nunca la compartas públicamente ni la guardes en archivos de texto sin cifrar. En Nappai, se recomienda guardarla en la sección de Credenciales para mayor seguridad.
  • Validación de datos: Antes de crear un pipeline, verifica que los nombres no tengan caracteres especiales que ActiveCampaign no soporte, para evitar errores de validación.