Integrations & Technology
Integration Overview
The HqO platform makes adding integrations easy. While HqO strives to provide industry-leading software to create your own experience and operate your space, we know that our customers have different needs and want to add capabilities to the HqO platform that aren’t provided by HqO software.
HqO Supported Integration Types
Webview (URL) Based
The webview (URL) based integration allows you to link from the HqO app to a third-party web page while keeping the end-user in the HqO app.
Key Features:
Supports web applications that support both a desktop and mobile web experience
Examples:
Expected Functionality
The user is brought to the linked page within the in-app browser
Information on the HqO in-app browser can be found here.
Deep Link
Deep links gives the ability to link from the HqO app to a 3rd party app (i.e. Instagram, Revel, Handlebikes)
Key Features:
Links end users to the apps they’re already using
Examples:
These examples show native applications that HqO can deep link to from our native app.
Expected Functionality
If the app is installed on the device, the user is brought directly to the app upon clicking the post CTA.
If the app is not installed, the user is brought to the app store to download it.
SSO (SAML) Link Out / IdP Initiated SSO
SSO (SAML) Link Out / IdP Initiated SSO enables seamless integration with third-party web applications that support a responsive web experience. With SSO (SAML) Link Out / IdP Initiated SSO integrations, HqO acts as the Identity Provider to authenticate and provide user context, removing the need for the user to log in separately and navigate to the page in the third-party application to take action.
Key Features:
Automatic user authentication in the 3rd party application
Examples:
Angus
Datawatch Visitor Registration & Resource Booking
Expected Functionality
3rd party application requires an existing user account
If the user has an account with the 3rd party, the user is brought directly into the 3rd party web application in a logged-in state.
If the user does not have an account, they cannot access the 3rd party experience.
3rd party will auto-create a user account
If the user has an account with the 3rd party, the user is brought directly into the 3rd party review experience in a logged-in state.
If the user does not have an account, they are prompted to accept the 3rd party terms and conditions before being brought directly into the 3rd party web application in a logged-in state.
If the user does not have an account, the user is brought directly into the 3rd party web application in a logged-in state.
SSO (SAML) Link Out / IdP Initiated SSO integrations typically take 2 to 4 weeks to set up, test, and enable in the HqO platform.
SSO (SAML) Link Out / IdP Initiated SSO Requirements
The 3rd party provider must have a web application
The web application must support a mobile or response web experience
The 3rd party provider must support IdP Initiated SSO or be capable of implementing support for SAML SSO
Information on the HqO in-app browser can be found here.
There is a setup and maintenance fee to set up an SSO (SAML) Link Out / IdP Initiated SSO integration.
Native
Native integrations link from the HqO app to a native pre-installed app for text messaging, phone calls, or email.
Examples:
sms:1234567890
Expected Functionality
SMS
If the phone number is in message history, the user is brought to the text conversation within the messaging app.
If the phone number is not in the message history, the user is brought to the messages app with a new message ready to compose, and the phone number is entered.
Tel
The user is prompted to call the phone number.
Mailto
User is brought to their default email app with the TO: field populated.
Programmatic Integrations
The HqO platform supports programmatic integrations through APIs and SDKs. These integrations are available through an Enterprise Development engagement and require a feasibility assessment.
To add a new integration through Enterprise Development, please get in touch with your HqO Account Manager for more information.