Saltearse al contenido
Nappai Documentation

ActiveCampaign Stages

Bienvenido al componente ActiveCampaign Stages. Esta herramienta te permite organizar y controlar los pasos (etapas) de tus embudos de ventas dentro de ActiveCampaign. Con ella, podrás estructurar mejor tu proceso de venta, desde que un contacto es identificado hasta que cierra un acuerdo.

¿Cómo funciona?

Este componente actúa como un puente entre Nappai y tu cuenta de ActiveCampaign. Su trabajo principal es entender qué acción deseas realizar con las etapas de tus ofertas y ejecutarla automáticamente.

Por ejemplo, puedes usarlo para crear una nueva etapa en tu embudo (como “En Negociación”), buscar los detalles de una etapa específica que ya creaste, o eliminar aquellas que ya no necesites. Internamente, se comunica con la API de ActiveCampaign, verifica que los datos sean correctos y devuelve la información actualizada para que puedas continuar con los siguientes pasos de tu automatización.

Conexión y Credenciales

Para que este componente funcione, necesitas conectarlo a tu cuenta de ActiveCampaign. Esto se hace mediante una Credencial.

Sigue estos pasos para configurarla:

  1. Dirígete a la sección de Credenciales en tu panel de Nappai.
  2. Crea una nueva credencial seleccionando el tipo ActiveCampaign.
  3. Para obtener los datos necesarios, inicia sesión en tu cuenta de ActiveCampaign y ve al menú Settings > Developer.
    • Copia la API URL (es la dirección de tu cuenta).
    • Copia la API Key (es la clave secreta de acceso).
  4. Pega estos datos en la credencial de Nappai y guárdala.
  5. En este componente, selecciona la credencial que acabas de crear en el campo Credential.

Nota importante: No necesitas ingresar la API URL o la API Key directamente en los campos de entrada de este nodo; solo debes seleccionar la credencial guardada.

Entradas

A continuación se describen los campos disponibles para configurar este componente. Todos los nombres de campos se muestran en inglés tal como aparecen en la interfaz.

  • Credential: Selecciona la credencial de ActiveCampaign configurada previamente para autorizar la conexión.
  • Operation: Selecciona la acción que deseas realizar (por ejemplo: Crear una etapa, Obtener una etapa, Eliminar una etapa).
  • Get By: Define cómo deseas recuperar la información (por ejemplo: buscar por ID específico o obtener todas las etapas del pipeline).
  • Stage ID: Ingresa el identificador único de una etapa específica. Es necesario si quieres obtener detalles o eliminar una etapa existente.
  • Stage Title: El nombre descriptivo de la etapa. Este campo es obligatorio al crear una nueva etapa (Ejemplo: “Negociación”, “Cerrada”).
  • Pipeline ID: El identificador del embudo (pipeline) al que pertenece la etapa. Ayuda a filtrar o especificar en qué flujo de ventas se creará la etapa.
  • Order: Número que define la posición de la etapa dentro del embudo. El valor 1 corresponde a la primera etapa, 2 a la segunda, y así sucesivamente.
  • Limit: Número máximo de etapas que deseas recuperar en una búsqueda (útil para no cargar demasiados datos a la vez).

Salidas

Al ejecutar este componente, recibirás la siguiente información:

  • Data: Contiene los detalles completos de la etapa gestionada. Incluye información como el ID, el nombre, el color asignado, la posición y el estado (si está activa o eliminada). Este dato se utiliza en el siguiente paso de tu flujo de trabajo.

Ejemplo de Respuesta JSON

Cuando el componente funciona correctamente, devolverá una estructura de datos similar a esta: json { “id”: 123456, “name”: “Negociación”, “order”: 3, “color”: “#007bff”, “deleted”: false, “url”: “https://youraccount.api-us1.com/stages/123456” }

Conectividad

Este componente suele conectarse a otros nodos de automatización de CRM. Por ejemplo:

  • Conecta su salida Data a un nodo de Email Marketing para enviar correos personalizados dependiendo de la etapa en la que se encuentra el cliente.
  • Se conecta a un nodo de Base de Datos para registrar el estado actual del acuerdo.
  • Puede alimentar un nodo de IA para analizar la efectividad de las etapas del embudo.

Ejemplo de Uso

Escenario: Quieres añadir una nueva etapa llamada “Cotización Enviada” a tu embudo de ventas.

  1. Abre el nodo ActiveCampaign Stages.
  2. En el campo Credential, selecciona tu cuenta de ActiveCampaign.
  3. En Operation, elige la opción para Crear.
  4. En Stage Title, escribe “Cotización Enviada”.
  5. En Order, escribe 2 para que aparezca después de la primera etapa.
  6. Ejecuta el flujo. Si todo sale bien, verás el nuevo ID y detalles en la salida Data, confirmando que la etapa se creó correctamente.

Consejos y Mejores Prácticas

  • Nombres Claros: Usa nombres descriptivos en Stage Title para que tu equipo entienda rápidamente en qué paso del proceso se encuentra cada cliente.
  • Orden Lógico: Asegúrate de que el número en Order refleje la secuencia real de tu venta (ej. 1 para “Contacto”, 2 para “Interesado”, etc.).
  • Validación: Si la API devuelve un error, revisa que los nombres de las etapas no contengan caracteres especiales no permitidos.
  • Gestión de Límites: Usa el campo Limit si esperas muchas etapas, para evitar sobrecargar tu flujo con demasiada información a la vez.

Consideraciones de Seguridad

  • Protección de Claves: Nunca compartas tu API Key ni tu API URL públicamente. Úsalas solo en las credenciales configuradas dentro de Nappai.
  • Acceso Restringido: Asegúrate de que la cuenta de ActiveCampaign utilizada tenga permisos suficientes para crear y modificar embudos.
  • Datos Sensibles: La información devuelta en Data puede contener identificadores únicos importantes; úsala con cuidado en pasos posteriores de tu automatización.