KCS - API - Como Localizar o ID de Telas, Registros e Recursos no TiFlux

🛠️ KCS - API - Como Localizar o ID de Telas, Registros e Recursos no TiFlux

🕒 Tempo aproximado para leitura: 00:01:30 min

---

❓ Dúvida / Como Localizar o ID no TiFlux

Como identificar e capturar o ID numérico de registros, telas e recursos (como mesas de serviço, itens de catálogo, clientes, etapas de fluxo e formulários) no TiFlux para utilização em automações, integrações via API, conectores Webhook ou parametrizações internas?

---

🔎 Causa / Contexto

Em diversas configurações avançadas no TiFlux — como no mapeamento de nós em fluxos de IA, integrações via Webhook/API REST ou regras de automação — é necessário informar o identificador único (ID) de um determinado cadastro. Como alguns recursos exibem o ID diretamente no endereço web (URL) e outros carregam os dados em listagens dinâmicas, existem duas maneiras simples de capturar essa informação.

---

✅ Solução / Métodos de Identificação de ID

Método 1: Diretamente pela URL do Navegador (Barra de Endereço)

Para cadastros que possuem páginas dedicadas de edição/detalhes (como Mesas de Serviço, Tickets, Clientes, Contratos, etc.), o ID fica exposto diretamente na URL.

1. Navegue até o recurso que deseja identificar no TiFlux (ex: acesse a edição de uma Mesa de Serviço).

2. Observe a barra de endereços do seu navegador.

3. O número localizado logo após o nome do recurso na rota da URL representa o seu ID.

• Exemplo de URL: https://app.tiflux.com/v/configurations/service_desks/desks/)86813/basic_info

• ID identificado: 86813

Método 2: Inspeção de Rede pelo DevTools (F12 / Inspeção do Navegador)

Para telas de listagem geral ou cadastros que não alteram a URL ao abrir o item (como Itens de Catálogo de Serviços, Campos Personalizados, Estágios/Status, etc.), utilize as ferramentas de desenvolvedor do navegador:

1. Acesse a tela do recurso desejado (ex: Catálogos de serviços).

2. Pressione a tecla F12 (ou clique com o botão direito na página e selecione Inspecionar).

3. Na janela do DevTools que se abrirá ao lado ou abaixo, clique na aba Network (Rede).

4. Certifique-se de selecionar o filtro Fetch/XHR para visualizar as requisições de dados.

5. Atualize a página (F5) para que o TiFlux recarregue a lista de registros.

6. Na coluna Name, clique no arquivo JSON correspondente à requisição do recurso (ex: services_catalogs.json ou similar).

7. No painel de detalhes da requisição, clique na aba Preview (Visualização) ou Response.

8. Expanda os objetos da lista para visualizar a relação entre o nome do item (name) e o seu código numérico (id).

• Exemplo na Inspeção de Rede:

  • Requisição: services_catalogs.json?page=1...

  • Estrutura no Preview: {id: 72863, name: "Akira Personalizado"}

  • ID do Item/Catálogo: 72863

Resumo dos Métodos por Tipo de Recurso

Recurso / Tela	Onde Encontrar o ID	Exemplo de Identificação
Mesas de Serviço / Tickets / Clientes	🔗 URL da Página	Extraído diretamente do link do navegador.
Catálogo de Serviços / Estágios / Formulários	🛠️ DevTools (F12 ➔ Network ➔ Preview)	Consultando o atributo id no payload JSON retornado.

💡 Dica de Especialista / Nota: Se você estiver utilizando o parâmetro em nós de IA ou automações, sempre certifique-se de copiar o id numérico exato sem espaços ou caracteres especiais ao redor.

---

🔍 Palavras-chave para busca

como buscar id de tela tiflux,
localizar id de catalogo de servico tiflux,
identificar id mesa de servico url tiflux,
encontrar id f12 devtools network json tiflux,
pegar id de cadastro para automacao api tiflux