Motimate: Como você pode integrar a API pública do Motimate ao PowerBI?

Você gostaria de ter sempre painéis e análises ao vivo e atualizados para seus dados do Motimate? Não precisa mais procurar - com a nossa API pública, você pode obter todos os dados da sua API diretamente em ferramentas como o PowerBI da Microsoft. Aqui mostramos a você como configurar isso! ✨

Antes de você continuar, verifique se o MotiSpace tem a API pública ativada. Caso contrário, você pode obter mais informações aqui.

Gerar um token de acesso no Postman

• Abra o Postman e faça uma chamada de API POST para o ponto de extremidade de autenticação para obter um token.
   
• Copie o token gerado para uso temporário no PowerBI.

Agora, use o token de acesso para recuperar dados no PowerBI

• Abra o Power BI e clique em Obter dados --> Selecione Web --> Clique em Conectar.
  
  
   
• Na janela Conexão com a Web, selecione Avançado.
   
• Cole o URL da API da fonte de dados
  , ou seja , https://motimateapp.com/public_api/my_organization
   
• Na seção Cabeçalhos, adicione:
  • Chave: Autorização
  • Valor: "Portador <<Token gerado pelo Postman>>"
    
    
     
• Clique em OK para continuar.

O Power Query Editor será aberto, exibindo os dados recuperados.

Criar uma consulta para gerar tokens dinamicamente

Como os tokens da API pública do Motimate expiram após 24 horas, o PowerBI deve gerar dinamicamente um novo token antes de cada chamada de API para garantir que o token seja sempre válido. Isso pode ser configurado seguindo estas etapas:

• No Power Query Editor, clique em New Source (Nova fonte) --> Blank Query (Consulta em branco).
  
  
  
  
• Quando a consulta em branco for aberta, acesse Advanced Editor.
  
  
  
  
• Digite a seguinte consulta do Power Query M e substitua o texto em negrito por suas próprias credenciais:
  
  

  let
  url ="https://motimateapp.com/public_api/oauth/token",
  headers = [#"Content-Type" = "application/json"],
  postData = Json.FromValue([
  
  client_id="<<your client ID>>", 
  client_secret="<<your client secret>>", 
  grant_type="client_credentials"
  
  ]),
  response = Web.Contents(
  url,
  [
  Headers = headers,
  Content = postData
  ]
  ),
  Data = Json.Document(response),
  access_token = Data[access_token]
  in
  access_token
  
  

• Clique em Done.
  
   
• Verifique as etapas aplicadas para confirmar que um token está sendo gerado:
  
  

Converter a consulta em uma função

• Agora, renomeie a consulta para "GetToken".
  
  
   
• Clique com o botão direito do mouse em GetToken e abra o Advanced Editor
  
  
  
   
• Modifique a consulta adicionando "() =>" no início (antes de "let"). Isso converterá a consulta em uma função.
  
  
   
• Clique em Done.

Substitua o token de acesso codificado com a função

• Abra a consulta do conjunto de dados principal no Advanced Editor.
  
  
   
• Localize o token codificado na seção "Headers" e substitua o próprio token pela função GetToken(). Agora, ele deve ter a seguinte aparência:
  
  Authorization = "Bearer "&GetToken()
  (certifique-se de que você deixe um espaço entre a palavra Bearer e as aspas finais, conforme mostrado acima)
  
  
   
• Clique em Done.
• Por fim, clique em Close (Fechar) & Apply (Aplicar).
  
  

Parabéns! Você configurou um relatório no PowerBI com uma lógica de token dinâmico 🎉

Agora, o PowerBI gerará dinamicamente um token antes de cada chamada de API, garantindo atualizações de dados contínuas sem intervenção manual. Essa abordagem simplifica a recuperação de dados e melhora a automação.