Base di conoscenza Intercom

Trasferisci la conoscenza di Intercom in Quickchat AI in pochi minuti. Se usi Fin AI di Intercom e vuoi passare a Quickchat AI o utilizzarli entrambi, questi endpoint semplificano il processo. L’intero Help Center di Intercom, con gli articoli che alimentano le risposte di Fin AI, può essere sincronizzato con la base di conoscenza di Quickchat tramite una sola chiamata API.

Come funziona:

1. Collega il tuo account Intercom tramite la dashboard Quickchat o l’integrazione nell’App Store di Intercom
2. Usa Importare gli articoli Intercom per trasferire tutti gli articoli dell’Help Center nella base di conoscenza di Quickchat, eventualmente solo nelle lingue che scegli
3. Usa Aggiornare gli articoli Intercom per mantenere sincronizzati i contenuti quando aggiorni gli articoli in Intercom
4. Se decidi di scollegare l’account, Eliminare gli articoli Intercom rimuove tutti i contenuti sincronizzati

L’agente AI ha quindi accesso immediato alla stessa conoscenza usata da Fin AI, senza trasferire manualmente i contenuti. Per una procedura completa sull’integrazione Intercom, consulta la guida al canale Intercom. Per saperne di più sul passaggio da Fin AI, visita Quickchat come alternativa a Fin AI.

Aggiornare gli articoli Intercom

Recupera nuovamente gli articoli esistenti da Intercom e importa quelli nuovi.

Gli articoli importati con locales vengono aggiornati nelle stesse lingue e tutte le versioni linguistiche di un articolo Intercom vengono aggiornate insieme.

Ambito: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/refresh_articles

Corpo della richiesta

Parametro	Descrizione
article_ids array di interi	ID degli articoli della base di conoscenza da recuperare nuovamente, restituiti da Elencare gli articoli con types=Intercom. Predefinito: nessuno, quindi nessun articolo esistente viene recuperato nuovamente. Per aggiornare tutti gli articoli, passa tutti i loro ID.
fetch_new_articles booleano	Indica se recuperare nuovi articoli (predefinito: true)

Risposta 200 OK (oggetto JSON vuoto). Restituisce 400 se un ID non corrisponde a un articolo Intercom nella tua base di conoscenza.

Elencare le lingue dell’Help Center Intercom

Elenca le lingue pubblicate dal tuo Help Center Intercom, il numero di articoli pubblicati in ciascuna e le lingue suggerite per l’importazione, cioè la lingua dell’agente AI quando è disponibile nell’Help Center.

Ambito: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/intercom/locales

Risposta 200 OK

{
  "locales": [
    { "locale": "uk", "article_count": 259 },
    { "locale": "en", "article_count": 220 }
  ],
  "suggested_locales": ["uk"]
}

Un elenco locales vuoto indica che l’Help Center non pubblica versioni linguistiche: importa senza locales.

Importare gli articoli Intercom

Importa tutti gli articoli da Intercom.

Ambito: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/import

Corpo della richiesta (facoltativo)

Parametro	Descrizione
locales array di stringhe	Lingue dell’Help Center da importare, per esempio ["uk"]. Ogni lingua viene importata come articoli separati, che contano ai fini del limite di articoli del piano. Ometti il parametro per importare una versione di ogni articolo: l’inglese quando disponibile, altrimenti la lingua predefinita dell’Help Center.

Risposta 200 OK: restituisce un elenco di snapshot degli articoli importati. Restituisce 400 se non è pubblicato alcun articolo nelle lingue selezionate.

Eliminare gli articoli Intercom

Rimuove dalla base di conoscenza tutti gli articoli provenienti da Intercom.

Ambito: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/intercom/delete

Risposta 200 OK (oggetto JSON vuoto)

---