Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

Listar atividades

Lista as atividades que você vê, em ordem de prazo (sem prazo por último). Filtros: responsável (eu, sem, sem_ativo, uma pessoa ou um agente), setor, status, categoria, tipo, prazo entre de e ate, vínculo, contato, conversa e negócio. Até 50 por chamada; o cursor proximo continua com os mesmos filtros.

LerLeituraDepende do plano: Atividades
Nome da ferramenta
atividades_listar

Exemplo de pedido

Você escreve para o agente, em linguagem natural:

Liste as minhas atividades atrasadas.

Permissão

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
responsaveltextoNãoeu = as minhas; sem = sem responsável; sem_ativo = sem responsável ou com quem saiu da conta (só quem vê o setor ou a equipe).
Aceita: eu, sem, sem_ativo
pessoanúmero inteiroNãoSó as da pessoa responsável com este id.
Aceita: a partir de 1
agentenúmero inteiroNãoSó as do agente com este id.
Aceita: a partir de 1
setornúmero inteiroNãoO setor (time).
Aceita: a partir de 1
statuslista de textoNãoStatus pelo id ou pelo nome.
Aceita: até 20 itens
categorialista de textoNãoAbertas: a_fazer e em_andamento.
Aceita: até 4 itens
tipolista de textoNãoTipos pelo id ou pelo nome.
Aceita: até 20 itens
detextoNãoPrazo a partir de (data e hora com fuso, como 2026-11-10T15:00:00-03:00); com ate.
Aceita: de 10 a 40 caracteres
atetextoNãoPrazo antes de (não incluído); com de.
Aceita: de 10 a 40 caracteres
vinculotextoNãosem = sem contato, conversa nem negócio.
Aceita: sem, conversa, negocio
contatonúmero inteiroNãoO contato.
Aceita: a partir de 1
conversanúmero inteiroNãoO número da conversa.
Aceita: a partir de 1
negociotextoNãoO negócio do CRM.
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 20.
Aceita: de 1 a 50
cursortextoNãoO proximo da resposta anterior, com os mesmos filtros.
Aceita: de 1 a 2048 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": "atividades_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."
    },
    "responsavel": {
      "type": "string",
      "enum": [
        "eu",
        "sem",
        "sem_ativo"
      ],
      "description": "eu = as minhas; sem = sem responsável; sem_ativo = sem responsável ou com quem saiu da conta (só quem vê o setor ou a equipe)."
    },
    "pessoa": {
      "type": "integer",
      "minimum": 1,
      "description": "Só as da pessoa responsável com este id."
    },
    "agente": {
      "type": "integer",
      "minimum": 1,
      "description": "Só as do agente com este id."
    },
    "setor": {
      "type": "integer",
      "minimum": 1,
      "description": "O setor (time)."
    },
    "status": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Status pelo id ou pelo nome."
    },
    "categoria": {
      "type": "array",
      "maxItems": 4,
      "items": {
        "type": "string",
        "enum": [
          "a_fazer",
          "em_andamento",
          "concluida",
          "cancelada"
        ]
      },
      "description": "Abertas: a_fazer e em_andamento."
    },
    "tipo": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Tipos pelo id ou pelo nome."
    },
    "de": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "Prazo a partir de (data e hora com fuso, como 2026-11-10T15:00:00-03:00); com ate."
    },
    "ate": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "Prazo antes de (não incluído); com de."
    },
    "vinculo": {
      "type": "string",
      "enum": [
        "sem",
        "conversa",
        "negocio"
      ],
      "description": "sem = sem contato, conversa nem negócio."
    },
    "contato": {
      "type": "integer",
      "minimum": 1,
      "description": "O contato."
    },
    "conversa": {
      "type": "integer",
      "minimum": 1,
      "description": "O número da conversa."
    },
    "negocio": {
      "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": "O negócio do CRM."
    },
    "limite": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Padrão 20."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "O `proximo` da resposta anterior, com os mesmos filtros."
    }
  },
  "required": [
    "conta"
  ],
  "additionalProperties": false
}
Esquema da resposta
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "atividades": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": {},
        "description": "A atividade: id, versao, titulo, tipoId, natureza, statusId, categoria, prazo (venceEm), lembrete, responsavel, setor, vínculos, checklist, resultado, origem, autor e datas. Conversa de outra caixa vem sem trecho, com conversaDeOutraCaixa: true."
      }
    },
    "proximo": {
      "description": "Cursor da próxima página, ou null quando acabou."
    }
  },
  "required": [
    "atividades",
    "proximo"
  ]
}