> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Adicionar fonte

> Adicionar uma nova fonte à base de conhecimento de um agente.

# 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.

```http theme={null}
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 |

```json theme={null}
{
  "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 |

```json theme={null}
{
  "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) |

```json theme={null}
{
  "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.

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

> [!TIP]
>
> O processamento é assíncrono. Consulte o status da fonte com [Listar fontes](https://docs.chatnorris.ai/pt/api-referencia/knowledge/listar.md) 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.