Automação de CRM Capsule (ComposioHQ/Capsule-CRM-Automation-ule…

Automação do Capsule CRM

Gerencie seu Capsule CRM – crie e atualize contatos, execute consultas poderosas com filtros em partes/oportunidades/casos, acompanhe tarefas e projetos, navegue por entradas de atividade e organize relacionamentos da equipe – tudo por meio de comandos em linguagem natural.

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

---

Configuração

1. Adicione o servidor MCP do Composio à 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. Executar Consultas com Filtros Estruturados

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 principais:

• 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 comparação
  • orderBy – Array de objetos de ordenação com field e direction ("ascending"/"descending")
• embed – Dados adicionais a incluir na resposta
• page / perPage – Paginação (máx. 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. Listar e Gerenciar 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 principais:

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

---

3. Criar 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: João Silva, VP de Vendas na Acme Corp, [email protected]"

Parâmetros principais:

• 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 – Vincular a uma org por {id} ou {name} (cria se não encontrar)
• tags – Array de tags por {name} ou {id}
• fields – Valores de campos personalizados com {definition, value}
• websites – Array de objetos {address, service, type}
• owner – Atribuir usuário proprietário {id}

---

4. Atualizar 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 [email protected] e remova a tag 'prospecto'"

Parâmetros principais:

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

---

5. Acompanhar 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 principais:

• status – Filtrar por status: "open", "completed", "pending" (array)
• embed – Dados adicionais: "party", "opportunity", "kase", "owner", "nextTask"
• page / perPage – Paginação (máx. 100 por página, padrão 50)

---

6. Navegar por Projetos e Entradas de Atividade

Liste projetos (casos) e entradas de atividade recentes, incluindo notas, e-mails e tarefas concluídas.

Ferramentas: CAPSULE_CRM_LIST_PROJECTS, CAPSULE_CRM_LIST_ENTRIES_BY_DATE

Exemplo de prompt:

"Mostre todos os projetos abertos no Capsule CRM" / "Mostre entradas de atividade recentes com detalhes da parte"

Parâmetros principais para projetos:

• status – Filtrar por "OPEN" ou "CLOSED"
• search – Termo de busca para nomes/descrições de projetos
• since – Data ISO8601 para modificações após esta data
• embed – "tags,fields,party,opportunity,missingImportantFields"

Parâmetros principais para entradas:

• embed – "party", "kase", "opportunity", "creator", "activityType"
• page / perPage – Paginação (máx. 100 por página)

---

Armadilhas Conhecidas

• Campos de endereço são de nível superior: Ao filtrar, use state, city, country, zip diretamente – NÃO address.state ou sintaxe aninhada.
• Códigos de país são ISO alpha-2: Filtre por "US", "GB", "CA" – não "Estados Unidos" ou "Reino Unido".
• Campos personalizados usam sintaxe especial: Referencie campos personalizados como custom:{fieldId} nas condições de filtro. Para campos personalizados de organização, use org.custom:{fieldId}.
• Projetos são chamados de "kases" na API: Apesar de serem "projetos" na interface, o tipo de entidade da API é kases. Use kases em consultas de filtro.
• Operações de exclusão exigem IDs de itens: Ao atualizar uma parte para remover subitens (e-mails, telefones, tags), você deve incluir o id do item juntamente com _delete: true. Liste a parte primeiro para obter os IDs dos subitens.
• Paginação padrão é 50: Todos os endpoints de lista usam 50 itens por página como padrão, com máximo de 100. Sempre implemente paginação para recuperação completa de dados.
• Valores de embed variam por entidade: Nem todas as opções de embed funcionam para todas as entidades. Consulte a documentação para valores de embed suportados por endpoint.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Executar consulta com filtro	CAPSULE_CRM_RUN_FILTER_QUERY	entity, filter
Listar contatos	CAPSULE_CRM_LIST_PARTIES	Nenhum (filtros opcionais)
Criar contato	CAPSULE_CRM_CREATE_PARTY	type
Atualizar contato	CAPSULE_CRM_UPDATE_PARTY	partyId, party
Excluir contato	CAPSULE_CRM_DELETE_PARTY	party_id
Listar tarefas	CAPSULE_CRM_LIST_TASKS	Nenhum (filtros opcionais)
Listar projetos	CAPSULE_CRM_LIST_PROJECTS	Nenhum (filtros opcionais)
Listar entradas de atividade	CAPSULE_CRM_LIST_ENTRIES_BY_DATE	Nenhum (filtros opcionais)
Listar funcionários da org	CAPSULE_CRM_LIST_ORG_EMPLOYEES	ID da organização
Listar oportunidades excluídas	CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES	since

---

Desenvolvido por Composio