Automação do Pipedrive via Rube MCP

Automatize fluxos de trabalho do Pipedrive CRM, incluindo gerenciamento de negócios, operações de contato e organização, agendamento de atividades, notas e consultas de pipeline/estágio através do kit de ferramentas Pipedrive da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Pipedrive via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas pipedrive
• 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 pipedrive
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Pipedrive
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 Negócios

Quando usar: O usuário deseja criar um novo negócio, atualizar um negócio existente ou revisar detalhes do negócio no pipeline de vendas.

Sequência de ferramentas:

1. PIPEDRIVE_SEARCH_ORGANIZATIONS - Encontrar organização existente para vincular ao negócio [Opcional]
2. PIPEDRIVE_ADD_AN_ORGANIZATION - Criar organização se nenhuma for encontrada [Opcional]
3. PIPEDRIVE_SEARCH_PERSONS - Encontrar contato existente para vincular [Opcional]
4. PIPEDRIVE_ADD_A_PERSON - Criar contato se nenhum for encontrado [Opcional]
5. PIPEDRIVE_GET_ALL_PIPELINES - Resolver ID do pipeline [Pré-requisito]
6. PIPEDRIVE_GET_ALL_STAGES - Resolver ID do estágio dentro do pipeline [Pré-requisito]
7. PIPEDRIVE_ADD_A_DEAL - Criar o negócio com título, valor, org_id, person_id, stage_id [Obrigatório]
8. PIPEDRIVE_UPDATE_A_DEAL - Modificar propriedades do negócio após a criação [Opcional]
9. PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL - Anexar itens de linha/produtos [Opcional]

Parâmetros chave:

• title: Título do negócio (obrigatório para criação)
• value: Valor monetário do negócio
• currency: Código de moeda ISO de 3 letras (ex: "USD")
• pipeline_id / stage_id: IDs numéricos para posicionamento no pipeline
• org_id / person_id: Vincular à organização e contato
• status: "open", "won", ou "lost"
• expected_close_date: Formato AAAA-MM-DD

Armadilhas:

• title é o único campo obrigatório para PIPEDRIVE_ADD_A_DEAL; todos os outros são opcionais
• Campos personalizados aparecem como longas chaves hash nas respostas; use o endpoint dealFields para mapeá-los
• PIPEDRIVE_UPDATE_A_DEAL requer o id numérico do negócio
• Definir status como "lost" requer também fornecer lost_reason

2. Gerenciar Contatos (Pessoas e Organizações)

Quando usar: O usuário deseja criar, atualizar, pesquisar ou listar contatos e empresas no Pipedrive.

Sequência de ferramentas:

1. PIPEDRIVE_SEARCH_PERSONS - Pesquisar pessoa existente por nome, e-mail ou telefone [Pré-requisito]
2. PIPEDRIVE_ADD_A_PERSON - Criar novo contato se não encontrado [Obrigatório]
3. PIPEDRIVE_UPDATE_A_PERSON - Modificar detalhes de contato existente [Opcional]
4. PIPEDRIVE_GET_DETAILS_OF_A_PERSON - Recuperar registro completo do contato [Opcional]
5. PIPEDRIVE_SEARCH_ORGANIZATIONS - Pesquisar organização existente [Pré-requisito]
6. PIPEDRIVE_ADD_AN_ORGANIZATION - Criar nova organização se não encontrada [Obrigatório]
7. PIPEDRIVE_UPDATE_AN_ORGANIZATION - Modificar propriedades da organização [Opcional]
8. PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION - Recuperar registro completo da organização [Opcional]

Parâmetros chave:

• name: Obrigatório para criação de pessoa e organização
• email: Array de objetos com campos value, label, primary para pessoas
• phone: Array de objetos com campos value, label, primary para pessoas
• org_id: Vincular uma pessoa a uma organização
• visible_to: 1 = apenas proprietário, 3 = empresa inteira
• term: Termo de busca para SEARCH_PERSONS / SEARCH_ORGANIZATIONS (mínimo de 2 caracteres)

Armadilhas:

• PIPEDRIVE_ADD_AN_ORGANIZATION pode se fundir automaticamente com uma organização existente; verifique response.additional_data.didMerge
• Campos de e-mail e telefone são arrays de objetos, não strings simples: [{"value": "test@example.com", "label": "work", "primary": true}]
• Caracteres curinga de PIPEDRIVE_SEARCH_PERSONS como * ou @ NÃO são suportados; use PIPEDRIVE_GET_ALL_PERSONS para listar todos
• A exclusão via PIPEDRIVE_DELETE_A_PERSON ou PIPEDRIVE_DELETE_AN_ORGANIZATION é uma exclusão suave com retenção de 30 dias, depois permanente

3. Agendar e Rastrear Atividades

Quando usar: O usuário deseja criar chamadas, reuniões, tarefas ou outras atividades vinculadas a negócios, contatos ou organizações.

Sequência de ferramentas:

…