Ler o log operacional de voz
O que o serviço de voz registrou sobre SIP, ligações, salas e despachos, de todos os clientes — por isso só a plataforma lê. Não traz transcrição. Não é uma página: o serviço guarda as últimas entradas (capacity) e devolve as mais recentes que casam com o filtro; para acompanhar, repita com since_seq igual ao latest_seq recebido. O serviço de voz fora do ar responde 503 INTEGRATION_UNAVAILABLE; sem ele configurado nesta instância, 503 SERVICE_UNAVAILABLE.
Autorização
bearer voice-logs:readCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: voice-logs:read
Parâmetros de consulta
Nível mínimo: debug, info, success, warning, error ou
critical. Traz esse e os mais graves.
Valor em
- "debug"
- "info"
- "success"
- "warning"
- "error"
- "critical"
sip, call, room, dispatch, agent ou general.
Valor em
- "sip"
- "call"
- "room"
- "dispatch"
- "agent"
- "general"
Só as entradas depois desta. Mande o latest_seq da resposta anterior
para ler só o que é novo.
int64Quantas entradas, as mais recentes. Padrão 100, máximo 1000.
int320 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/voice-logs"{ "capacity": 0, "entries": [ { "action": "string", "category": "string", "details": {}, "level": "string", "message": "string", "seq": 0, "tenant_id": 0, "timestamp": "string" } ], "latest_seq": 0}