POST https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/knowledge
Authorization: Bearer <tu_api_key>
Content-Type: application/json

Agregar fuente de conocimiento

Agrega una nueva fuente a la base de conocimiento de un agente. La fuente se encola para procesamiento inmediatamente después de crearse.

POST https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/knowledge
Authorization: Bearer <tu_api_key>
Content-Type: application/json

Scope requerido: chatbots:write

Path parameters

Parámetro	Tipo	Descripción
`chatbot_id`	string	ID del agente

Cuerpo de la request

El campo type determina qué otros campos son requeridos.

Tipo `url` — página web o documento en línea

Campo	Tipo	Requerido	Descripción
`type`	string	✅	`"url"`
`name`	string	✅	Nombre descriptivo de la fuente
`source_url`	string	✅	URL completa de la página a indexar

{
  "type": "url",
  "name": "Preguntas frecuentes",
  "source_url": "https://empresa.com/faq"
}

Tipo `text` — texto libre

Campo	Tipo	Requerido	Descripción
`type`	string	✅	`"text"`
`name`	string	✅	Nombre descriptivo de la fuente
`raw_content`	string	✅	Contenido de texto a indexar

{
  "type": "text",
  "name": "Políticas de devolución",
  "raw_content": "Las devoluciones se aceptan dentro de los 30 días de la compra..."
}

Tipo `faq` — preguntas y respuestas

Campo	Tipo	Requerido	Descripción
`type`	string	✅	`"faq"`
`name`	string	✅	Nombre descriptivo
`raw_content`	string	✅	Texto con preguntas y respuestas (mínimo 2 caracteres)

{
  "type": "faq",
  "name": "FAQ de envíos",
  "raw_content": "¿Cuánto tarda el envío?\nEl envío estándar tarda 3-5 días hábiles.\n\n¿Hacen envíos al exterior?\nSí, enviamos a todo Latinoamérica."
}

Respuesta `201 Created`

La fuente se crea con status: "pending" y el procesamiento inicia en segundo plano.

{
  "status": "success",
  "data": {
    "id": "src_xyz789",
    "name": "Preguntas frecuentes",
    "type": "url",
    "status": "pending",
    "created_at": "2026-06-30T18:00:00.000Z"
  }
}

El procesamiento es asíncrono. Consultá el estado de la fuente con Listar fuentes hasta que status sea ready o error.

Errores comunes

Code	Descripción
`INVALID_INPUT`	`type` inválido, falta `name`, `source_url` no es una URL válida, o `raw_content` está vacío
`NOT_FOUND`	El agente no existe o no pertenece a tu organización

Primeros pasos

Agentes de IA

Widget Web

Canales

Conversaciones y Live Chat

Campañas

Leads y Analíticas

Equipo

Cuenta y configuración

Facturación

Solución de problemas

Preguntas frecuentes

Glosario

API Pública v2

Agregar fuente

Agregar fuente de conocimiento

Path parameters

Cuerpo de la request

Tipo `url` — página web o documento en línea

Tipo `text` — texto libre

Tipo `faq` — preguntas y respuestas

Respuesta `201 Created`

Errores comunes

​Agregar fuente de conocimiento

​Path parameters

​Cuerpo de la request

​Tipo url — página web o documento en línea

​Tipo text — texto libre

​Tipo faq — preguntas y respuestas

​Respuesta 201 Created

​Errores comunes

Agregar fuente de conocimiento

Path parameters

Cuerpo de la request

Tipo `url` — página web o documento en línea

Tipo `text` — texto libre

Tipo `faq` — preguntas y respuestas

Respuesta `201 Created`

Errores comunes