# 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. Ler · Leitura · Depende 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 - 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. ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "atividades_listar", "arguments": { "conta": "nome-da-sua-conta" } } } ``` **Esquema de entrada** ```json { "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** ```json { "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" ] } ```