Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

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.

LerLeitura
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

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
conversanúmero inteiroSimNúmero da conversa.
Aceita: a partir de 1
limitenúmero inteiroNãoPadrão 200.
Aceita: de 1 a 500
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": "conversas_mensagens",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "conversa": 123
    }
  }
}
Esquema de entrada
{
  "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
{
  "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"
  ]
}