Automação do HubSpot CRM via Rube MCP

Automatize fluxos de trabalho do HubSpot CRM, incluindo gerenciamento de contatos/empresas, acompanhamento de pipeline de negócios, busca de tickets e criação de propriedades personalizadas através do kit de ferramentas HubSpot da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o HubSpot via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas hubspot
• 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. Nenhuma chave de API é necessária — 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 hubspot
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do HubSpot
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Contatos

Quando usar: O usuário deseja criar novos contatos ou atualizar os existentes no HubSpot CRM

Sequência de ferramentas:

1. HUBSPOT_GET_ACCOUNT_INFO - Verificar conexão e permissões (Pré-requisito)
2. HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA - Pesquisar contatos existentes para evitar duplicatas (Pré-requisito)
3. HUBSPOT_READ_A_CRM_PROPERTY_BY_NAME - Verificar metadados de propriedades para valores restritos (Opcional)
4. HUBSPOT_CREATE_CONTACT - Criar um único contato (Obrigatório)
5. HUBSPOT_CREATE_CONTACTS - Criar contatos em lote de até 100 (Alternativa)

Parâmetros principais:

• HUBSPOT_CREATE_CONTACT: Objeto properties com email, firstname, lastname, phone, company
• HUBSPOT_CREATE_CONTACTS: Matriz inputs de objetos {properties}, máximo de 100 por lote
• HUBSPOT_SEARCH_CONTACTS_BY_CRITERIA: Matriz filterGroups com {filters: [{propertyName, operator, value}]}, matriz properties de campos a serem retornados

Armadilhas:

• Máximo de 100 registros por lote; divida importações maiores
• 400 'Property values were not valid' se usar nomes de propriedade ou valores de enum incorretos
• Sempre pesquise antes de criar para evitar duplicatas
• Erros de autenticação de GET_ACCOUNT_INFO significam que todas as chamadas subsequentes falharão

2. Gerenciar Empresas

Quando usar: O usuário deseja criar, pesquisar ou atualizar registros de empresas

Sequência de ferramentas:

1. HUBSPOT_SEARCH_COMPANIES - Pesquisar empresas existentes (Pré-requisito)
2. HUBSPOT_CREATE_COMPANIES - Criar empresas em lote, máximo de 100 (Obrigatório)
3. HUBSPOT_UPDATE_COMPANIES - Atualizar empresas existentes em lote (Alternativa)
4. HUBSPOT_GET_COMPANY - Obter detalhes de uma única empresa (Opcional)
5. HUBSPOT_BATCH_READ_COMPANIES_BY_PROPERTIES - Ler empresas em massa por valores de propriedade (Opcional)

Parâmetros principais:

• HUBSPOT_CREATE_COMPANIES: Matriz inputs de objetos {properties}, máximo de 100
• HUBSPOT_SEARCH_COMPANIES: filterGroups, properties, sorts, limit, after (cursor de paginação)

Armadilhas:

• Máximo de 100 por lote; divida conjuntos maiores
• Armazene os IDs retornados imediatamente para operações downstream
• Os valores das propriedades devem corresponder exatamente aos nomes internos, não aos rótulos de exibição

3. Gerenciar Negócios e Pipeline

Quando usar: O usuário deseja pesquisar negócios, visualizar estágios do pipeline ou acompanhar o progresso dos negócios

Sequência de ferramentas:

1. HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE - Mapear IDs/nomes de pipeline e estágio (Pré-requisito)
2. HUBSPOT_SEARCH_DEALS - Pesquisar negócios com filtros (Obrigatório)
3. HUBSPOT_RETRIEVE_PIPELINE_STAGES - Obter detalhes de estágio para um pipeline (Opcional)
4. HUBSPOT_RETRIEVE_OWNERS - Obter detalhes do proprietário/representante (Opcional)
5. HUBSPOT_GET_DEAL - Obter detalhes de um único negócio (Opcional)
6. HUBSPOT_LIST_DEALS - Listar todos os negócios sem filtros (Fallback)

Parâmetros principais:

• HUBSPOT_SEARCH_DEALS: filterGroups com filtros em pipeline, dealstage, createdate, closedate, hubspot_owner_id; properties, sorts, limit, after
• HUBSPOT_RETRIEVE_ALL_PIPELINES_FOR_SPECIFIED_OBJECT_TYPE: objectType definido como 'deals'

Armadilhas:

• Resultados aninhados sob response.data.results; propriedades são frequentemente strings (quantias, datas)
• IDs de estágio podem ser strings legíveis ou IDs numéricos opacos; use o campo label para exibição
• Filtros devem usar nomes de propriedade internos (pipeline, dealstage, createdate), não nomes de exibição
• Paginar via paging.next.after até que esteja ausente

4. Pesquisar e Filtrar Tickets

Quando usar: O usuário deseja encontrar tickets de suporte por status, data ou critério

Sequência de ferramentas:

1. HUBSPOT_SEARCH_TICKETS - Pesquisar com filterGroups (Obrigatório)

…