Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

Buscar contatos

Busca contatos por nome, telefone ou e-mail. Até 50 por chamada; o cursor proximo continua a mesma busca.

LerLeitura
Nome da ferramenta
contatos_buscar

Exemplo de pedido

Você escreve para o agente, em linguagem natural:

Ache o contato Maria Souza.

Permissão

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
termotextoSimAceita: de 2 a 80 caracteres
limitenúmero inteiroNãoPadrão 20.
Aceita: de 1 a 50
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": "contatos_buscar",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "termo": "texto"
    }
  }
}
Esquema de entrada
{
  "type": "object",
  "properties": {
    "conta": {
      "type": "string",
      "description": "A conta da Eloquus (slug). contas_listar mostra as suas."
    },
    "termo": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Padrão 20."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "O `proximo` da resposta anterior, com os mesmos filtros."
    }
  },
  "required": [
    "conta",
    "termo"
  ],
  "additionalProperties": false
}
Esquema da resposta
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "contatos": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "integer"
          },
          "nome": {
            "type": "string"
          },
          "telefone": {
            "description": "Pode ser null."
          },
          "email": {
            "description": "Pode ser null."
          },
          "empresa": {
            "description": "Pode ser null."
          },
          "campos": {
            "type": "object",
            "additionalProperties": {},
            "description": "Campos personalizados que você pode ver."
          }
        },
        "required": [
          "id",
          "nome",
          "telefone",
          "email",
          "empresa",
          "campos"
        ]
      }
    },
    "proximo": {
      "description": "Cursor da próxima página, ou null quando acabou."
    }
  },
  "required": [
    "contatos",
    "proximo"
  ]
}