Import External Content

Importe conteúdo de fontes externas para a Base de Conhecimento. Estes endpoints processam o conteúdo de forma assíncrona.

Processamento Assíncrono

Todos os endpoints de importação processam o conteúdo de forma assíncrona. Após enviar uma requisição de importação, o conteúdo é extraído (scraped) e adicionado à Base de Conhecimento em segundo plano. A Base de Conhecimento é marcada automaticamente para retreinamento assim que a importação é concluída.

Para acompanhar o progresso:

1. Verifique retrain_state em Get Knowledge Base Settings — ele muda para "to_be_retrained", depois "in_progress" e depois "up_to_date"
2. Use List Articles para verificar se os artigos importados aparecem

Scrape Website

Extraia (scrape) o conteúdo de uma única página da web ou de um site inteiro e importe-o.

Scope: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/website

Request Body

Parameter	Description
url string, required	URL a ser extraída
mode string	"individual" (padrão), "site_wide" ou "individual_with_summary"
phrases array of strings	Frases-chave a serem extraídas
html_selector string	Seletor CSS para direcionar um conteúdo específico

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/website \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/docs",
  "mode": "individual"
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/website",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"url": "https://example.com/docs", "mode": "individual"},
)
data = response.json()

Response 202 Accepted

{
  "status": "success",
  "url": "https://example.com/docs",
  "article": {}
}

Import YouTube Transcript

Importe a transcrição de um vídeo do YouTube.

Scope: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube

Request Body

Parameter	Description
url string, required	URL do vídeo do YouTube
toast_process_uuid string, required	UUID v4 para rastrear o processo de importação

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "toast_process_uuid": "550e8400-e29b-41d4-a716-446655440000"
}'

Python

import uuid
import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/youtube",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "toast_process_uuid": str(uuid.uuid4()),
    },
)

Response 202 Accepted — A transcrição é processada de forma assíncrona.

Import Sitemap

Importe conteúdo de todos os links de um sitemap XML.

Scope: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map

Request Body

Parameter	Description
site_map string, required	URL de um sitemap XML
link_filter_regex string	Regex para filtrar quais links importar (padrão: ".*")
html_selector string	Seletor CSS para direcionar um conteúdo específico
summarize boolean	Se o conteúdo importado deve ser resumido (padrão: false)

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "site_map": "https://example.com/sitemap.xml"
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/site-map",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"site_map": "https://example.com/sitemap.xml"},
)
data = response.json()

Response 202 Accepted

{
  "status": "success",
  "links": ["https://example.com/page1", "https://example.com/page2"]
}

Scrape List of Links

Importe conteúdo de uma lista específica de URLs.

Scope: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list

Request Body

Parameter	Description
links array of strings, required	Lista de URLs a serem extraídas (não vazia)
tags array of strings	Tags a aplicar aos artigos importados
html_selector string	Seletor CSS para direcionar um conteúdo específico
summarize boolean	Se o conteúdo importado deve ser resumido (padrão: false)

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "links": ["https://example.com/page1", "https://example.com/page2"],
  "tags": ["imported"]
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external/scrape-list",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "links": ["https://example.com/page1", "https://example.com/page2"],
        "tags": ["imported"],
    },
)
data = response.json()

Response 202 Accepted

{
  "status": "success",
  "links": ["https://example.com/page1", "https://example.com/page2"]
}

Delete Links

Remova da Base de Conhecimento artigos do tipo URL importados anteriormente.

Scope: write_all

DELETE https://app.quickchat.ai/v1/api/knowledge_base/import_external

Request Body

Parameter	Description
links array of strings, required	Lista de URLs a remover (mín. 1)

Nota

Todas as URLs fornecidas devem existir na Base de Conhecimento como artigos do tipo URL. Se alguma URL não corresponder a um artigo existente, a requisição retorna 404.

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/knowledge_base/import_external \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "links": ["https://example.com/page1"]
}'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/knowledge_base/import_external",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "links": ["https://example.com/page1"],
    },
)

Response 200 OK

---