SamuelChien/mega-skills-collection

Automatización de ActiveCampaign mediante Rube MCP

Automatiza las operaciones de CRM y marketing automation de ActiveCampaign a través del toolkit de ActiveCampaign de Composio mediante Rube MCP.

Requisitos previos

• Rube MCP debe estar conectado (RUBE_SEARCH_TOOLS disponible)
• Conexión activa de ActiveCampaign mediante RUBE_MANAGE_CONNECTIONS con toolkit active_campaign
• Siempre llama a RUBE_SEARCH_TOOLS primero para obtener los esquemas actuales de las herramientas

Configuración

Obtén Rube MCP: Agrega https://rube.app/mcp como servidor MCP en la configuración de tu cliente. No se necesitan claves API — solo agrega el endpoint y funciona.

1. Verifica que Rube MCP esté disponible confirmando que RUBE_SEARCH_TOOLS responde
2. Llama a RUBE_MANAGE_CONNECTIONS con toolkit active_campaign
3. Si la conexión no está ACTIVA, sigue el enlace de autenticación devuelto para completar la autenticación de ActiveCampaign
4. Confirma que el estado de la conexión muestre ACTIVO antes de ejecutar cualquier flujo de trabajo

Flujos de trabajo principales

1. Crear y buscar contactos

Cuándo usar: El usuario quiere crear nuevos contactos o buscar los existentes

Secuencia de herramientas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Buscar un contacto existente [Opcional]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT - Crear un nuevo contacto [Requerido]

Parámetros clave para buscar:

• email: Buscar por dirección de correo electrónico
• id: Buscar por ID de contacto de ActiveCampaign
• phone: Buscar por número de teléfono

Parámetros clave para crear:

• email: Dirección de correo electrónico del contacto (requerido)
• first_name: Nombre del contacto
• last_name: Apellido del contacto
• phone: Número de teléfono del contacto
• organization_name: Organización del contacto
• job_title: Cargo del contacto
• tags: Lista separada por comas de etiquetas a aplicar

Errores comunes:

• email es el único campo requerido para la creación de contactos
• La búsqueda por teléfono utiliza un parámetro de búsqueda general internamente; puede devolver coincidencias parciales
• Al combinar email y phone en FIND_CONTACT, los resultados se filtran del lado del cliente
• Las etiquetas proporcionadas durante la creación se aplican inmediatamente
• Crear un contacto con un correo existente puede actualizar el contacto existente

2. Gestionar etiquetas de contacto

Cuándo usar: El usuario quiere agregar o eliminar etiquetas de los contactos

Secuencia de herramientas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Buscar contacto por correo o ID [Requisito previo]
2. ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG - Agregar o eliminar etiquetas [Requerido]

Parámetros clave:

• action: 'Add' o 'Remove' (requerido)
• tags: Nombres de etiquetas como cadena separada por comas o arreglo de cadenas (requerido)
• contact_id: ID de contacto (proporciona esto o contact_email)
• contact_email: Dirección de correo electrónico del contacto (alternativa a contact_id)

Errores comunes:

• Los valores de action están en mayúscula: 'Add' o 'Remove' (no en minúscula)
• Las etiquetas pueden ser una cadena separada por comas ('tag1, tag2') o un arreglo (['tag1', 'tag2'])
• Se debe proporcionar contact_id o contact_email; contact_id tiene prioridad
• Agregar una etiqueta que no existe la crea automáticamente
• Eliminar una etiqueta inexistente no tiene efecto (no genera error)

3. Gestionar suscripciones a listas

Cuándo usar: El usuario quiere suscribir o cancelar la suscripción de contactos de listas

Secuencia de herramientas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Buscar el contacto [Requisito previo]
2. ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION - Suscribir o cancelar suscripción [Requerido]

Parámetros clave:

• action: 'subscribe' o 'unsubscribe' (requerido)
• list_id: Cadena de ID de lista numérica (requerido)
• email: Dirección de correo electrónico del contacto (proporciona esto o contact_id)
• contact_id: Cadena de ID de contacto numérica (alternativa a email)

Errores comunes:

• Los valores de action están en minúscula: 'subscribe' o 'unsubscribe'
• list_id es una cadena numérica (por ejemplo, '2'), no el nombre de la lista
• Los IDs de lista se pueden recuperar mediante el endpoint GET /api/3/lists (no disponible como herramienta de Composio; usa la interfaz de ActiveCampaign)
• Si se proporcionan tanto email como contact_id, contact_id tiene prioridad
• Cancelar la suscripción cambia el estado a '2' (no suscrito) pero el registro de relación persiste

4. Agregar contactos a automatizaciones

Cuándo usar: El usuario quiere inscribir un contacto en un flujo de trabajo de automatización

Secuencia de herramientas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Verificar que el contacto existe [Requisito previo]
2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION - Inscribir contacto en automatización [Requerido]

