Skip to main content

​
Crear agente

Crea un nuevo agente de IA. El agente se crea en estado borrador (is_published: false). 
POST https://app.chatnorris.ai/api/v2/chatbots
Authorization: Bearer <tu_api_key>
Content-Type: application/json
Scope requerido: chatbots:write

​
Cuerpo de la request

CampoTipoRequeridoDescripción
namestring✅Nombre del agente (1–100 caracteres)
system_promptstring—Instrucciones del sistema para el agente
widget_configobject—Configuración visual del widget
widget_config.primaryColorstring—Color primario del widget (hex)
widget_config.greetingstring—Mensaje de bienvenida
widget_config.leadCaptureboolean—Si el widget captura leads antes del chat

​
Ejemplo

{
  "name": "Soporte al cliente",
  "system_prompt": "Eres el asistente virtual de Acme Corp. Respondé en español, con tono amable y conciso.",
  "widget_config": {
    "primaryColor": "#00ed64",
    "greeting": "¡Hola! ¿En qué puedo ayudarte hoy?",
    "leadCapture": false
  }
}

​
Respuesta 201 Created

{
  "status": "success",
  "data": {
    "id": "bot_xyz789",
    "name": "Soporte al cliente",
    "description": null,
    "system_prompt": "Eres el asistente virtual de Acme Corp...",
    "model": "claude-sonnet-4-6",
    "temperature": 0.7,
    "max_tokens": 1000,
    "is_active": true,
    "is_published": false,
    "widget_config": {
      "primaryColor": "#00ed64",
      "greeting": "¡Hola! ¿En qué puedo ayudarte hoy?",
      "leadCapture": false
    },
    "created_at": "2026-06-30T18:00:00.000Z",
    "updated_at": "2026-06-30T18:00:00.000Z"
  }
}

​
Errores comunes

CodeDescripción
INVALID_INPUTFalta el campo name o supera los 100 caracteres
PLAN_LIMIT_REACHEDSe alcanzó el límite de agentes del plan