Listar fontes de conhecimento
Retorna todas as fontes da base de conhecimento de um agente, ordenadas por data de criação decrescente.GET https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/knowledge
Authorization: Bearer <sua_api_key>
chatbots:read
Path parameters
| Parâmetro | Tipo | Descrição |
|---|---|---|
chatbot_id | string | ID do agente |
Resposta
{
"status": "success",
"data": {
"sources": [
{
"id": "src_abc123",
"name": "Página de perguntas frequentes",
"type": "url",
"status": "ready",
"source_url": "https://empresa.com/faq",
"char_count": 12540,
"chunk_count": 18,
"last_synced": "2026-06-28T10:00:00.000Z",
"error_message": null,
"created_at": "2025-04-10T09:00:00.000Z"
},
{
"id": "src_def456",
"name": "Políticas de entrega",
"type": "text",
"status": "ready",
"source_url": null,
"char_count": 3200,
"chunk_count": 5,
"last_synced": "2025-04-10T09:05:00.000Z",
"error_message": null,
"created_at": "2025-04-10T09:05:00.000Z"
}
]
}
}
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID único da fonte |
name | string | Nome descritivo da fonte |
type | string | Tipo de fonte: url, sitemap, url_list, document, text, faq, woocommerce_catalog, woocommerce_variations, zendesk, google_drive ou freshdesk. Pela API você só pode criar url, text e faq; os demais são adicionados pelo dashboard |
status | string | Status: pending, processing, ready ou error |
source_url | string | null | URL da fonte (nas fontes baseadas em uma URL, como url ou sitemap) |
char_count | integer | Caracteres indexados |
chunk_count | integer | Fragmentos gerados para a busca vetorial |
last_synced | string | Última data de processamento (ISO 8601) |
error_message | string | null | Mensagem de erro se status for error |
created_at | string | Data de criação (ISO 8601) |
Erros comuns
| Code | Descrição |
|---|---|
NOT_FOUND | O agente não existe ou não pertence à sua organização |