Obtener Logs del Monitor

curl --request GET \
  --url https://api.plazbot.com/api/agent/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'

{
  "success": true,
  "data": [
    {
      "timestamp": "2026-03-14 15:30:01",
      "workspace_id": "<string>",
      "agent_id": "<string>",
      "contact_id": "<string>",
      "contact_name": "Maria Garcia",
      "session_id": "51932114990",
      "event_type": "msg_in",
      "event_title": "Hola, quiero informacion de precios",
      "event_data": "{\"message\":\"Hola, quiero informacion de precios\",\"platform\":\"whatsapp\"}",
      "duration_ms": 340,
      "level": "info"
    }
  ]
}

Agent

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, etapa, 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"

GET

api

agent

logs

Obtener Logs del Monitor

curl --request GET \
  --url https://api.plazbot.com/api/agent/logs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-workspace-id: <x-workspace-id>'

{
  "success": true,
  "data": [
    {
      "timestamp": "2026-03-14 15:30:01",
      "workspace_id": "<string>",
      "agent_id": "<string>",
      "contact_id": "<string>",
      "contact_name": "Maria Garcia",
      "session_id": "51932114990",
      "event_type": "msg_in",
      "event_title": "Hola, quiero informacion de precios",
      "event_data": "{\"message\":\"Hola, quiero informacion de precios\",\"platform\":\"whatsapp\"}",
      "duration_ms": 340,
      "level": "info"
    }
  ]
}

Authorizations

Authorization

string

header

required

Token de autenticacion Bearer. Obtenga el token usando el endpoint /api/user/login

Headers

x-workspace-id

string

required

Identificador del workspace

Query Parameters

agentId

string

required

ID del Agente de IA

contactId

string

ID del contacto para filtrar eventos de un contacto especifico. No se puede combinar con search.

string

Texto para buscar en session_id (numero de telefono) o contact_name. Coincidencia parcial, case insensitive. No se puede combinar con contactId.

from

string<date-time>

Fecha desde la cual obtener eventos. Formato: YYYY-MM-DD HH:MM:SS. Si no se especifica, retorna los mas recientes.

limit

integer

default:100

Cantidad maxima de eventos a retornar

Required range: 1 <= x <= 500

Response

Lista de eventos del agente obtenida exitosamente

success

boolean

Indica si la operacion fue exitosa

Example:

true

data

object[]

Array de eventos del agente ordenados por timestamp descendente

Show child attributes

Generar Agente con Prompt Obtener Link de Onboarding