--- title: "Matriz de Habilidades" slug: "skill-matrix" updated: 2026-10-22T17:13:47Z published: 2026-10-22T17:13:47Z canonical: "support.tulip.co/skill-matrix" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Matriz de Habilidades :::(Info)To download, visit: [Library](https://library.tulip.co/apps/skill-matrix). ::: ## O que é o widget Matriz de Habilidades? **O widget Matriz de Habilidades** permite visualizar, filtrar e gerenciar as habilidades dos usuários e os níveis de competência nas tarefas em uma tabela no estilo de matriz. ![Screenshot 2025-08-08 at 17.32.49.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Screenshot%202025-08-08%20at%2017.32.49.png) ### Você pode usar este widget para: - Acompanhar as habilidades dos operadores e identificar lacunas - Visualizar habilidades por usuário, grupo, tarefa ou nível - Filtrar dados de habilidades dinamicamente - Interagir com as células da matriz para visualizar registros detalhados ou acionar ações Este guia explica como configurar e usar o widget Matriz de Competências no **Tulip**. --- ## Pré-requisitos Antes de começar, certifique-se de ter: - Acesso à sua **conta do Tulip** - Permissão para **visualizar Contas de Serviço** e **gerenciar tabelas** - **A URL da** sua **conta do Tulip** e **o ID do espaço de trabalho** --- ## 1. Configure os parâmetros obrigatórios ### 1.1 Obtenha sua conta de serviço Feature rename Prior to r383, Service Accounts were called "API Tokens". 1. Clique no **ícone do usuário** no canto superior direito do Tulip. 2. Acesse **“Configurações** da **conta**”. 3. Clique em **API do Tulip** no menu à esquerda. 4. Clique em **“Criar conta de serviço**”. 5. Dê um nome à sua conta de serviço (por exemplo, `SkillMatrixWidget`). 6. Atribua os seguintes escopos: 7. `table-queries:read` 8. `tables:read` 9. `tabelas:gravação` 10. `users:read` 11. Clique em **Criar**. 12. Copie o **cabeçalho de autenticação**, mas **remova** a palavra `“Basic”` e o espaço após ela. 13. Ao configurar o widget: se for solicitado que você escolha entre **“Valor** **variável”** e **“Valor estático”** para a **conta de serviço**, selecione **“Valor estático”** e cole suas credenciais **(sem “Basic”)** diretamente no campo. Caution Never share your Service Account credentials publicly. --- ### 1.2 Encontre a URL da sua conta Tulip A URL da sua conta geralmente tem o seguinte formato: `sua-conta.tulip.co` --- ### 1.3 Localize o ID da sua tabela de tarefas 1. Acesse a seção **“Tabelas”** no Tulip. 2. Clique na **tabela de tarefas** relevante. 3. Copie o **UID da tabela** na seção de detalhes. --- ### 1.4 Identifique os IDs dos campos Localize os **IDs dos campos** para: - O usuário (por exemplo, nome ou ID do usuário) - O nome da habilidade/tarefa - O nível de habilidade Para encontrar o ID de um campo: 1. Abra a tabela. 2. Clique no cabeçalho da coluna. 3. Visualize o **ID do campo** no painel de propriedades. Tip There are no enforced default names for these fields; you must decide which of your fields will be treated as user/skill/level when configuring the widget. --- ## 2. Configurar parâmetros opcionais Você pode personalizar ainda mais o widget usando os seguintes parâmetros opcionais: - **ID do campo de grupo**: organiza os dados por equipe, departamento etc. - **Status do projeto**: Filtra por status (por exemplo, Ativo, Concluído). - **Cores de nível**: atribui cores personalizadas a diferentes níveis de habilidade. --- ### 2.1 Filtros Você pode adicionar filtros opcionais para personalizar quais dados aparecem na matriz. | Filtro | Descrição | | --- | --- | | **Título** | Por padrão, o filtro **“Título”** geralmente se refere ao seu grupo, nome da habilidade ou campo de categoria da tarefa. | | **Visível** | Controla a visibilidade de um registro. O padrão é `verdadeiro`. | :::(Informações) (Observação) Os filtros são opcionais e devem refletir o seu caso de uso. Você pode configurar filtros para vários fields e desativar facilmente aqueles que não precisar após a configuração. Apenas os filtros ativos afetarão seus dados. ::: --- ### 2.2 Configuração avançada #### Filtros de consulta da API Você pode controlar quais registros são exibidos usando consultas de filtro personalizadas da API. Note When you apply multiple filter conditions, they are combined using a logical **AND**. This means **all conditions must be true** for a record to be returned. **Exemplos de consultas:**`json{"field":"-fieldID1-", "arg":"-value-", "functionType":"greaterThanOrEqual"},{"field":"-fieldID2-", "arg":"-value-", "functionType":"lessThanOrEqual"}` **Limite da API:** restrinja o número de linhas carregadas. ### 2.3. Defina o ID do seu Workspace - Você pode encontrar **o ID** do seu **Workspace** na URL do Tulip após `/w/.` Por exemplo:`https://your-account.tulip.co/w/DEFAULT` → O ID do Workspace é `DEFAULT` - Para o espaço de trabalho padrão, use `DEFAULT` ou deixe o campo em branco. ## 3. Use o widget Matriz de Competências ### 3.1. Visualizar dados de competências Depois de configurado, o widget exibe uma matriz com: - Usuários - Tarefas ou habilidades - Níveis de competência correspondentes Use os filtros integrados no menu suspenso (Grupos, Competências, Níveis) para refinar sua visualização. ### 3.2. Atualizar e filtrar - Clique em **“Limpar filtros”** para remover todas as seleções de filtro. - Clique em **“Atualizar”** para atualizar os dados. ### 3.3. Pré-filtragem Os pré-filtros filtram os dados dinamicamente com base em: - O usuário conectado no momento - Equipe ou departamento selecionado - Intervalo de datas ou turno Tip Use pre-filters to personalize views for operators or supervisors. ## 4. Adicionar gatilhos para ações interativas Você pode configurar o widget para acionar ações quando um usuário clicar em uma célula. 1. Abra o painel **“Gatilhos** ”. 2. Defina uma ação para o **ID do registro** quando uma célula for clicada. 3. Ative **“Carregar registro”** para exibir mais detalhes sobre o usuário ou a habilidade. ## Dicas - Verifique novamente **os IDs** **da tabela** e **dos campos** para evitar erros de digitação. - Use filtros para personalizar painéis para diferentes funções. - Teste com dados simulados antes de lançar em produção. ## Solução de problemas | Problema | Causa provável | Solução sugerida | | --- | --- | --- | | A matriz não carrega | Credencial de API ou URL inválida | Verifique novamente as credenciais/URL | | Os dados não aparecem | Filtros muito restritivos | Remova ou flexibilize os filtros | | Campos “indefinidos” | ID de campo incorreto utilizado | Verifique os IDs dos campos da tabela | | Células não clicáveis | Gatilho não configurado | Configure o gatilho no widget | ## Leitura complementar: [Listar registros de um Tulip Table](https://support.tulip.co/apidocs/list-records-of-a-tulip-table)[Como configurar uma API do Tulip](https://support.tulip.co/docs/set-up-a-tulip-api)