# Listar negócios Lista os negócios de um funil do CRM (o padrão, sem `funil`): os abertos e os fechados nos últimos 90 dias, com etapa, valor em centavos e contato, em ordem de criação. Filtra por etapa. Até 200 por chamada; o cursor `proximo` continua com os mesmos filtros. Ler · Leitura · Depende do plano: CRM Nome da ferramenta: ``` crm_negocios_listar ``` ## Exemplo de pedido Você escreve para o agente, em linguagem natural: > Quais negócios estão em Proposta há mais tempo? ## Permissão - Só lê, não muda nada na Eloquus. - Pede o escopo Ler (`eloquus:ler`), que vem sempre marcado na conexão. - Área da Eloquus: Negócios. - Depende do plano: a conta precisa ter CRM. ## Parâmetros | Nome | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | | `conta` | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. | | `funil` | texto | Não | Id do funil; sem ele, o funil padrão. Aceita: formato ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ | | `etapa` | texto | Não | Id da etapa. Aceita: formato ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ | | `limite` | número inteiro | Não | Padrão 50. Aceita: de 1 a 200 | | `cursor` | texto | Não | O `proximo` da resposta anterior, com os mesmos filtros. Aceita: de 1 a 200 caracteres | ## Paginação A resposta traz `proximo` quando há mais itens. Para continuar, chame de novo com os mesmos filtros e `cursor` igual ao `proximo` recebido, até ele vir vazio. ## Limites - 120 chamadas por minuto por conexão e 600 por minuto por conta, somando todos os agentes conectados. ## Detalhes técnicos **Pedido JSON-RPC (tools/call)** Com só os campos obrigatórios e valores de exemplo. ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "crm_negocios_listar", "arguments": { "conta": "nome-da-sua-conta" } } } ``` **Esquema de entrada** ```json { "type": "object", "properties": { "conta": { "type": "string", "description": "A conta da Eloquus (slug). contas_listar mostra as suas." }, "funil": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "Id do funil; sem ele, o funil padrão." }, "etapa": { "type": "string", "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$", "description": "Id da etapa." }, "limite": { "type": "integer", "minimum": 1, "maximum": 200, "description": "Padrão 50." }, "cursor": { "type": "string", "minLength": 1, "maxLength": 200, "description": "O `proximo` da resposta anterior, com os mesmos filtros." } }, "required": [ "conta" ], "additionalProperties": false } ``` **Esquema da resposta** ```json { "type": "object", "additionalProperties": false, "properties": { "funil": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "nome": { "type": "string" } }, "required": [ "id", "nome" ] }, "funis": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "nome": { "type": "string" } }, "required": [ "id", "nome" ] } }, "etapas": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "nome": { "type": "string" }, "posicao": { "type": "integer" } }, "required": [ "id", "nome", "posicao" ] } }, "negocios": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "string" }, "titulo": { "type": "string" }, "funil": { "type": "string", "description": "Nome do funil." }, "etapa": { "description": "Nome da etapa. Pode ser null." }, "situacao": { "type": "string", "description": "aberto, ganho ou perdido." }, "valorCentavos": { "description": "Valor em centavos de real. Pode ser null." }, "motivoPerda": { "description": "Pode ser null." }, "fechadoEm": { "description": "Pode ser null." }, "responsavel": { "description": "Id da pessoa responsável na Eloquus. Pode ser null." }, "contato": { "type": "object", "additionalProperties": false, "properties": { "id": { "description": "Pode ser null." }, "nome": { "description": "Pode ser null." } }, "required": [ "id", "nome" ] }, "conversa": { "description": "Número da conversa. Pode ser null." }, "empresa": { "description": "Pode ser null." }, "previsao": { "description": "AAAA-MM-DD. Pode ser null." }, "origem": { "type": "string" }, "criadoEm": { "type": "string" }, "atualizadoEm": { "type": "string" }, "campos": { "type": "object", "additionalProperties": {}, "description": "Campos personalizados, pelo nome." } }, "required": [ "id", "titulo", "funil", "etapa", "situacao", "valorCentavos", "motivoPerda", "fechadoEm", "responsavel", "contato", "conversa", "empresa", "previsao", "origem", "criadoEm", "atualizadoEm", "campos" ] } }, "truncado": { "type": "boolean", "description": "O funil passou do teto do quadro; a lista não tem tudo." }, "proximo": { "description": "Cursor da próxima página, ou null quando acabou." } }, "required": [ "funil", "funis", "etapas", "negocios", "truncado", "proximo" ] } ```