Skip to main content

​
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ámetroTipoDescripción
chatbot_idstringID 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

CampoTipoRequeridoDescripción
typestring✅"url"
namestring✅Nombre descriptivo de la fuente
source_urlstring✅URL completa de la página a indexar
{
  "type": "url",
  "name": "Preguntas frecuentes",
  "source_url": "https://empresa.com/faq"
}

​
Tipo text — texto libre

CampoTipoRequeridoDescripción
typestring✅"text"
namestring✅Nombre descriptivo de la fuente
raw_contentstring✅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

CampoTipoRequeridoDescripción
typestring✅"faq"
namestring✅Nombre descriptivo
raw_contentstring✅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

CodeDescripción
INVALID_INPUTtype inválido, falta name, source_url no es una URL válida, o raw_content está vacío
NOT_FOUNDEl agente no existe o no pertenece a tu organización