Saltearse al contenido
Nappai Documentation

ActiveCampaign Tags

ActiveCampaign Tags

Este componente te permite gestionar las etiquetas (conocidas como “tags”) dentro de tu cuenta de ActiveCampaign. Las etiquetas son fundamentales para organizar y categorizar a tus contactos, listas y automatizaciones de manera eficiente.

Puedes utilizar este componente para crear nuevas etiquetas, encontrar información sobre una existente, actualizar sus detalles o eliminarlas cuando ya no las necesites.

¿Cómo funciona?

Este componente actúa como un puente seguro entre tu flujo de trabajo en Nappai y la plataforma ActiveCampaign. Utiliza la API (Interfaz de Programación de Aplicaciones) de ActiveCampaign para enviar y recibir información.

Cuando configuras los campos del componente (como el nombre de la etiqueta o su ID), el sistema envía una solicitud segura al servidor de ActiveCampaign. Dependiendo de la información que proporciones, el servidor realizará la acción correspondiente (como crear una nueva etiqueta) y te devolverá una respuesta confirmando si la tarea se realizó correctamente o mostrándote los detalles de la etiqueta.

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.
    • Necesitarás el API URL (ej: https://<tu-cuenta>.api-us1.com).
    • Necesitarás el API Key (clave secreta de tu cuenta).
    • Nota: Puedes obtener estas credenciales en tu cuenta de ActiveCampaign yendo al menú Settings > Developer.
  3. Guarda los campos requeridos.
  4. En tu flujo de trabajo, selecciona la credencial que acabas de crear en el campo de entrada Credential de este componente.

Entradas

A continuación se muestran los campos disponibles para configurar el comportamiento de este componente. Utiliza estos campos para definir qué acción deseas realizar y qué datos enviar.

  • Operation: Permite seleccionar qué tipo de acción desea realizar el componente (por ejemplo, crear, buscar, actualizar o eliminar).
  • Get By: Define los criterios para recuperar una sola etiqueta por su ID o recuperar todas las etiquetas.
  • Tag Name: El nombre principal de la etiqueta que deseas crear o actualizar.
  • Tag ID: El identificador único de la etiqueta que deseas consultar, actualizar o eliminar.
  • Limit: Establece el número máximo de etiquetas que deseas devolver en la respuesta.
  • Tag Type: El tipo específico de etiqueta, si tu cuenta de ActiveCampaign utiliza esta clasificación.
  • Description: Un texto descriptivo opcional que explica el propósito de la etiqueta.

Salidas

Este componente produce datos estructurados que puedes utilizar en pasos posteriores de tu flujo de automatización.

Ejemplo de Respuesta JSON

Al ejecutar el componente con éxito, recibirás una respuesta estructurada similar a la siguiente. Puedes “mapear” estos datos a otros componentes para utilizarlos en tu flujo. json { “data”: { “id”: 123456, “tag”: “Newsletter 2023”, “description”: “Etiqueta para suscriptores del boletín mensual”, “date_added”: “2023-10-27T10:00:00”, “deleted”: 0 } }

Conectividad

Aunque este componente funciona de manera autónoma para gestionar etiquetas, es habitual utilizarlo en conjunto con otros nodos para crear flujos más completos:

  • Gestión de Contactos: Es muy común usar las etiquetas creadas aquí para segmentar audiencias en tu base de datos de contactos.
  • Automatizaciones de Email: Las etiquetas generadas pueden servir como desencadenantes para enviar correos electrónicos personalizados.
  • Validación de Datos: Puedes conectar la salida de “Éxito” de este componente para asegurar que la etiqueta se creó correctamente antes de continuar con pasos más complejos.

Ejemplo de Uso

Escenario: Quieres crear una nueva etiqueta para agrupar a los usuarios que se registraron en una reciente campaña de marketing.

  1. Configura el campo Operation para seleccionar “Crear”.
  2. En el campo Tag Name, escribe “Campaña Marketing Q4”.
  3. En el campo Description, añade “Usuarios registrados en la campaña de otoño”.
  4. Conecta el componente a tu flujo.
  5. Si la operación es exitosa, el componente devolverá un código de éxito y los metadatos de la nueva etiqueta, confirmando que ahora la etiqueta existe en tu cuenta de ActiveCampaign y está lista para ser usada.

Consejos y Mejores Prácticas

  • Nombres Descriptivos: Utiliza nombres claros y concisos para las etiquetas para facilitar la búsqueda posterior (ej: “Cliente VIP” en lugar de “Cliente 1”).
  • Gestión de Credenciales: Asegúrate de mantener tu API Key segura y no compartirla en canales públicos.
  • Uso de IDs: Si necesitas modificar una etiqueta específica en el futuro, asegúrate de guardar o registrar su Tag ID, ya que es la forma más precisa de referenciarla.

Consideraciones de Seguridad

  • API Key: La API Key otorga acceso a tu cuenta de ActiveCampaign. Trátala como una contraseña sensible.
  • Validación: El sistema valida automáticamente que las etiquetas cumplan con los límites de caracteres permitidos por ActiveCampaign para evitar errores.