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.
crm_negocios_listarExemplo 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.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "crm_negocios_listar",
"arguments": {
"conta": "nome-da-sua-conta"
}
}
}Esquema de entrada
{
"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
{
"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"
]
}