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
chatbots:write
Cuerpo de la request
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
name | string | ✅ | Nombre del agente (1–100 caracteres) |
system_prompt | string | — | Instrucciones del sistema para el agente |
widget_config | object | — | Configuración visual del widget |
widget_config.primaryColor | string | — | Color primario del widget (hex) |
widget_config.greeting | string | — | Mensaje de bienvenida |
widget_config.leadCapture | boolean | — | 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
| Code | Descripción |
|---|---|
INVALID_INPUT | Falta el campo name o supera los 100 caracteres |
PLAN_LIMIT_REACHED | Se alcanzó el límite de agentes del plan |