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.
atividades_listarExemplo de pedido
Você escreve para o agente, em linguagem natural:
Liste as minhas atividades atrasadas.
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: Atividades.
- Depende do plano: a conta precisa ter Atividades.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
conta | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. |
responsavel | texto | Não | 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). Aceita: eu, sem, sem_ativo |
pessoa | número inteiro | Não | Só as da pessoa responsável com este id. Aceita: a partir de 1 |
agente | número inteiro | Não | Só as do agente com este id. Aceita: a partir de 1 |
setor | número inteiro | Não | O setor (time). Aceita: a partir de 1 |
status | lista de texto | Não | Status pelo id ou pelo nome. Aceita: até 20 itens |
categoria | lista de texto | Não | Abertas: a_fazer e em_andamento. Aceita: até 4 itens |
tipo | lista de texto | Não | Tipos pelo id ou pelo nome. Aceita: até 20 itens |
de | texto | Não | Prazo a partir de (data e hora com fuso, como 2026-11-10T15:00:00-03:00); com ate. Aceita: de 10 a 40 caracteres |
ate | texto | Não | Prazo antes de (não incluído); com de. Aceita: de 10 a 40 caracteres |
vinculo | texto | Não | sem = sem contato, conversa nem negócio. Aceita: sem, conversa, negocio |
contato | número inteiro | Não | O contato. Aceita: a partir de 1 |
conversa | número inteiro | Não | O número da conversa. Aceita: a partir de 1 |
negocio | texto | Não | O 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}$ |
limite | número inteiro | Não | Padrão 20. Aceita: de 1 a 50 |
cursor | texto | Não | O 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
- 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": "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"
]
}