Como configurar a integração do Power BI para análises

Disponível como complemento

O que você pode exportar

• Publicações: uma linha por publicação, com a data, o perfil, a rede, o tipo de publicação e métricas como impressões, engajamento, curtidas, comentários, compartilhamentos e reproduções.
• Dados diários do perfil: uma linha por perfil por dia, com métricas como seguidores, impressões, engajamento, alcance e o número de publicações feitas naquele dia.

Antes de começar

• A integração com o Power BI faz parte do complemento Premium integrations.
• Sua conta precisa ter API access, que também é um complemento. Se você não encontrar Generate API key em Settings → Integrations, entre em contato com nossa equipe de suporte para adicioná-lo.
• Você precisa de uma chave de API do Vista Social. Acesse Settings → Integrations e clique em Generate API key se ainda não tiver uma. Mantenha a chave privada: qualquer pessoa que a tenha pode ler os dados da sua conta.
• Você precisa do Power BI Desktop para criar o relatório. Para atualizá-lo de acordo com uma programação, também precisa do Power BI Service.

Etapa 1: Encontre o ID do grupo de perfis

Cada exportação inclui um grupo de perfis. Para ver seus grupos de perfis e os respectivos IDs:

1. No Power BI Desktop, clique em Home → Get data, pesquise por blank e escolha Blank query.

2. Substitua todo o conteúdo no editor de consultas pela consulta abaixo e insira sua chave de API no lugar de YOUR_API_KEY. Se o editor de consultas não abrir imediatamente, clique primeiro em Advanced Editor.

