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.
conversas_mensagensExemplo 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.
{
"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"
]
}