Knowledge Base API

Ce este?

Knowledge Base API le permite developerilor să creeze și să gestioneze programatic articole în knowledge base-urile HubSpot. API-ul acoperă crearea, preluarea, actualizarea și publicarea articolelor, precum și accesul de tip read la setările, categoriile și tag-urile knowledge base-ului, prin 15 endpoint-uri noi. 

De ce este important?

Dacă gestionezi un knowledge base de mari dimensiuni sau construiești instrumente pe baza conținutului HubSpot, în prezent nu ai o modalitate de a face acest lucru programatic. Fiecare articol trebuie gestionat prin interfața HubSpot.

Cu Knowledge Base API, poți:

• - Rula importuri de conținut în bulk.
• - Sincroniza conținut din sisteme externe de documentație.
• - Gestiona programatic ciclul de viață al articolelor.
• - Construi pipeline-uri de generare a conținutului bazate pe AI.

Cum funcționează?

API-ul pune la dispoziție patru tipuri de resurse:

• - Knowledge bases: listează toate knowledge base-urile dintr-un cont și preia setările, limba, domeniul și tipul de acces ale acestora.
• - Articles: creează, preia, actualizează și retrage de la publicare articole. Articolele noi sunt create ca DRAFT și necesită un pas separat pentru publicare.
• - Drafts: preia, actualizează și publică independent versiunile draft, permițând editări etapizate înainte ca acestea să fie publicate.
• - Categories & Tags: acces de tip read-only la structura organizațională a unui knowledge base, inclusiv relațiile dintre categoriile părinte și subcategorii.
•  

Cerințe de configurare

• - Un knowledge base existent, configurat în HubSpot.
• - O aplicație OAuth cu următoarele scope-uri:
  •   - cms.knowledge_base.articles.read (toate endpoint-urile GET și list).
  •   - cms.knowledge_base.articles.write (crearea și actualizarea articolelor).
  •   - cms.knowledge_base.articles.publish (publicarea și retragerea de la publicare a articolelor).
•  

Cine beneficiază?

Knowledge base este disponibil pentru conturile HubSpot Service Hub Professional și Enterprise.