Obtener Logs del Monitor
Obtiene el historial de eventos del agente de IA. Permite consultar eventos recientes, filtrar por contacto especifico, o buscar por sesion/nombre de contacto.
El endpoint selecciona automaticamente la consulta segun los parametros:
- Si se envia
search: busca por session_id o contact_name (busqueda profunda) - Si se envia
contactId: filtra eventos de un contacto especifico - Si no se envia ninguno: retorna los eventos mas recientes
Tipos de evento disponibles
| event_type | Descripcion |
|---|---|
msg_in | Mensaje entrante del contacto |
msg_out | Respuesta del agente |
model | Proveedor y modelo de IA seleccionado |
tool_call | Llamada a herramienta del LLM |
api_req | Request HTTP a servicio externo |
api_res | Response del servicio externo |
action | Accion ejecutada (asignar agente, etiqueta, fase, etc.) |
rag | Busqueda en base de conocimiento |
tokens | Consumo de tokens (input/output) |
error | Error durante el procesamiento |
bot_off | Bot apagado |
session_field | Campo de sesion solicitado |
Ejemplos de uso
Ultimos 100 eventos:
curl "https://api.plazbot.com/api/agent/logs?agentId=AGENT_ID&limit=100" \
-H "x-workspace-id: WORKSPACE_ID" \
-H "Authorization: Bearer TOKEN"
Buscar por telefono (session_id):
curl "https://api.plazbot.com/api/agent/logs?agentId=AGENT_ID&search=51932114990&from=2026-03-01 00:00:00&limit=200" \
-H "x-workspace-id: WORKSPACE_ID" \
-H "Authorization: Bearer TOKEN"
Buscar por nombre de contacto:
curl "https://api.plazbot.com/api/agent/logs?agentId=AGENT_ID&search=Maria&from=2026-03-01 00:00:00&limit=200" \
-H "x-workspace-id: WORKSPACE_ID" \
-H "Authorization: Bearer TOKEN"
Filtrar por contacto especifico:
curl "https://api.plazbot.com/api/agent/logs?agentId=AGENT_ID&contactId=CONTACT_ID&from=2026-03-01 00:00:00&limit=50" \
-H "x-workspace-id: WORKSPACE_ID" \
-H "Authorization: Bearer TOKEN"
Authorizations
Token de autenticacion Bearer. Obtenga el token usando el endpoint /api/user/login
Headers
Identificador del workspace
Query Parameters
ID del Agente de IA
ID del contacto para filtrar eventos de un contacto especifico. No se puede combinar con search.
Texto para buscar en session_id (numero de telefono) o contact_name. Coincidencia parcial, case insensitive. No se puede combinar con contactId.
Fecha desde la cual obtener eventos. Formato: YYYY-MM-DD HH:MM:SS. Si no se especifica, retorna los mas recientes.
Cantidad maxima de eventos a retornar
1 <= x <= 500