Motimate: ¿Cómo integrar la API Pública de Motimate en PowerBI?

¿Desearías tener siempre cuadros de mando y análisis actualizados de tus datos Motimate? No busques más: con nuestra API pública, puedes obtener todos los datos de tu API directamente en herramientas como PowerBI de Microsoft. ¡Aquí te mostramos cómo configurarlo! ✨

Antes de continuar, asegúrate de que tu MotiSpace tiene activada la API Pública. Si no, infórmate aquí.

Generar un token de acceso en Postman

• Abre Postman y haz una llamada POST API al endpoint de autenticación para obtener un token.
   
• Copia el token generado para utilizarlo temporalmente en PowerBI.

Ahora utiliza el código de acceso para recuperar datos en PowerBI

• Abre Power BI y haz clic en Obtener datos --> Selecciona Web --> Haz clic en Conectar.
  
  
   
• En la ventana de conexión a la Web, selecciona Avanzado.
   
• Pega la URL de la API de la fuente de datos
  es decir , https://motimateapp.com/public_api/my_organization
   
• En la sección Cabeceras, añade:
  • Clave: Autorización
  • Valor: "Portador <<Token generado a partir de Postman>>"
    
    
     
• Pulsa OK para continuar.

Se abrirá el Editor de Power Query, mostrando los datos recuperados.

Crear una consulta para generar tokens dinámicamente

Dado que los tokens de la API Pública de Motimate caducan a las 24 horas, PowerBI debe generar dinámicamente un nuevo token antes de cada llamada a la API para garantizar que el token sea siempre válido. Puedes configurarlo siguiendo estos pasos:

• En el Editor de Power Query, haz clic en Nueva fuente --> Consulta en blanco.
  
  
  
  
• Una vez que se abra la consulta en blanco, ve al Editor Avanzado .
  
  
  
  
• Introduce la siguiente consulta Power Query M, y sustituye el texto en negrita por tus propias credenciales:
  
  

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

• Haz clic en Hecho.
  
   
• Comprueba los pasos aplicados para confirmar que se está generando un token:
  
  

Convertir la consulta en una función

• Ahora cambia el nombre de la consulta a "ObtenerToken".
  
  
   
• Haz clic con el botón derecho en GetToken y abre el Editor Avanzado
  
  
  
   
• Modifica la consulta añadiendo "() =>" al principio (antes de "let"). Esto convertirá la consulta en una función.
  
  
   
• Haz clic en Hecho.

Sustituye el código de acceso por la función

• Abre la consulta del conjunto de datos principal en el Editor avanzado.
  
  
   
• Busca el token codificado en la sección "Cabeceras" y sustitúyelo por la función GetToken(). Ahora debería tener este aspecto:
  
  Authorization = "Bearer "&GetToken()
  (asegúrate de dejar un espacio entre la palabra Bearer y la comilla final, como se muestra arriba)
  
  
   
• Haz clic en Hecho.
• Por último, haz clic en Cerrar & Aplicar.
  
  

¡Enhorabuena! Has configurado un informe en PowerBI con una lógica de token dinámico 🎉.

Ahora, PowerBI generará dinámicamente un token antes de cada llamada a la API, garantizando actualizaciones de datos sin fisuras y sin intervención manual. Este enfoque simplifica la recuperación de datos y mejora la automatización.