Parámetros clave:

• contact_email: Correo electrónico del contacto a inscribir (requerido)
• automation_id: ID de la automatización objetivo (requerido)

Errores comunes:

• El contacto debe existir ya en ActiveCampaign
• Las automatizaciones solo se pueden crear a través de la interfaz de ActiveCampaign, no mediante API
• automation_id debe referenciar una automatización existente y activa
• La herramienta realiza un proceso de dos pasos: buscar contacto por correo, luego inscribir
• Los IDs de automatización se pueden encontrar en la interfaz de ActiveCampaign o mediante GET /api/3/automations

5. Crear tareas de contacto

Cuándo usar: El usuario quiere crear tareas de seguimiento asociadas con contactos

Secuencia de herramientas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Buscar el contacto para asociar la tarea [Requisito previo]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK - Crear la tarea [Requerido]

Parámetros clave:

• relid: ID de contacto para asociar la tarea (requerido)
• duedate: Fecha de vencimiento en formato ISO 8601 con zona horaria (requerido, por ejemplo, '2025-01-15T14:30:00-05:00')
• dealTasktype: ID de tipo de tarea basado en los tipos disponibles (requerido)
• title: Título de la tarea
• note: Descripción/contenido de la tarea
• assignee: ID de usuario para asignar la tarea
• edate: Fecha de finalización en formato ISO 8601 (debe ser posterior a duedate)
• status: 0 para incompleta, 1 para completa

Errores comunes:

• duedate debe ser una fecha y hora ISO 8601 válida con desplazamiento de zona horaria; NO uses valores de marcador de posición
• edate debe ser posterior a duedate
• dealTasktype es un ID de cadena que referencia los tipos de tarea configurados en ActiveCampaign
• relid es el ID de contacto numérico, no la dirección de correo electrónico
• assignee es un ID de usuario; resuelve los nombres de usuario a IDs a través de la interfaz de ActiveCampaign

Patrones comunes

Flujo de búsqueda de contacto

1. Llama a ACTIVE_CAMPAIGN_FIND_CONTACT con el correo
2. Si se encuentra, extrae el ID de contacto para operaciones posteriores
3. Si no se encuentra, crea el contacto con ACTIVE_CAMPAIGN_CREATE_CONTACT
4. Usa el ID de contacto para etiquetas, suscripciones o automatizaciones

Etiquetado masivo de contactos

1. Para cada contacto, llama a ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. Usa contact_email para evitar llamadas de búsqueda separadas
3. Procesa en lotes con retrasos razonables para respetar los límites de tasa

Resolución de IDs

Correo de contacto -> ID de contacto:

1. Llama a ACTIVE_CAMPAIGN_FIND_CONTACT con el correo
2. Extrae el id de la respuesta

Errores comunes conocidos

Uso de mayúsculas en acciones:

• Acciones de etiquetas: 'Add', 'Remove' (en mayúscula)
• Acciones de suscripción: 'subscribe', 'unsubscribe' (en minúscula)
• Mezclar mayúsculas causa errores

Tipos de ID:

• IDs de contacto: cadenas numéricas (por ejemplo, '123')
• IDs de lista: cadenas numéricas
• IDs de automatización: cadenas numéricas
• Todos los IDs deben pasarse como cadenas, no enteros

Automatizaciones:

• Las automatizaciones no se pueden crear mediante API; solo es posible la inscripción
• La automatización debe estar activa para aceptar nuevos contactos
• Inscribir un contacto que ya está en la automatización puede no tener efecto

Límites de tasa:

• La API de ActiveCampaign tiene límites de tasa por cuenta
• Implementa retrocesos en respuestas 429
• Las operaciones por lotes deben espaciarse adecuadamente

Análisis de respuestas:

• Los datos de respuesta pueden estar anidados bajo data o data.data
• Analiza de forma defensiva con patrones de respaldo
• La búsqueda de contactos puede devolver múltiples resultados; coincidir por correo para mayor precisión

Referencia rápida

Tarea	Slug de herramienta	Parámetros clave
Buscar contacto	ACTIVE_CAMPAIGN_FIND_CONTACT	email, id, phone
Crear contacto	ACTIVE_CAMPAIGN_CREATE_CONTACT	email, first_name, last_name, tags
Agregar/eliminar etiquetas	ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG	action, tags, contact_email
Suscribir/cancelar suscripción	ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION	action, list_id, email
Agregar a automatización	ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION	contact_email, automation_id
Crear tarea	ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK	relid, duedate, dealTasktype, title

Cuándo usar

Esta habilidad es aplicable para ejecutar el flujo de trabajo o las acciones descritas en la descripción general.

Limitaciones

• Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
• No trates la salida como un sustituto de la validación, las pruebas o la revisión de expertos específicos del entorno.
• Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.