KCS - API Conhecimento - Listar Pastas Conhecimentos via API no TiFlux
📁 API Conhecimento - Listar Pastas Conhecimentos via API no TiFlux
🕒 Tempo aproximado para leitura: 00:01:30 min
❓ Dúvida / Problema
É possível consultar e listar as pastas da Base de Conhecimento via integração (API v2) e quais regras de acesso, parâmetros ou filtros estão disponíveis nessa rota?
🔎 Causa / Contexto
Desenvolvedores e administradores necessitam compreender o escopo técnico e o comportamento da API do TiFlux ao consultar a estrutura de pastas e os artigos vinculados a elas para integração com portais externos, intranets ou chatbots.
✅ Solução / Especificação Técnica da API
Sim, a API v2 do TiFlux disponibiliza o endpoint GET /knowledge-folders para consultar e integrar as pastas de conhecimentos cadastradas na organização.
1. Regras de Visibilidade e Permissão
Sem restrição (Acesso total): Requer a permissão de "Gerenciar base de conhecimento".
Acesso padrão (Sem permissão específica): Retorna as pastas com conhecimentos públicos e as pastas associadas ao grupo de atendentes do usuário autenticado.
2. Filtros e Recursos Suportados pela API
Busca textual (
search): Permite filtrar pastas por título, tags e primeiros caracteres da descrição.Paginação (
offsetelimit): Controle de páginas e limite de retorno (de 1 até 200 itens por requisição).Mapeamento de IDs (
knowledge_ids): Traz a lista completa dos IDs de conhecimentos vinculados a cada pasta.
3. Documentação da Requisição
Endpoint:
GET [https://api.tiflux.com/api/v2/#get-/knowledge-folders]Autenticação: Header HTTP
Bearer TokenDocumentação Completa: Documentação da API v2 - Knowledge Folders
💡 Dica de Especialista / Nota Comercial: Esta funcionalidade permite integrar a Base de Conhecimento do TiFlux a portais corporativos, intranets, bots de atendimento (AI) ou sistemas externos, automatizando a exibição da árvore de conteúdos.
🔍 Palavras-chave para busca
Atualizado