Automação do Zoho CRM via Rube MCP

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

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o Zoho CRM via RUBE_MANAGE_CONNECTIONS com o toolkit zoho
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu 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 zoho
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Zoho
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Pesquisar e Recuperar Registros

Quando usar: O usuário deseja encontrar registros específicos do CRM por critérios

Sequência de ferramentas:

1. ZOHO_LIST_MODULES - Listar módulos de CRM disponíveis [Pré-requisito]
2. ZOHO_GET_MODULE_FIELDS - Obter definições de campos para um módulo [Opcional]
3. ZOHO_SEARCH_ZOHO_RECORDS - Pesquisar registros por critérios [Obrigatório]
4. ZOHO_GET_ZOHO_RECORDS - Obter registros de um módulo [Alternativa]

Parâmetros principais:

• module: Nome do módulo (por exemplo, 'Leads', 'Contacts', 'Deals', 'Accounts')
• criteria: String de critérios de pesquisa (por exemplo, 'Email:equals:john@example.com')
• fields: Lista de campos a serem retornados, separados por vírgula
• per_page: Número de registros por página
• page: Número da página para paginação

Armadilhas:

• Os nomes dos módulos diferenciam maiúsculas de minúsculas (por exemplo, 'Leads' e não 'leads')
• Os critérios de pesquisa usam sintaxe específica: 'Campo:operador:valor'
• Operadores suportados: equals, starts_with, contains, not_equal, greater_than, less_than
• Critérios complexos usam parênteses e AND/OR: '(Email:equals:john@example.com)AND(Last_Name:equals:Doe)'
• GET_ZOHO_RECORDS retorna todos os registros com filtragem opcional; SEARCH é para buscas direcionadas

2. Criar Registros

Quando usar: O usuário deseja adicionar novos leads, contatos, negócios ou outros registros do CRM

Sequência de ferramentas:

1. ZOHO_GET_MODULE_FIELDS - Obter campos obrigatórios para o módulo [Pré-requisito]
2. ZOHO_CREATE_ZOHO_RECORD - Criar um novo registro [Obrigatório]

Parâmetros principais:

• module: Nome do módulo de destino (por exemplo, 'Leads', 'Contacts')
• data: Objeto de dados do registro com pares de campo-valor
• Campos obrigatórios variam por módulo (por exemplo, Last_Name para Contacts)

Armadilhas:

• Cada módulo tem campos obrigatórios; use GET_MODULE_FIELDS para identificá-los
• Os nomes dos campos usam underscores (por exemplo, 'Last_Name', 'Email', 'Phone')
• Campos de lookup exigem o ID do registro relacionado, não o nome
• Campos de data devem usar o formato 'yyyy-MM-dd'
• A criação de duplicatas é permitida, a menos que regras de verificação de duplicatas sejam configuradas

3. Atualizar Registros

Quando usar: O usuário deseja modificar registros existentes do CRM

Sequência de ferramentas:

1. ZOHO_SEARCH_ZOHO_RECORDS - Encontrar o registro a ser atualizado [Pré-requisito]
2. ZOHO_UPDATE_ZOHO_RECORD - Atualizar o registro [Obrigatório]

Parâmetros principais:

• module: Nome do módulo
• record_id: ID do registro a ser atualizado
• data: Objeto com os campos a serem atualizados (apenas os campos alterados são necessários)

Armadilhas:

• record_id deve ser o ID do registro Zoho (string numérica)
• Forneça apenas os campos que precisam ser alterados; outros campos são preservados
• Campos somente leitura e de sistema não podem ser atualizados
• Atualizações de campos de lookup exigem o ID do registro relacionado

4. Converter Leads

Quando usar: O usuário deseja converter um lead em um contato, conta e/ou negócio

Sequência de ferramentas:

1. ZOHO_SEARCH_ZOHO_RECORDS - Encontrar o lead a ser convertido [Pré-requisito]
2. ZOHO_CONVERT_ZOHO_LEAD - Converter o lead [Obrigatório]

Parâmetros principais:

• lead_id: ID do lead a ser convertido
• deal: Detalhes do negócio se estiver criando um negócio durante a conversão
• account: Detalhes da conta para a conversão
• contact: Detalhes do contato para a conversão

Armadilhas:

• A conversão de leads é irreversível; o registro do lead é removido do módulo Leads
• A conversão pode criar até três registros: Contato, Conta e Negócio
• Pode ocorrer correspondência de conta existente com base no nome da empresa
• Mapeamentos de campos personalizados entre os módulos Lead e Contato/Conta/Negócio afetam o resultado

5. Gerenciar Tags e Registros Relacionados

Quando usar: O usuário deseja marcar registros ou gerenciar relacionamentos entre registros

Sequência de ferramentas:

1. ZOHO_CREATE_ZOHO_TAG - Criar uma nova tag [Opcional]
2. ZOHO_UPDATE_RELATED_RECORDS - Atualizar registros relacionados/vinculados [Opcional]

Parâmetros principais:

• module: Módulo para a tag

…