Whatfix support in beqom
This is an attention message.
This article is relevant only for versions 9.2 and 10 of the beqom Web Application.
Whatfix is a third-party application which enables to create various types of training and help content on web-based applications. This article details the modification performed in the beqom Web Application in order to support Whatfix.
Adding the Whatfix key to beqom v10
In order to configure Whatfix in beqom, the Whatfix key must be entered in the beqom Web Application. This key is provided with the purchase of a Whatfix license.
To provide beqom the Whatfix key, proceed as follows:
- Open the beqom Web Application.
- Go to the (Undefined variable: CompoVariables_WA.Admin).
- In the General section, click Integrations.
- Copy and paste the Whatfix key in the provided field.
- Click Save.
The key is now is now saved into the beqom database.
Whatfix object
From Whatfix, the following object is used to retrieve the required beqom information:
_WHATFIX_
{
releaseVersion: "0r0",
tenantCode: "dev.0r0.master.bqm",
UserUId: "77a80f15-b2b7-4c75-a9d9-1d854069369d",
TenantUID: "4c7c127a-9643-96d0-9d34-023b297586c1"
}
Whatfix cookie
The list of cookies generated when enabling Whatfix are detailed on the Whatfix website, available by clicking here.
In beqom, the most essential cookie to understand is the following:
| Cookie Name | Cookie Duration | Description |
|---|---|---|
| wfx_unq | 100 days | When Whatfix is loaded on a page, a cookie is set to identify the user. This is a random value generated every time we set it. It does not store any personally identifiable information and expires after 100 days. |
Whatfix content security policy
In order to comply with the beqom Content Security Policy, the following exceptions must be added :
- https://whatfix.com and https://cdn.whatfix.com in script-src
- https://whatfix.com and https://cdn.whatfix.com in frame-src
- https://whatfix.com and https://*.whatfix.com in style-src