Métricas de atendimento
Conversas abertas e resolvidas, tempo médio da primeira resposta e da resolução (em segundos), por dia e por caixa, no período (America/Sao_Paulo). Sem caixa, soma as caixas que você vê; média não soma, então com várias caixas as médias do total vêm null e as de cada caixa estão em porCaixa. null = o dado não veio.
LerLeituraDepende do plano: PainelSó administradores por padrãoconversas_metricasExemplo de pedido
Você escreve para o agente, em linguagem natural:
Como foi o atendimento de ontem: conversas abertas, resolvidas e o tempo até a primeira resposta?
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: Painel. Por padrão, só administradores veem esta área; o administrador pode liberar para outras pessoas.
- Depende do plano: a conta precisa ter Painel.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
conta | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. |
caixa | número inteiro | Não | Id da caixa de entrada (caixas_listar). Aceita: a partir de 1 |
desde | texto | Sim | Começo do período: AAAA-MM-DD (dia inteiro em America/Sao_Paulo) ou data e hora ISO com fuso. Aceita: de 10 a 40 caracteres |
ate | texto | Sim | Fim do período (incluído): AAAA-MM-DD (dia inteiro em America/Sao_Paulo) ou data e hora ISO com fuso. Aceita: de 10 a 40 caracteres |
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_metricas",
"arguments": {
"conta": "nome-da-sua-conta",
"desde": "2026-11-01",
"ate": "2026-11-01"
}
}
}Esquema de entrada
{
"type": "object",
"properties": {
"conta": {
"type": "string",
"description": "A conta da Eloquus (slug). contas_listar mostra as suas."
},
"caixa": {
"type": "integer",
"minimum": 1,
"description": "Id da caixa de entrada (caixas_listar)."
},
"desde": {
"type": "string",
"minLength": 10,
"maxLength": 40,
"description": "Começo do período: AAAA-MM-DD (dia inteiro em America/Sao_Paulo) ou data e hora ISO com fuso."
},
"ate": {
"type": "string",
"minLength": 10,
"maxLength": 40,
"description": "Fim do período (incluído): AAAA-MM-DD (dia inteiro em America/Sao_Paulo) ou data e hora ISO com fuso."
}
},
"required": [
"conta",
"desde",
"ate"
],
"additionalProperties": false
}Esquema da resposta
{
"type": "object",
"additionalProperties": false,
"properties": {
"desde": {
"type": "string"
},
"ate": {
"type": "string"
},
"fuso": {
"type": "string"
},
"total": {
"type": "object",
"additionalProperties": false,
"properties": {
"abertas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"resolvidas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"primeiraRespostaMediaS": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"resolucaoMediaS": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
}
},
"required": [
"abertas",
"resolvidas",
"primeiraRespostaMediaS",
"resolucaoMediaS"
]
},
"porDia": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"dia": {
"type": "string"
},
"abertas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"resolvidas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
}
},
"required": [
"dia",
"abertas",
"resolvidas"
]
}
},
"porCaixa": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"caixa": {
"type": "integer"
},
"abertas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"resolvidas": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"primeiraRespostaMediaS": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
},
"resolucaoMediaS": {
"description": "Número, ou null quando o dado não veio. Pode ser null."
}
},
"required": [
"caixa",
"abertas",
"resolvidas",
"primeiraRespostaMediaS",
"resolucaoMediaS"
]
}
}
},
"required": [
"desde",
"ate",
"fuso",
"total",
"porDia",
"porCaixa"
]
}