> 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/integracoes/api-tiflux/integracao-com-power-bi/como-utilizar.md).

# Integração de Dados Tiflux no Power BI (Data Warehouse)

## 📊 Integração de Dados Tiflux no Power BI (Data Warehouse)

```
📍 Localização:
📂 Power BI Desktop > Obter Dados > Web
```

***

### 🎯 Introdução

A conexão do Tiflux com o Power BI via Data Warehouse permite transformar dados brutos de atendimento em dashboards estratégicos e indicadores visuais. Este procedimento é essencial para garantir que informações complexas, como descrições de tickets com múltiplos parágrafos, sejam importadas corretamente, evitando erros de estrutura e garantindo a integridade do seu modelo de dados.

***

### 📚 Sumário

🧾 Obtenção de Dados via Web

🛠️ Configuração da Fonte de Dados

🧪 Ajuste de Quebras de Linha (Aspas)

📊 Transformação e Carregamento

📊 Template Exemplo

🔄 Atualização de Dados

***

### 📘 Conteúdo dividido em seções com emojis temáticos

#### 🧾 Obtenção de Dados via Web

Para iniciar a importação, abra o Power BI Desktop e utilize a opção Obter Dados. Selecione a categoria Web e, no campo de URL, insira o link gerado pelo seu Data Warehouse do Tiflux. Esta conexão estabelece uma ponte direta entre a base de dados em nuvem e o seu relatório, permitindo extrações dinâmicas de tabelas de tickets, chats ou clientes.

<figure><img src="/files/Lc11wl2suUc2hmc0X2Le" alt=""><figcaption></figcaption></figure>

#### 🛠️ Configuração da Fonte de Dados

Após inserir a URL e confirmar, o Power BI apresentará uma pré-visualização dos dados. Neste estágio, é fundamental não clicar diretamente em "Carregar". Para garantir que os dados sejam interpretados corretamente pelo motor do Power Query, clique no botão Transformar Dados. Isso abrirá o editor onde faremos os ajustes técnicos necessários.

<figure><img src="/files/Zi6MFsxIKMmHSpeFygOq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wA1fvmThcyhcX6Ya0t0x" alt=""><figcaption></figcaption></figure>

#### 🧪 Ajuste de Quebras de Linha (Aspas)

Um erro comum na importação de CSVs e links Web é a quebra indesejada de linhas dentro de campos de texto (como descrições de chamados). Para corrigir isso:

1. No editor do Power Query, localize o painel lateral Etapas Aplicadas.
2. Clique no ícone de engrenagem ao lado da etapa Fonte.
3. Na janela que se abre, procure pela opção para configurar a leitura do arquivo.
4. Localize e marque a opção "Ignorar quebras de linha entre aspas" (ou ajuste o delimitador de aspas para garantir que o texto longo seja tratado como uma única célula).

<figure><img src="/files/rWbDBCc4BahFa4KMHkfW" alt=""><figcaption></figcaption></figure>

#### 📊 Transformação e Carregamento

Com a estrutura de linhas corrigida, verifique se os cabeçalhos foram promovidos corretamente (caso contrário, use a função "Usar Primeira Linha como Cabeçalho"). Verifique os tipos de dados de cada coluna (Data, Número Inteiro, Texto) e, após finalizar os ajustes, clique em Fechar e Aplicar no canto superior esquerdo para carregar os dados para o modelo do Power BI.

***

### 📊 Video Explicativo

{% embed url="<https://www.youtube.com/watch?v=Jb39fi7gMbg>" %}

### 📊 **Template Exemplo**

Para realizar conexão dos seus dados ao modelo de BI, siga os passos abaixo:

* Baixar o [template](https://app.tiflux.com/r/arquivos-para-download/externals/knowledges/show/49444/e5c9594b-f826-417d-838e-27497ca8519f/111)
* Editar as consultas do template atualizando as colunas e a fonte para os que correspondem aos seus dados

***

### ⚠️ Avisos importantes

> Segurança de Credenciais: Ao conectar via Web, o Power BI pode solicitar o tipo de autenticação. Certifique-se de usar a chave de API ou as credenciais fornecidas no painel do Data Warehouse.
>
> Integridade do Texto: O ajuste de "quebras de linha entre aspas" é vital; sem ele, um único ticket com uma descrição longa pode "quebrar" em várias linhas, corrompendo suas métricas de contagem.

***

### ❓ Perguntas Frequentes (FAQ)

🔹 Onde encontro o link do Data Warehouse? O link é gerado dentro de configurações > geral > integrações > dados seu painel administrativo Tiflux.

🔹 Por que meus dados aparecem todos em uma única coluna? Provavelmente o delimitador (vírgula ou ponto e vírgula) não foi identificado automaticamente na etapa "Fonte".

🔹 Como atualizo os dados do dashboard? Basta clicar no botão "Atualizar" na página inicial do Power BI para que ele consulte o link novamente.

🔹 O Power BI suporta o volume total de dados do Tiflux? Sim, mas recomenda-se aplicar filtros de data no Power Query para melhorar a performance.

🔹 Posso renomear as colunas vindas do Data Warehouse? Sim, você pode renomear qualquer coluna dentro do editor de Transformar Dados.

🔹 As descrições de tickets estão cortadas, o que fazer? Verifique se o ajuste de quebras de linha foi aplicado na etapa de "Fonte" do Power Query.

🔹 Posso mesclar dados de diferentes links? Sim, você pode adicionar várias fontes Web e criar relacionamentos entre elas no Power BI.

🔹 O ajuste de aspas serve para quê exatamente? Ele garante que o Power BI entenda que tudo que está entre aspas é um texto único, mesmo que contenha "Enter".

***

### 🔍 Palavras-chave para IA, indexação e busca

```
power bi tiflux,
conexão web power bi,
data warehouse,
transformar dados,
quebra de linha entre aspas,
power query,
importação csv web,
dashboard atendimento,
integração bi,
tiflux analytics
```
