Automação do Capsule CRM

Gerencie seu Capsule CRM -- crie e atualize contatos, execute consultas de filtro poderosas em partes/oportunidades/casos, acompanhe tarefas e projetos, navegue por entradas de atividade e organize relacionamentos de equipe -- tudo através de comandos em linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/capsule_crm

Configuração

1. Adicione o servidor Composio MCP à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta do Capsule CRM quando solicitado (autenticação OAuth).
3. Comece a emitir comandos em linguagem natural para gerenciar seu CRM.

Fluxos de Trabalho Principais

1. Execute Consultas de Filtro Estruturadas

Consulte partes, oportunidades ou casos (projetos) com múltiplas condições de filtro, operadores e ordenação.

Ferramenta: CAPSULE_CRM_RUN_FILTER_QUERY

Exemplo de prompt:

"Encontre todos os contatos do Capsule CRM na Califórnia marcados como 'VIP' ordenados por nome"

Parâmetros chave:

• entity (obrigatório) -- Um de: parties, opportunities, kases
• filter (obrigatório) -- Objeto de filtro com:
  • conditions -- Array de condições, cada uma com:
    • field -- Nome do campo (ex: "name", "email", "state", "country", "tag", "owner", "jobTitle", "addedOn")
    • operator -- Um de: "is", "is not", "starts with", "ends with", "contains", "is greater than", "is less than", "is after", "is before", "is older than", "is within last", "is within next"
    • value -- Valor para comparar
  • orderBy -- Array de objetos de ordenação com field e direction ("ascending"/"descending")
• embed -- Dados adicionais para incluir na resposta
• page / perPage -- Paginação (máximo de 100 por página)

Observações importantes sobre campos:

• Campos de endereço (city, state, country, zip) são de nível superior, NÃO aninhados sob "address"
• O país deve ser um código ISO 3166-1 alpha-2 (ex: "US", "GB", "CA")
• Campos personalizados usam o formato custom:{fieldId}
• Campos de organização usam o prefixo org. (ex: org.name, org.tag)

2. Liste e Gerencie Contatos (Partes)

Recupere todos os contatos com filtragem opcional por data de modificação e dados relacionados incorporados.

Ferramenta: CAPSULE_CRM_LIST_PARTIES

Exemplo de prompt:

"Liste todos os contatos do Capsule CRM modificados desde janeiro de 2025 com suas tags e organizações"

Parâmetros chave:

• since -- Data ISO8601 para filtrar contatos alterados após esta data
• embed -- Dados adicionais: "tags", "fields", "organisation", "missingImportantFields"
• page / perPage -- Paginação (máximo de 100 por página, padrão 50)

3. Crie Novos Contatos

Adicione pessoas ou organizações ao seu Capsule CRM com detalhes completos, incluindo e-mails, telefones, endereços, tags e campos personalizados.

Ferramenta: CAPSULE_CRM_CREATE_PARTY

Exemplo de prompt:

"Crie uma nova pessoa no Capsule CRM: John Smith, VP de Vendas na Acme Corp, john@acme.com"

Parâmetros chave:

• type (obrigatório) -- "person" ou "organisation"
• Para pessoas: firstName, lastName, jobTitle, title
• Para organizações: name
• emailAddresses -- Array de objetos {address, type}
• phoneNumbers -- Array de objetos {number, type}
• addresses -- Array de objetos de endereço com street, city, state, country, zip, type (Home/Postal/Office/Billing/Shipping)
• organisation -- Link para organização por {id} ou {name} (cria se não encontrado)
• tags -- Array de tags por {name} ou {id}
• fields -- Valores de campos personalizados com {definition, value}
• websites -- Array de objetos {address, service, type}
• owner -- Atribua o usuário proprietário {id}

4. Atualize Contatos Existentes

Modifique qualquer aspecto de um registro de parte, incluindo adicionar/remover e-mails, telefones, tags e campos personalizados.

Ferramenta: CAPSULE_CRM_UPDATE_PARTY

Exemplo de prompt:

"Atualize a parte 11587 do Capsule CRM: adicione um e-mail de trabalho john.new@acme.com e remova a tag 'prospect'"

Parâmetros chave:

• partyId (obrigatório) -- ID inteiro da parte a ser atualizada
• party (obrigatório) -- Objeto com os campos a serem atualizados. Suporta:
  • Todos os campos de criação (nome, e-mails, telefones, endereços, etc.)
  • _delete: true em sub-itens para removê-los (requer o id do item)
  • Tags: adicionar por {name} ou remover com {id, _delete: true}

5. Acompanhe Tarefas

Liste tarefas com filtragem por status e dados relacionados incorporados.

Ferramenta: CAPSULE_CRM_LIST_TASKS

Exemplo de prompt:

"Mostre todas as tarefas abertas no Capsule CRM com suas partes e proprietários vinculados"

Parâmetros chave:

• status -- Filtrar por status: "open", "completed", "pending" (array)

…