Saltearse al contenido
Nappai Documentation

ActiveCampaign Deals

Este componente te permite interactuar con las oportunidades de venta (deals) y sus notas dentro de tu cuenta de ActiveCampaign. Funciona como un puente seguro entre Nappai y ActiveCampaign, permitiéndote crear, recuperar, actualizar o eliminar datos de tus clientes de manera automática.

¿Cómo funciona?

Imagina este componente como un asistente personal que habla con tu sistema de ventas. Cuando lo usas en tu flujo de trabajo, hace lo siguiente:

  1. Lee tus instrucciones: Toma la información que tú le proporcionas (como el título de una oportunidad, su valor o el contacto asociado).
  2. Habla con ActiveCampaign: Envía esa información de forma segura a la API de ActiveCampaign.
  3. Devuelve el resultado: Te entrega una confirmación de si la acción se realizó correctamente o un mensaje de error en caso de que algo fallara, listo para que lo uses en los siguientes pasos de tu automatización.

No necesitas conocer los códigos complejos de programación; simplemente le indicas qué datos quieres manejar y el componente se encarga de la comunicación técnica.

Conexión y Credenciales

Este componente requiere configurar previamente una credencial en el panel de Nappai para poder interactuar con el servicio 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:
    • API URL: La dirección de tu servidor en ActiveCampaign (ej. https://tu-cuenta.api-us1.com).
    • API Key: La clave secreta que te permite acceder a tu cuenta.
  3. En tu flujo de trabajo, selecciona la credencial guardada en el campo de entrada Credential de este componente.

Nota: Puedes obtener estas claves en tu cuenta de ActiveCampaign yendo al menú Settings > Developer.

Entradas

Los siguientes campos están disponibles para configurar este componente. Estos datos son necesarios para que el componente sepa qué acción tomar y con qué información trabajar:

  • Operation: Selecciona la operación principal que deseas realizar.
  • Get By: Indica si deseas recuperar un deal específico por su ID o buscar todos los deals disponibles.
  • Deal ID: El identificador único del deal que deseas gestionar.
  • Limit: Define el número máximo de deals que deseas devolver o recuperar en una sola operación.
  • Title: El título descriptivo de la oportunidad de venta.
  • Value: El valor monetario de la oportunidad (ej. escribir 7000 representará $7,000.00).
  • Currency: La moneda utilizada para el valor de la oportunidad (ej. USD, EUR).
  • Description: Una descripción detallada de la oportunidad o deal.
  • Association Mode: Permite elegir entre “Custom” (ingresar IDs manualmente) o “Dynamic” (seleccionar de una lista en vivo de tu cuenta).
  • Contact ID: El identificador único del contacto asociado a este deal.
  • Contact: Permite seleccionar un contacto existente directamente desde tu cuenta de ActiveCampaign.
  • Pipeline ID: El identificador del pipeline (proceso de ventas) donde se ubicará el deal.
  • Pipeline: Permite seleccionar un pipeline específico de tu cuenta.
  • Stage ID: El identificador de la etapa actual del deal dentro del pipeline.
  • Stage: Permite seleccionar una etapa. Nota: Debes elegir un Pipeline primero para filtrar las etapas disponibles.
  • Owner ID: El identificador del propietario del deal. Si se deja vacío, se asignará automáticamente al usuario de la API.
  • Note Content: El contenido textual de la nota que deseas agregar al deal.

Salidas

Este componente devuelve información estandarizada que puedes utilizar en pasos posteriores de tu automatización (por ejemplo, para enviar un correo de confirmación o actualizar una base de datos).

La salida principal se llama Data y contiene el resultado de la operación, incluyendo estados de éxito, identificadores generados y metadatos del recurso gestionado.

Ejemplo de Respuesta JSON

Cuando el componente se ejecuta correctamente, generalmente devuelve un objeto similar a este (dependiendo de la operación seleccionada): json { “status”: “success”, “data”: { “id”: 123456, “title”: “Nuevo Proyecto Web”, “value”: 5000, “currency”: “USD”, “description”: “Desarrollo de sitio web corporativo”, “status”: “open”, “owner_id”: 98765, “contact_id”: 11223, “pipeline_id”: 44556, “stage_id”: 77889 }, “message”: “Operación realizada con éxito” }

Conectividad

Este componente suele utilizarse en flujos de automatización de ventas (CRM). Lógicamente, se conecta de las siguientes maneras:

  • Como entrada: Suele recibir datos de componentes que detectan nuevos contactos o leads (ej. “ActiveCampaign Contacts” o “Webhook”).
  • Como salida: Sus resultados suelen enviarse a componentes de notificación (ej. “Send Email”) para avisar al equipo de ventas, o a herramientas de almacenamiento de datos (ej. “Spreadsheet”) para mantener un registro histórico.

Ejemplo de Uso

Imagina que tu empresa recibe un nuevo lead y quieres crear automáticamente una oportunidad de venta en ActiveCampaign.

  1. Inicio: Un componente detecta un nuevo cliente en tu base de datos.
  2. Acción: Conectas este componente ActiveCampaign Deals.
    • En el campo Operation, seleccionas “Create” (si está disponible según tu configuración).
    • En Contact, seleccionas el cliente que acaba de llegar.
    • En Title, escribes “Interés en Plan Premium”.
    • En Value, pones “1000” y en Currency “USD”.
  3. Resultado: El componente crea el deal en ActiveCampaign y devuelve el ID del nuevo deal.
  4. Siguiente paso: Usas ese ID para enviar un correo de bienvenida personalizado.

Consejos y Mejores Prácticas

  • Validación de IDs: Asegúrate de que los IDs de Contacto o Pipeline sean correctos antes de ejecutar, ya que un ID incorrecto puede resultar en un error de “Recurso no encontrado”.
  • Límites de API: ActiveCampaign tiene límites de velocidad (rate limits). Si estás procesando miles de deals, es recomendable añadir pausas o usar modos de límite controlado para evitar bloqueos temporales.
  • Selección Dinámica: Usa el modo “Dynamic” para Contactos y Pipelines siempre que sea posible; esto evita errores manuales y asegura que los datos estén actualizados en tiempo real.
  • Notas Útiles: Si agregas notas al deal, verifica que el contenido no exceda los límites de caracteres permitidos por ActiveCampaign.

Consideraciones de Seguridad

  • Protección de Credenciales: Nunca compartas tu API Key públicamente. Asegúrate de guardar la credencial en Nappai con permisos restringidos solo a usuarios autorizados.
  • Datos Sensibles: Al gestionar valores y descripciones de deals, ten cuidado con información sensible de clientes y cumple con las normativas de privacidad de tu empresa.