Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

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.

LerLeituraDepende 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

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
funiltextoNãoId 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}$
etapatextoNãoId 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}$
limitenúmero inteiroNãoPadrão 50.
Aceita: de 1 a 200
cursortextoNãoO 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

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"
  ]
}