URL degli articoli per lingua

Gli URL per lingua permettono di associare agli articoli link alle fonti specifici per lingua. Quando l’AI cita un articolo durante una conversazione, il widget di chat mostra l’URL corrispondente alla lingua rilevata nella conversazione (most_frequent_language). È utile per implementazioni multilingue in cui lo stesso contenuto ha URL diversi per ciascuna lingua, per esempio example.com/en/returns e example.com/es/devoluciones.

Recuperare un URL per lingua

Ambito: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Shell

curl https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Risposta 200 OK

{
  "url": "https://example.com/en/return-policy"
}

Creare un URL per lingua

Ambito: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Corpo della richiesta

Parametro	Descrizione
url stringa, obbligatorio	URL della versione nella lingua specificata

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"url": "https://example.com/en/return-policy"}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={"url": "https://example.com/en/return-policy"},
)
data = response.json()

Risposta 200 OK

{
  "url": "https://example.com/en/return-policy"
}

Aggiornare un URL per lingua

Ambito: write_all

PATCH https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Corpo della richiesta

Parametro	Descrizione
url stringa, obbligatorio	URL aggiornato

Risposta 200 OK: restituisce l’oggetto URL aggiornato.

Eliminare un URL per lingua

Ambito: write_all

DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}/lang_urls/{language}

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234/lang_urls/en",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)

Risposta 200 OK

---