> 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FotDxRimi2SaE4CaeuwQn%2Fimage.png?alt=media&amp;token=a701feac-4549-4ba3-b0a4-5bba45527ee1" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FRZFSLakY4UAoccxyq0ul%2Fimage.png?alt=media&amp;token=e45d91c7-4b56-449b-b728-0ffbe4ce278a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FH9wPUq2gXlr1hJxNnq3J%2Fimage.png?alt=media&amp;token=0e4cb406-f8ca-4989-8e9b-473784df5d94" 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="https://2304813967-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LCU_zijA4r4IkDIJyZG%2Fuploads%2FT9vKzZZilkut2Mt3Fz74%2Fimage.png?alt=media&amp;token=03aacd97-488a-4604-8c66-f53e300a8c19" 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 um Modelo de exemplo
* 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
```