Collections y Knowledge sources
Colecciones del centro de ayuda y fuentes que alimentan a Tinkay AI.
GET
/v1/collectionsarticles:readLista las colecciones con su cantidad de artículos.
GET
/v1/collections/{id}articles:readDevuelve una colección.
GET
/v1/knowledge-sourcesknowledge:readLista las fuentes conectadas y su estado de sincronización.
| Campo | Tipo | Descripción |
|---|---|---|
status | string | synced, processing o failed. |
type | string | website, pdf, notion, google_drive, url o api. |
GET
/v1/knowledge-gapsknowledge:readPreguntas que los clientes hicieron y la base todavía no responde, ordenadas por volumen.
| Campo | Tipo | Descripción |
|---|---|---|
status | string | open, ignored, assigned o generated. |
kind | string | missing u outdated. |
Convertir huecos en artículos
Cada hueco trae asked_count, la tendencia contra el período anterior y ejemplos reales de cómo lo preguntaron. Es la lista de trabajo del equipo de contenido: lo que está arriba es lo que más plata cuesta en derivaciones.
Terminal
curl "https://api.tinkay.app/v1/knowledge-gaps?status=open&limit=10" -H "Authorization: Bearer dk_live_xxx"Detectar fuentes con problemas
Combinado con el evento knowledge_source.failed, este endpoint sirve para alertar cuando una fuente deja de sincronizar.
Terminal
curl "https://api.tinkay.app/v1/knowledge-sources?status=failed" \ -H "Authorization: Bearer dk_live_xxx"