Microapps typically open within the web view of Blink in an iFrame on all devices, allowing users to open links but stay within Blink. This is different than a shortcut in the Hub which always opens in a separate browser window.
We're aware that a number of applications do not support opening in an iFrame on desktop or the web app. Therefore, we developed a prefix URL that will allow the link to open within the app on mobile as well as open in a new browser window on the desktop and web versions.
How to format micro-app URLs in the Hub
For the sake of this example, let's assume that your URL is https://my-wonderful-third-party-app.com?client=mycustomer&weather=beautiful.
This is how the microapp URL will be structured:
Prefix:
https://microapps.joinblink.com/utils/x-frame-options-handler?openDesktopInWindow=true&redirect=The encoded URL for your URL:
To encode a URL use this tool
Paste
https://my-wonderful-third-party-app.com?client=mycustomer&weather=beautifulinto the top box and click ENCODEYou will end up with the encoded URL:
https%3A%2F%2Fmy-wonderful-third-party-app.com%3Fclient%3Dmycustomer%26weather%3Dbeautiful
Join the 2 together to generate your final link:
https://microapps.joinblink.com/utils/x-frame-options-handler?openDesktopInWindow=true&redirect=https%3A%2F%2Fmy-wonderful-third-party-app.com%3Fclient%3Dmycustomer%26weather%3DbeautifulAdd the above as the url for the microapps and you are done 🎉