> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/faq/duvidas-frequentes/api/kcs-api-como-localizar-o-id-de-telas-registros-e-recursos-no-tiflux.md).

# 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<br>

***

### ❓ 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?<br>

***

### 🔎 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.<br>

***

### ✅ 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.<br>

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`

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FP96YAt3IJlLrrf0edrer%2Fimage.png?alt=media&amp;token=72638a8c-ccc3-4d0e-a389-817895df09d1" alt=""><figcaption></figcaption></figure>

#### 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:<br>

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`

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FAHP4idJo7XBs35QYbgcJ%2Fimage.png?alt=media&amp;token=c55d8513-078e-4308-8717-46e210777200" alt=""><figcaption></figcaption></figure>

#### 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                       | <p>Extraído diretamente do link do navegador.<br></p>                        |
| Catálogo de Serviços / Estágios / Formulários | 🛠️ DevTools (F12 ➔ Network ➔ Preview) | <p>Consultando o atributo <code>id</code> no payload JSON retornado.<br></p> |

> 💡 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
```
