SamuelChien/mega-skills-collection

Automação do ActiveCampaign via Rube MCP

Automatize operações de CRM e marketing automation do ActiveCampaign por meio do kit de ferramentas ActiveCampaign do Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ActiveCampaign ativa via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas active_campaign
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Não são necessárias chaves de API — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas active_campaign
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a autenticação do ActiveCampaign
4. Confirme que o status da conexão mostra ATIVO antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Criar e Encontrar Contatos

Quando usar: O usuário deseja criar novos contatos ou consultar os existentes

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Pesquisar um contato existente [Opcional]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT - Criar um novo contato [Obrigatório]

Parâmetros-chave para encontrar:

• email: Pesquisar por endereço de email
• id: Pesquisar pelo ID do contato no ActiveCampaign
• phone: Pesquisar por número de telefone

Parâmetros-chave para criar:

• email: Endereço de email do contato (obrigatório)
• first_name: Primeiro nome do contato
• last_name: Último nome do contato
• phone: Número de telefone do contato
• organization_name: Organização do contato
• job_title: Cargo do contato
• tags: Lista separada por vírgulas de tags a serem aplicadas

Armadilhas:

• email é o único campo obrigatório para criação de contato
• A pesquisa por telefone usa um parâmetro de pesquisa geral internamente; pode retornar correspondências parciais
• Ao combinar email e phone no FIND_CONTACT, os resultados são filtrados no lado do cliente
• Tags fornecidas durante a criação são aplicadas imediatamente
• Criar um contato com um email existente pode atualizar o contato existente

2. Gerenciar Tags de Contato

Quando usar: O usuário deseja adicionar ou remover tags de contatos

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Encontrar contato por email ou ID [Pré-requisito]
2. ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG - Adicionar ou remover tags [Obrigatório]

Parâmetros-chave:

• action: 'Add' ou 'Remove' (obrigatório)
• tags: Nomes das tags como string separada por vírgulas ou array de strings (obrigatório)
• contact_id: ID do contato (forneça este ou contact_email)
• contact_email: Endereço de email do contato (alternativa ao contact_id)

Armadilhas:

• Os valores de action são capitalizados: 'Add' ou 'Remove' (não minúsculos)
• Tags podem ser uma string separada por vírgulas ('tag1, tag2') ou um array (['tag1', 'tag2'])
• Tanto contact_id quanto contact_email devem ser fornecidos; contact_id tem precedência
• Adicionar uma tag que não existe a cria automaticamente
• Remover uma tag inexistente não causa erro (no-op)

3. Gerenciar Assinaturas de Listas

Quando usar: O usuário deseja inscrever ou cancelar inscrição de contatos em listas

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Encontrar o contato [Pré-requisito]
2. ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION - Inscrever ou cancelar inscrição [Obrigatório]

Parâmetros-chave:

• action: 'subscribe' ou 'unsubscribe' (obrigatório)
• list_id: ID numérico da lista como string (obrigatório)
• email: Endereço de email do contato (forneça este ou contact_id)
• contact_id: ID numérico do contato como string (alternativa ao email)

Armadilhas:

• Os valores de action são minúsculos: 'subscribe' ou 'unsubscribe'
• list_id é uma string numérica (ex.: '2'), não o nome da lista
• IDs de lista podem ser recuperados via endpoint GET /api/3/lists (não disponível como ferramenta Composio; use a interface do ActiveCampaign)
• Se tanto email quanto contact_id forem fornecidos, contact_id tem precedência
• Cancelar inscrição altera o status para '2' (cancelado), mas o registro de relacionamento persiste

4. Adicionar Contatos a Automações

Quando usar: O usuário deseja inscrever um contato em um fluxo de automação

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Verificar se o contato existe [Pré-requisito]
2. ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION - Inscrever contato na automação [Obrigatório]

Parâmetros-chave:

• contact_email: Email do contato a ser inscrito (obrigatório)
• automation_id: ID da automação de destino (obrigatório)

Armadilhas:

