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

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

Adicionar fonte de conhecimento

Adiciona uma nova fonte à base de conhecimento de um agente. A fonte entra na fila de processamento imediatamente após ser criada.

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

Escopo necessário: chatbots:write

Path parameters

Parâmetro	Tipo	Descrição
`chatbot_id`	string	ID do agente

Corpo da request

O campo type determina quais outros campos são obrigatórios.

Tipo `url` — página web ou documento online

Campo	Tipo	Obrigatório	Descrição
`type`	string	✅	`"url"`
`name`	string	✅	Nome descritivo da fonte
`source_url`	string	✅	URL completa da página a indexar

{
  "type": "url",
  "name": "Perguntas frequentes",
  "source_url": "https://empresa.com/faq"
}

Tipo `text` — texto livre

Campo	Tipo	Obrigatório	Descrição
`type`	string	✅	`"text"`
`name`	string	✅	Nome descritivo da fonte
`raw_content`	string	✅	Conteúdo de texto a indexar

{
  "type": "text",
  "name": "Políticas de devolução",
  "raw_content": "As devoluções são aceitas em até 30 dias após a compra..."
}

Tipo `faq` — perguntas e respostas

Campo	Tipo	Obrigatório	Descrição
`type`	string	✅	`"faq"`
`name`	string	✅	Nome descritivo
`raw_content`	string	✅	Texto com perguntas e respostas (mínimo de 2 caracteres)

{
  "type": "faq",
  "name": "FAQ de entregas",
  "raw_content": "Quanto tempo demora a entrega?\nA entrega padrão leva de 3 a 5 dias úteis.\n\nVocês fazem entregas para o exterior?\nSim, entregamos em toda a América Latina."
}

Resposta `201 Created`

A fonte é criada com status: "pending" e o processamento começa em segundo plano.

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

O processamento é assíncrono. Consulte o status da fonte com Listar fontes até que status seja ready ou error.

Erros comuns

Code	Descrição
`INVALID_INPUT`	`type` inválido, falta `name`, `source_url` não é uma URL válida ou `raw_content` está vazio
`NOT_FOUND`	O agente não existe ou não pertence à sua organização

Primeiros passos

Agentes de IA

Widget web

Canais

Conversas e chat ao vivo

Campanhas

Leads e análises

Equipe

Conta e configurações

Faturamento

Solução de problemas

Perguntas frequentes

Glossário

API pública v2

Adicionar fonte

Adicionar fonte de conhecimento

Path parameters

Corpo da request

Tipo `url` — página web ou documento online

Tipo `text` — texto livre

Tipo `faq` — perguntas e respostas

Resposta `201 Created`

Erros comuns

​Adicionar fonte de conhecimento

​Path parameters

​Corpo da request

​Tipo url — página web ou documento online

​Tipo text — texto livre

​Tipo faq — perguntas e respostas

​Resposta 201 Created

​Erros comuns

Adicionar fonte de conhecimento

Path parameters

Corpo da request

Tipo `url` — página web ou documento online

Tipo `text` — texto livre

Tipo `faq` — perguntas e respostas

Resposta `201 Created`

Erros comuns