Import External Content

Importez du contenu de sources externes dans la Knowledge Base. Ces endpoints traitent le contenu de manière asynchrone.

Traitement asynchrone

Tous les endpoints d’import traitent le contenu de manière asynchrone. Après la soumission d’une requête d’import, le contenu est scrapé et ajouté à la Knowledge Base en arrière-plan. La Knowledge Base est automatiquement marquée pour réentraînement une fois l’import terminé.

Pour suivre la progression :

1. Vérifiez retrain_state via Get Knowledge Base Settings — il passe à "to_be_retrained" puis "in_progress" puis "up_to_date"
2. Utilisez List Articles pour vérifier que les articles importés apparaissent

Scrape Website

Scrapez une seule page web ou un site web entier et importez le contenu.

Scope: write_all

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

Request Body

Parameter	Description
url string, required	URL à scraper
mode string	"individual" (par défaut), "site_wide", ou "individual_with_summary"
phrases array of strings	Phrases clés à extraire
html_selector string	Sélecteur CSS pour cibler un contenu spécifique

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

Importez la transcription d’une vidéo YouTube.

Scope: write_all

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

Request Body

Parameter	Description
url string, required	URL de la vidéo YouTube
toast_process_uuid string, required	UUID v4 pour le suivi du processus d’import

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 — La transcription est traitée de manière asynchrone.

Import Sitemap

Importez le contenu de tous les liens d’un 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 d’un sitemap XML
link_filter_regex string	Regex pour filtrer les liens à importer (par défaut : ".*")
html_selector string	Sélecteur CSS pour cibler un contenu spécifique
summarize boolean	S’il faut résumer le contenu importé (par défaut : 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

Importez le contenu d’une liste spécifique d’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	Liste d’URLs à scraper (non vide)
tags array of strings	Tags à appliquer aux articles importés
html_selector string	Sélecteur CSS pour cibler un contenu spécifique
summarize boolean	S’il faut résumer le contenu importé (par défaut : 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

Retirez de la Knowledge Base des articles de type URL précédemment importés.

Scope: write_all

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

Request Body

Parameter	Description
links array of strings, required	Liste d’URLs à retirer (min 1)

Note

Toutes les URLs fournies doivent exister dans la Knowledge Base sous forme d’articles de type URL. Si une URL ne correspond à aucun article existant, la requête retourne 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

---