# Ler mensagens As mensagens de uma conversa, as mais recentes, em ordem de leitura (mais antigas primeiro). Até 500 por chamada; o cursor `proximo` traz as anteriores. Notas internas vêm com nota: true. Ler · Leitura Nome da ferramenta: ``` conversas_mensagens ``` ## Exemplo de pedido Você escreve para o agente, em linguagem natural: > Leia a conversa 1234 e me diga o que o cliente pediu. ## 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: Conversas. ## Parâmetros | Nome | Tipo | Obrigatório | Descrição | | --- | --- | --- | --- | | `conta` | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. | | `conversa` | número inteiro | Sim | Número da conversa. Aceita: a partir de 1 | | `limite` | número inteiro | Não | Padrão 200. Aceita: de 1 a 500 | | `cursor` | texto | Não | O `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 - 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": "conversas_mensagens", "arguments": { "conta": "nome-da-sua-conta", "conversa": 123 } } } ``` **Esquema de entrada** ```json { "type": "object", "properties": { "conta": { "type": "string", "description": "A conta da Eloquus (slug). contas_listar mostra as suas." }, "conversa": { "type": "integer", "minimum": 1, "description": "Número da conversa." }, "limite": { "type": "integer", "minimum": 1, "maximum": 500, "description": "Padrão 200." }, "cursor": { "type": "string", "minLength": 1, "maxLength": 200, "description": "O `proximo` da resposta anterior, com os mesmos filtros." } }, "required": [ "conta", "conversa" ], "additionalProperties": false } ``` **Esquema da resposta** ```json { "type": "object", "additionalProperties": false, "properties": { "mensagens": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "id": { "type": "integer" }, "texto": { "type": "string" }, "autor": { "type": "string", "enum": [ "cliente", "pessoa", "agente", "sistema" ] }, "nota": { "type": "boolean", "description": "Nota interna: a equipe vê, o cliente não." }, "em": { "type": "string" } }, "required": [ "id", "texto", "autor", "nota", "em" ] } }, "proximo": { "description": "Cursor da próxima página, ou null quando acabou." } }, "required": [ "mensagens", "proximo" ] } ```