Skip to main content

Listar agentes

Devuelve todos los agentes de IA de tu organización, ordenados por fecha de creación descendente.
GET https://app.chatnorris.ai/api/v2/chatbots
Authorization: Bearer <tu_api_key>
Scope requerido: chatbots:read

Query parameters

ParámetroTipoDescripción
pageintegerNúmero de página. Default: 1
per_pageintegerResultados por página. Default: 25, máximo 100

Respuesta

{
  "status": "success",
  "data": {
    "chatbots": [
      {
        "id": "bot_abc123",
        "name": "Soporte al cliente",
        "description": "Agente de soporte para consultas generales",
        "system_prompt": "Eres el asistente virtual de Acme Corp...",
        "model": "claude-sonnet-4-6",
        "temperature": 0.3,
        "max_tokens": 1000,
        "is_active": true,
        "is_published": true,
        "widget_config": {
          "primaryColor": "#00ed64",
          "greeting": "¡Hola! ¿En qué puedo ayudarte?",
          "leadCapture": false
        },
        "created_at": "2025-03-20T14:30:00.000Z",
        "updated_at": "2025-06-01T09:15:00.000Z"
      }
    ]
  },
  "pages": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 25,
    "total": 3
  }
}

Campos de respuesta

CampoTipoDescripción
idstringID único del agente
namestringNombre del agente
descriptionstring | nullDescripción opcional
system_promptstringInstrucciones del sistema
modelstringModelo de IA configurado
temperaturenumberTemperatura (0–1)
max_tokensintegerLongitud máxima de respuesta
is_activebooleanSi el agente está activo
is_publishedbooleanSi el agente está publicado (visible en canales)
widget_configobjectConfiguración visual del widget
created_atstringFecha de creación (ISO 8601)
updated_atstringÚltima modificación (ISO 8601)