Automação do Close CRM via Rube MCP

Automatize operações do Close CRM através do toolkit do Close da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Close via RUBE_MANAGE_CONNECTIONS com o toolkit close
• 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 toolkit close
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação da API do Close
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 Leads

Quando usar: O usuário deseja criar novos leads ou gerenciar registros de leads existentes

Sequência de ferramentas:

1. CLOSE_CREATE_LEAD - Criar um novo lead no Close [Obrigatório]

Parâmetros principais:

• name: Nome do lead/empresa
• contacts: Array de objetos de contato associados ao lead
• custom: Valores de campos personalizados como pares chave-valor
• status_id: ID do status do lead

Armadilhas:

• Leads no Close representam empresas/organizações, não pessoas individuais
• Contatos são aninhados dentro de leads; crie o lead primeiro, depois os contatos são incluídos
• As chaves de campos personalizados usam o ID do campo personalizado (por exemplo, 'custom.cf_XXX'), não os nomes de exibição
• A detecção de leads duplicados não é automática; verifique antes de criar

2. Registrar Chamadas

Quando usar: O usuário deseja registrar uma atividade de chamada telefônica contra um lead

Sequência de ferramentas:

1. CLOSE_CREATE_CALL - Registrar uma atividade de chamada [Obrigatório]

Parâmetros principais:

• lead_id: ID do lead associado
• contact_id: ID do contato chamado
• direction: 'outbound' ou 'inbound'
• status: Status da chamada ('completed', 'no-answer', 'busy', etc.)
• duration: Duração da chamada em segundos
• note: Notas da chamada

Armadilhas:

• lead_id é obrigatório; chamadas devem ser associadas a um lead
• A duração é em segundos, não em minutos
• A direção da chamada afeta relatórios e análises
• contact_id é opcional, mas recomendado para rastreamento

3. Enviar Mensagens SMS

Quando usar: O usuário deseja enviar ou registrar mensagens SMS através do Close

Sequência de ferramentas:

1. CLOSE_CREATE_SMS - Enviar ou registrar uma mensagem SMS [Obrigatório]

Parâmetros principais:

• lead_id: ID do lead associado
• contact_id: ID do contato
• direction: 'outbound' ou 'inbound'
• text: Conteúdo da mensagem SMS
• status: Status da mensagem

Armadilhas:

• A funcionalidade de SMS requer a integração de telefone/SMS do Close configurada
• lead_id é obrigatório para todas as atividades de SMS
• SMS de saída pode exigir um número de envio verificado
• Limites de comprimento de mensagem podem se aplicar dependendo da operadora

4. Gerenciar Tarefas

Quando usar: O usuário deseja criar ou gerenciar tarefas de acompanhamento

Sequência de ferramentas:

1. CLOSE_CREATE_TASK - Criar uma nova tarefa [Obrigatório]

Parâmetros principais:

• lead_id: ID do lead associado
• text: Descrição da tarefa
• date: Data de vencimento da tarefa
• assigned_to: ID do usuário do assignee
• is_complete: Se a tarefa está concluída

Armadilhas:

• Tarefas são associadas a leads, não a contatos
• O formato da data deve seguir o ISO 8601
• assigned_to requer o ID do usuário do Close, não e-mail ou nome
• Tarefas sem data aparecem na seção 'sem data de vencimento'

5. Gerenciar Notas

Quando usar: O usuário deseja adicionar ou recuperar notas sobre leads

Sequência de ferramentas:

1. CLOSE_GET_NOTE - Recuperar uma nota específica [Obrigatório]

Parâmetros principais:

• note_id: ID da nota a ser recuperada

Armadilhas:

• Notas são associadas a leads
• IDs de notas são necessários para recuperação; pesquise leads primeiro para encontrar referências de notas
• Notas suportam texto simples e formatação básica

6. Excluir Atividades

Quando usar: O usuário deseja remover registros de chamadas ou outras atividades

Sequência de ferramentas:

1. CLOSE_DELETE_CALL - Excluir uma atividade de chamada [Obrigatório]

Parâmetros principais:

• call_id: ID da chamada a ser excluída

Armadilhas:

• A exclusão é permanente e não pode ser desfeita
• Apenas o criador da chamada ou um administrador pode excluir chamadas
• Excluir uma chamada a remove de todos os relatórios e linhas do tempo

Padrões Comuns

Relação Lead e Contato

Close data model:
- Lead = Company/Organization
  - Contact = Person (nested within Lead)
  - Activity = Call, SMS, Email, Note (linked to Lead)
  - Task = Follow-up item (linked to Lead)
  - Opportunity = Deal (linked to Lead)

Resolução de ID

…