• O contato já deve existir no ActiveCampaign
• Automações só podem ser criadas através da interface do ActiveCampaign, não via API
• automation_id deve referenciar uma automação existente e ativa
• A ferramenta executa um processo de duas etapas: consultar contato por email e depois inscrever
• IDs de automação podem ser encontrados na interface do ActiveCampaign ou via GET /api/3/automations

5. Criar Tarefas de Contato

Quando usar: O usuário deseja criar tarefas de acompanhamento associadas a contatos

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Encontrar o contato para associar a tarefa [Pré-requisito]
2. ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK - Criar a tarefa [Obrigatório]

Parâmetros-chave:

• relid: ID do contato para associar a tarefa (obrigatório)
• duedate: Data de vencimento no formato ISO 8601 com fuso horário (obrigatório, ex.: '2025-01-15T14:30:00-05:00')
• dealTasktype: ID do tipo de tarefa baseado nos tipos disponíveis (obrigatório)
• title: Título da tarefa
• note: Descrição/conteúdo da tarefa
• assignee: ID do usuário para atribuir a tarefa
• edate: Data de término no formato ISO 8601 (deve ser posterior a duedate)
• status: 0 para incompleta, 1 para completa

Armadilhas:

• duedate deve ser uma data/hora ISO 8601 válida com offset de fuso horário; NÃO use valores placeholders
• edate deve ser posterior a duedate
• dealTasktype é um ID de string referenciando tipos de tarefa configurados no ActiveCampaign
• relid é o ID numérico do contato, não o endereço de email
• assignee é um ID de usuário; resolva nomes de usuário para IDs através da interface do ActiveCampaign

Padrões Comuns

Fluxo de Consulta de Contato

1. Chame ACTIVE_CAMPAIGN_FIND_CONTACT com email
2. Se encontrado, extraia o ID do contato para operações subsequentes
3. Se não encontrado, crie contato com ACTIVE_CAMPAIGN_CREATE_CONTACT
4. Use o ID do contato para tags, assinaturas ou automações

Marcação em Massa de Contatos

1. Para cada contato, chame ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. Use contact_email para evitar chamadas de consulta separadas
3. Agrupe com atrasos razoáveis para respeitar limites de taxa

Resolução de IDs

Email do contato -> ID do contato:

1. Chame ACTIVE_CAMPAIGN_FIND_CONTACT com email
2. Extraia o id da resposta

Armadilhas Conhecidas

Capitalização de Ação:

• Ações de tag: 'Add', 'Remove' (capitalizadas)
• Ações de assinatura: 'subscribe', 'unsubscribe' (minúsculas)
• Misturar capitalizações causa erros

Tipos de IDs:

• IDs de contato: strings numéricas (ex.: '123')
• IDs de lista: strings numéricas
• IDs de automação: strings numéricas
• Todos os IDs devem ser passados como strings, não inteiros

Automações:

• Automações não podem ser criadas via API; apenas a inscrição é possível
• A automação deve estar ativa para aceitar novos contatos
• Inscrever um contato já presente na automação pode não ter efeito

Limites de Taxa:

• A API do ActiveCampaign possui limites de taxa por conta
• Implemente backoff em respostas 429
• Operações em lote devem ser espaçadas adequadamente

Análise de Respostas:

• Os dados de resposta podem estar aninhados sob data ou data.data
• Analise defensivamente com padrões de fallback
• A pesquisa de contatos pode retornar vários resultados; corresponda por email para precisão

Referência Rápida

Tarefa	Slug da Ferramenta	Parâmetros-chave
Encontrar contato	ACTIVE_CAMPAIGN_FIND_CONTACT	email, id, phone
Criar contato	ACTIVE_CAMPAIGN_CREATE_CONTACT	email, first_name, last_name, tags
Adicionar/remover tags	ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG	action, tags, contact_email
Inscrever/cancelar inscrição	ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION	action, list_id, email
Adicionar à automação	ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION	contact_email, automation_id
Criar tarefa	ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK	relid, duedate, dealTasktype, title

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou ações descritas na visão geral.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se entradas, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.