Automação do ActiveCampaign via Rube MCP

Automatize as operações de CRM e automação de marketing do ActiveCampaign através do kit de ferramentas ActiveCampaign da Composio via Rube MCP.

Pré-requisitos

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

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Autenticação e permissões dependem do host e da integração Rube atual; adicionar um endpoint por si só não prova o acesso. Aplique a configuração do host apenas quando autorizado.

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 completar a autenticação do ActiveCampaign
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Autorização e verificação

Os slugs das ferramentas e as notas de parâmetros são exemplos; os esquemas atuais descobertos têm precedência. Identifique a conta exata, os contatos e as mutações solicitadas, leia o estado existente e verifique se as tags ou a inscrição em automação acionam mensagens de saída. A criação de contatos não implica consentimento de assinatura. Obtenha autorização explícita para envio/inscrição com esses efeitos e preserve o status de cancelamento de inscrição/supressão. Leia os resultados de volta; reconcilie timeouts antes de tentar novamente operações não idempotentes.

Fluxos de Trabalho Principais

1. Criar e Encontrar Contatos

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

Sequência de ferramentas:

1. ACTIVE_CAMPAIGN_FIND_CONTACT - Pesquisar um contato existente exato antes de uma criação/atualização solicitada
2. ACTIVE_CAMPAIGN_CREATE_CONTACT - Criar apenas quando solicitado e não presente; solicitações de apenas pesquisa não realizam criação

Parâmetros chave para encontrar:

• email: Pesquisar por endereço de e-mail
• id: Pesquisar por ID de contato do ActiveCampaign
• phone: Pesquisar por número de telefone

Parâmetros chave para criar:

• email: Endereço de e-mail do contato (obrigatório)
• first_name: Primeiro nome do contato
• last_name: Sobrenome do contato
• phone: Número de telefone do contato
• organization_name: Organização do contato
• job_title: Cargo do contato
• tags: Lista de tags separadas por vírgula para aplicar

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 em FIND_CONTACT, os resultados são filtrados no lado do cliente
• As tags fornecidas durante a criação são aplicadas imediatamente
• Criar um contato com um e-mail 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 e-mail 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 de tags como string separada por vírgula ou array de strings (obrigatório)
• contact_id: ID do contato (forneça este ou contact_email)
• contact_email: Endereço de e-mail do contato (alternativa ao contact_id)

Armadilhas:

• Os valores de action são capitalizados: 'Add' ou 'Remove' (não em minúsculas)
• As tags podem ser uma string separada por vírgula ('tag1, tag2') ou um array (['tag1', 'tag2'])
• Deve ser fornecido contact_id ou contact_email; contact_id tem precedência
• Adicionar uma tag que não existe a cria automaticamente
• Remover uma tag inexistente é uma operação nula (não gera erro)

3. Gerenciar Inscrições em Listas

Quando usar: O usuário deseja inscrever ou cancelar a 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: String de ID numérico da lista (obrigatório)
• email: Endereço de e-mail do contato (forneça este ou contact_id)
• contact_id: String de ID numérico do contato (alternativa ao e-mail)

Armadilhas:

• Os valores de action são em minúsculas: 'subscribe' ou 'unsubscribe'
• list_id é uma string numérica (por exemplo, '2'), não o nome da lista
• Os IDs de lista podem ser recuperados através do endpoint GET /api/3/lists (não disponível como ferramenta Composio; use a interface do ActiveCampaign)

…