Saltearse al contenido
Nappai Documentation

ActiveCampaign Lists

ActiveCampaign Lists te permite crear, consultar y gestionar listas de contactos dentro de tu cuenta de ActiveCampaign desde Nappai. Es la herramienta ideal para mantener organizados tus suscriptores, crear nuevos segmentos de audiencia y preparar tus campañas de marketing o comunicación.

¿Cómo funciona?

Este componente se conecta directamente con la API de ActiveCampaign para interactuar con tus listas de contactos. Al configurarlo, le indicas qué deseas hacer, como crear una nueva lista, obtener información de una lista existente o actualizar detalles.

Para que funcione correctamente, debes proporcionar información básica como el nombre de la lista, la URL de tu sitio web y un texto de recordatorio para los suscriptores. Una vez que ejecutas el flujo, el componente envía estas instrucciones a ActiveCampaign y devuelve los resultados en formato de datos que puedes utilizar en los siguientes pasos de tu automatización, por ejemplo, para añadir contactos o enviar correos.

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 (URL de la API y Clave de API). Puedes obtener estos datos 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

  • Operation: Selecciona la operación que deseas realizar.
  • Get By: Elige si deseas recuperar una lista específica por su ID o obtener todas las listas disponibles.
  • List Name: Nombre descriptivo para tu lista de contactos.
  • List ID: Identificador único de una lista existente, necesario para actualizarla o eliminarla.
  • Limit: Número máximo de listas a devolver cuando consultas varios registros.
  • Sender URL: La URL de tu sitio web o página web donde los suscriptores se registraron. Este campo es obligatorio para cumplir con los estándares de ActiveCampaign.
  • Sender Reminder: Un texto corto que recuerda a los suscriptores por qué están en esta lista (ej. “Te registraste en nuestro sitio web”). Este campo es obligatorio.

Salidas

El componente genera los siguientes datos como resultado de su ejecución:

  • Data: Información completa de la lista o listas procesadas. Estos datos incluyen detalles como el ID, el nombre, la fecha de creación y la configuración de la lista, los cuales puedes conectar a otros componentes para continuar con tu automatización.

Ejemplo de Respuesta JSONjson

{ “status”: “success”, “data”: [ { “id”: 12345678, “name”: “Clientes Potenciales”, “date_created”: “2023-10-27T14:30:00”, “sender_url”: “https://tu-sitio-web.com”, “sender_reminder”: “Te suscribiste en nuestra página de contacto.” } ] }

Conectividad

Los datos devueltos por ActiveCampaign Lists suelen utilizarse como entrada para otras acciones de automatización. Por ejemplo, puedes conectar esta lista con nodos de envío de correos electrónicos, actualizaciones de CRM o bases de datos para gestionar el ciclo de vida de tus contactos. Es común que la salida de este componente alimente listas de segmentación, flujos de automatización de bienvenida o reportes de seguimiento.

Ejemplo de Uso

Imagina que acabas de lanzar una nueva campaña de newsletter y quieres crear una lista exclusiva para los suscriptores.

  1. Configuras ActiveCampaign Lists con tu credencial de ActiveCampaign.
  2. En Operation, seleccionas la acción para crear una lista.
  3. En List Name, escribes “Newsletter 2024”.
  4. En Sender URL, ingresas “https://miempresa.com”.
  5. En Sender Reminder, escribes “Gracias por suscribirte a nuestro boletín mensual”.
  6. Al ejecutar el flujo, el componente crea la lista en ActiveCampaign y te devuelve los datos de confirmación, que luego puedes usar para añadir contactos automáticamente a esa nueva lista o enviarles un correo de bienvenida.

Consejos y Mejores Prácticas

  • Asegúrate de completar Sender URL y Sender Reminder correctamente, ya que son obligatorios y ayudan a mantener el cumplimiento de las normativas de correo electrónico.
  • Usa nombres claros y descriptivos en List Name para mantener un orden fácil de identificar en tus listas de contactos.
  • Revisa los límites de tu plan en ActiveCampaign al usar Limit para evitar interrupciones por exceso de peticiones.
  • Verifica que la credencial tenga los permisos adecuados para lectura y escritura si planeas modificar o crear listas.

Consideraciones de Seguridad

  • Mantén tu credencial API segura y no la compartas en lugares públicos dentro de tus flujos de automatización.
  • Asegúrate de que los datos de tus listas cumplan con las normativas de privacidad aplicables (como GDPR) y que los usuarios hayan otorgado su consentimiento para ser contactados.
  • Utiliza Sender Reminder para ser transparente con tus suscriptores sobre el origen de sus datos, lo que reduce el riesgo de que marquen tus correos como spam.