let
    Source = Json.Document(
        Web.Contents(
            "https://vistasocial.com/api/integration/powerbi/groups",
            [Headers = [#"x-api-key" = "YOUR_API_KEY"]]
        )
    ),
    Groups = Table.FromRecords(Source)
in
    Groups

3. Clique em Next (ou Done). Se o Power BI exibir uma mensagem informando que faltam credenciais, clique em Configure credentials, defina Authentication kind como Anonymous e clique em Connect. Sua chave de API já está na consulta, então o Power BI não precisa de um login.

Você verá uma tabela com o id, o name e o type de cada grupo de perfis ao qual você tem acesso. Copie o id do grupo sobre o qual deseja criar relatórios. Depois, você pode excluir esta consulta.

Etapa 2: Conecte o Power BI aos seus dados

1. Clique em Home → Get data → Web. Se não encontrar Web, clique na seta abaixo de Get data ou pesquise por web.
2. Escolha Advanced.
3. Em URL parts, cole o endereço de exportação, substituindo GROUP_ID pelo ID do seu grupo de perfis:
4. Confira a coluna date. Nos dados de publicações, ela aparece como texto, por exemplo, "16 de outubro de 2026". Clique em Transform Data, selecione a coluna date, acesse Transform → Data Type → Date e clique em Close & Apply. Os dados diários do perfil já usam YYYY-MM-DD e geralmente são reconhecidos como uma data.

https://vistasocial.com/api/integration/powerbi/data?group=GROUP_ID&export_type=post&format=csv&days=90

4. Em HTTP request header parameters, digite x-api-key como nome e cole sua chave de API como valor.
5. Clique em OK. Se o Power BI perguntar como você quer entrar, escolha Anonymous e clique em Connect. O cabeçalho contém sua chave de API.
6. Na tela de pré-visualização, defina Data Type Detection como Based on entire dataset, para que as métricas vazias nas primeiras linhas também sejam convertidas em números. Em seguida, clique em Load ou em Transform Data para organizar as colunas primeiro.

Mantenha sua chave de API no cabeçalho, não no endereço da Web. Os endereços costumam ser salvos em registros e no histórico do navegador.

Altere o que você exporta

Edite as opções no endereço de exportação:

• export_type: post para uma linha por publicação ou daily para uma linha por perfil por dia.
• format: mantenha csv. Sem essa opção, os dados são retornados como JSON.
• days: de 1 a 360. Um período móvel que termina hoje, então cada atualização programada avança esse período.
• date_from e date_to: um período fixo no formato YYYY-MM-DD, de até 360 dias. Use essas opções em vez de days. Se você adicionar as duas, days será usado.

Veja alguns exemplos:

• Publicações dos últimos 30 dias: &export_type=post&format=csv&days=30
• Dados diários do perfil dos últimos 90 dias: &export_type=daily&format=csv&days=90
• Dados diários do perfil para o primeiro semestre do ano: &export_type=daily&format=csv&date_from=2026-01-01&date_to=2026-06-30

Para gerar relatórios sobre publicações e dados diários do perfil, adicione uma fonte de dados para cada um.

Usar uma consulta em branco

Se preferir trabalhar no editor de consultas, clique em Home → Get data → Blank query e cole a consulta abaixo. Substitua GROUP_ID pelo ID do seu grupo de perfis e YOUR_API_KEY pela sua chave de API. Depois, edite as opções em Query = [...].

let
    Source = Csv.Document(
        Web.Contents(
            "https://vistasocial.com/api/integration/powerbi/data",
            [
                Query = [group = "GROUP_ID", export_type = "post", format = "csv", days = "90"],
                Headers = [#"x-api-key" = "YOUR_API_KEY"]
            ]
        ),
        [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]
    ),
    Headers = Table.PromoteHeaders(Source, [PromoteAllScalars = true])
in
    Headers

Clique em Next (ou Done) e escolha Anonymous, se solicitado. Em seguida, pressione Ctrl+A para selecionar todas as colunas e clique em Transform → Detect Data Type. Se date ainda estiver como texto, defina o tipo como Date. Renomeie a consulta e clique em Close & Apply.

E quanto à opção Web API?

O bloco Web API em Get data tem apenas um campo de URL, então não consegue enviar o cabeçalho x-api-key. Ele funciona se você adicionar &api_key=YOUR_API_KEY ao final do endereço de exportação, mas sua chave será salva onde quer que o endereço seja registrado. Quando puder, use Web → Advanced.

Etapa 3: Crie seu primeiro visual

Depois que seus dados forem carregados, crie visuais como você faria normalmente no Power BI. Por exemplo, para criar um gráfico de engajamento ao longo do tempo:

1. No painel Visualizations, escolha um gráfico, por exemplo, Line chart.
2. No painel Data, arraste date para X-axis e uma métrica, como engagement, para Y-axis.

Etapa 4: Mantenha seus dados atualizados

1. Publique seu relatório no Power BI Service.
2. No Power BI Service, abra as Settings do modelo semântico.
3. Em Data source credentials, clique em Edit credentials, escolha Anonymous e entre. Sua chave de API permanece no cabeçalho que você definiu na Etapa 2.
4. Em Refresh, ative a atualização agendada e escolha um horário, por exemplo, todos os dias às 6h.

Com days no endereço, cada atualização busca os dados mais recentes dos dias.

Observações importantes

• As datas e os horários das publicações usam o fuso horário de cada publicação, exibido na coluna timezone.
• Os dados diários do perfil incluem alguns campos de lista, como hourly, hashtags e page_fans_country. Eles são importados como texto e é melhor removê-los em Transform Data.
• Uma exportação abrange até 360 dias. Para consultar um período maior, adicione uma consulta para cada período.
• O Power BI exibe totais grandes de forma abreviada, por exemplo, "4 mil". Para ver o número exato, selecione o visual, abra Format visual → Callout value e defina Display units como None.
• Gerar uma nova chave de API desativa a antiga. Atualize a chave no cabeçalho x-api-key da sua fonte de dados, caso contrário, as atualizações deixarão de funcionar.

Solução de problemas

• Chave de API inválida: confira se o cabeçalho x-api-key contém sua chave atual em Settings → Integrations.
• (500): Erro interno do servidor ao conectar: a chave de API não chegou ao Vista Social. Confira se você adicionou o cabeçalho x-api-key em HTTP request header parameters. Se você usou o bloco Web API, adicione &api_key= com sua chave ao endereço.
• Não é permitido acessar este grupo de perfis: confira o ID do grupo da Etapa 1. Você só pode exportar grupos aos quais tem acesso.
• date_from e date_to são obrigatórios, no formato YYYY-MM-DD: adicione days ao endereço ou informe as duas datas no formato YYYY-MM-DD.
• Limite as consultas a 360 dias por vez: reduza o período para 360 dias ou menos.
• Seu plano não oferece integrações: o acesso à API não está ativo na sua conta. Entre em contato com nossa equipe de suporte para adicioná-lo.
• Seu plano não inclui o complemento de integrações premium: o complemento de integrações premium não está ativo na sua conta. Entre em contato com nossa equipe de suporte para adicioná-lo.
• Solicitações demais: as conexões do Power BI têm um limite próprio por minuto. Atualize novamente após um minuto e evite atualizar muitas fontes de dados ao mesmo tempo.

Perguntas frequentes

Q: Preciso fazer login no Power BI para usar isso?

A: Não para criar o relatório no Power BI Desktop. Você precisa de uma conta do Power BI Service para publicar o relatório e atualizá-lo de acordo com uma programação.

Q: Posso exportar mais de um grupo de perfis?

A: Cada fonte de dados abrange um grupo de perfis. Adicione uma para cada grupo sobre o qual você quer criar relatórios.

Q: Os dados são os mesmos dos relatórios do Vista Social?

A: Sim. O Power BI lê os mesmos dados de publicações e perfis diários que o Vista Social usa nos seus relatórios, para que você possa combiná-los e criar gráficos do seu jeito.

Precisa de ajuda?

Entre em contato com nossa equipe de suporte. Teremos prazer em ajudar.

Leitura relacionada:

Como configurar a integração com o Looker Studio para análises

Como configurar a integração com o Tableau para análises

Inscreva-se agora e experimente o Vista Social gratuitamente por 14 dias!