FAQ

This is a compilation of frequently asked questions designed to give customers of our products some important answers quickly on a self-service basis.

ID QUESTION ANSWER

ID	QUESTION	ANSWER
FAQ1	What can I do if the browser does not respond or responds slowly?	You can do anything you would normally do: Click the back button, reload the page, wait, even temporarily go to another page. As long as you do not close the browser (that is, terminate the browser program), co-browsing will continue.
FAQ2	I need a login, where can I get one?	Ask the product owner of your company, if you are working for a company that has an existing Unblu license. Otherwise, you can register at: https://www.unblu.com/en/products - please note that the email address will be your username - do not use info@yourcompany.com for example.
FAQ3	Can I add the snippet dynamically ?	Yes, if you can manage adding the snippet correctly.
FAQ4	Why does starter.js return 301?	The "301 Moved Permanently" code is normal. While the `starter.js` request itself cannot (must not) be cached, it redirects to a path and content which is Unblu release-specific and contains maximum cache headers. As a result, the browser always has to request `starter.js` for each page. However, the resulting script only has to be requested once per customer visit.The redirected script is then stored in the browser cache and only downloaded again from the server when an update on the cloud has been performed.
FAQ5	How can I control the buttons (activation element)?	State-dependent buttons are currently only supported by custom UI implementations based on the API. With the API you can define what buttons you would like to display, and consequently define the states. Details can be found in the documentation of the Unblu JavaScript API.
FAQ6	Is it possible to set the position of the control UI by custom coordinates?	Yes. You will find this and more in the Cloud Admin Application.
FAQ7	Is IE8 supported by Unblu?	No, Internet Explorer support starts at version 10.
FAQ8	Why can I, as a co-visitor (agent), not see a pdf document in my browser?	Co-browsing a pdf file requires Universal co-browsing. + + The pdf can be co-browsed in a Universal session, or in a combination of Universal and Embedded, (by first starting in Embedded then switching to a Universal session). + + For example, if the visitor, during an Embedded session, clicks a link leading to a pdf file, the file will either download or open in the visitor’s browser (depending on the browser the visitor is using). In this case nothing will happen on the agent (co-visitor) side. + + Downloading a file requires file sharing to be enabled. + + Note: File sharing means that any co-browsing participant can upload a file which can then be downloaded by all other participants. + + To download a file: + + In the Cloud: You must enable file sharing. + + On premises: You must have either file sharing enabled or you must use the Unblu filter. + + Note: When using the filter, in an On-premises installation, you can download pdf files without enabling file sharing. + + To enable file sharing see Enable Or Disable File Sharing
FAQ9	Timeout session is short. It would be nice to be able to get it parameterized.	Unblu has multiple timeouts: + a) One timeout defines the duration that a PIN can be used + b) Another timeout defines how long a co-browsing session is active when there is no action by any user.
FAQ10	The window asking for a PIN should also contain a field for the customer to enter a phone number that can be used to call him back.	If you would like to offer your customers a callback service you can implement your own user interface and control Unblu by using the API.
FAQ11	Can activity be logged to the statistics on Google Analytics?	Yes, Google Analytics and other customer specific logging can be implemented by using the API.
FAQ12	Is it possible to customize the PIN dialog?	Only text and color can be customized. However, there is an option to build a custom user interface based on the API according to the design of your choice.
FAQ13	Why does my browser indicate a secure/insecure warning?	This should not be the case. Please contact support@unblu.com to clarify. + Please take into consideration that, by default, images, CSS and other resources are transferred by the collaboration server from the origin server to the co-visitor. For this reason the server must have access to these resources. This is needed because our desk (co-visitor) is accessed through HTTPS, thus mixing HTTPS and HTTP causes the co-visitor browser to indicate a secure/insecure warning.
FAQ14	How can I see all content of the page on the co-visitor browser when there is a secure/insecure warning?	This should not be the case. Please contact support@unblu.com to clarify. It is recommended to avoid mixed content. But if mixed content is used, the following applies: + IE8: On IE8 you get a popup warning asking you if only the secure resources of the page should be loaded. You can just click “NO”. + IE9: At the bottom of your browser you get a warning asking you whether to show all the content of the page. You should click on “Show All Content”. + Chrome: In the address bar you will see a shield icon on which you can click and then click on “Load anyway”.
FAQ15	Is it possible to configure Unblu to use a specific language? + Is the language which Unblu displays only HTTP header language accepted or is there another way to configure this?	Unblu uses the default behavior of the browser language and English as a fallback. If you want to support different regions and languages that differ from the browser language, e.g., when a user on an English-adjusted browser visits a German website and you want it to be in German. See Selecting the Language.
FAQ16	What languages are supported by Unblu?	There are many languages supported out of the box, e.g., English, German, Italian, French. If you want to support a languages that is not shipping out of the box yet, you can provide us the texts available so that we can configure the language for you.
FAQ17	Is there a request to the Unblu JavaScript for every page view?	Universal does not require the snippet on page load whereas Embedded co-browsing always requires the snippet on all pages. Normally, the script will load one time per visit; meaning that Unblu uses a strong caching mechanism, ensuring that revisited pages will load from cache.
FAQ18	Is it correct that in 'View-and-Point' mode, the co-visitor’s clicks are visualized for the visitor?	Yes, the co-visitor cannot navigate or fill-in any form. However, clicks are visualized with little circles in the customer browser. In addition, the co-visitor can use the "Marker" to highlight available elements (input, pictures, links) for the customer.
FAQ19	A message is displayed after the co-browsing session is terminated on both sides. Is it possible to customize this message (in appearance and text) to match customer requirements?	The message is displayed only on the client side. The texts are easily configurable by properties. The appearance can only be customized by using the API.
FAQ20	Is it possible to have a confirmation dialog ("Do you really want to quit") before the co-browsing session is terminated?	During a 'join' (Embedded) session, both parties are able to terminate the session. During a 'show' (Universal) session only the agent can terminate the session.
FAQ21	Is placement, text and design (color) of the tab possible?	Yes, there are some parameters to position the tab. To customize the look beyond the basic configuration, the API can be used.
FAQ22	What happens if someone just tries out codes without being invited to a co-browsing session?	It is very unlikely to guess the PIN code by trial and error. (See Guessing the PIN Code In addition, the codes are only valid for a limited time and the number of digits and types of characters can be adjusted.
FAQ23	Is it possible to reuse a code?	No. The PIN can be used only once.
FAQ24	The PIN code is only valid for a certain time. Is it possible to invalidate it, or to configure the timeout?	Yes, it is configurable for the on-premises version of Embedded. For Universal, it is preset.
FAQ25	What are the hardware requirements to run the collaboration server with in-house hosting?	See On-Premises requirements.
FAQ26	How does Unblu scale?	Unblu can scale for about 2500 agents (based on 250 concurrent sessions) on a single multi-core server. Note that scaling becomes less linear when large files are shared. The way your system is set up can have a big impact. For example, Universal co-browsing is powered by Docker and scales differently from embedded co-browsing and 'chat'. You should consult with your DB Admin to assess your needs. If you have any questions about scaling, do not hesitate to contact support@unblu.com.
FAQ27	Can I use Unblu in clustered environments?	Yes. See Cluster Hardware Requirements.
FAQ28	The message 'Page too Complex' is displaying. How do I fix this?	This may be a browser problem or a hardware deficiency or, more likely, it is because the DOM has 'too many' nodes. See DOM Capturing for more.

FAQ1

What can I do if the browser does not respond or responds slowly?

You can do anything you would normally do: Click the back button, reload the page, wait, even temporarily go to another page. As long as you do not close the browser (that is, terminate the browser program), co-browsing will continue.

FAQ2

I need a login, where can I get one?

Ask the product owner of your company, if you are working for a company that has an existing Unblu license. Otherwise, you can register at: https://www.unblu.com/en/products - please note that the email address will be your username - do not use info@yourcompany.com for example.

FAQ3

Can I add the snippet dynamically ?

Yes, if you can manage adding the snippet correctly.

FAQ4

Why does starter.js return 301?

The "301 Moved Permanently" code is normal. While the starter.js request itself cannot (must not) be cached, it redirects to a path and content which is Unblu release-specific and contains maximum cache headers. As a result, the browser always has to request starter.js for each page. However, the resulting script only has to be requested once per customer visit.The redirected script is then stored in the browser cache and only downloaded again from the server when an update on the cloud has been performed.

FAQ5

How can I control the buttons (activation element)?

State-dependent buttons are currently only supported by custom UI implementations based on the API. With the API you can define what buttons you would like to display, and consequently define the states. Details can be found in the documentation of the Unblu JavaScript API.

FAQ6

Is it possible to set the position of the control UI by custom coordinates?

Yes. You will find this and more in the Cloud Admin Application.

FAQ7

Is IE8 supported by Unblu?

No, Internet Explorer support starts at version 10.

FAQ8

Why can I, as a co-visitor (agent), not see a pdf document in my browser?

Co-browsing a pdf file requires Universal co-browsing. + + The pdf can be co-browsed in a Universal session, or in a combination of Universal and Embedded, (by first starting in Embedded then switching to a Universal session). + + For example, if the visitor, during an Embedded session, clicks a link leading to a pdf file, the file will either download or open in the visitor’s browser (depending on the browser the visitor is using). In this case nothing will happen on the agent (co-visitor) side. + + Downloading a file requires file sharing to be enabled. + + Note: File sharing means that any co-browsing participant can upload a file which can then be downloaded by all other participants. + + To download a file: + + In the Cloud: You must enable file sharing. + + On premises: You must have either file sharing enabled or you must use the Unblu filter. + + Note: When using the filter, in an On-premises installation, you can download pdf files without enabling file sharing. + + To enable file sharing see Enable Or Disable File Sharing

FAQ9

Timeout session is short. It would be nice to be able to get it parameterized.

Unblu has multiple timeouts: + a) One timeout defines the duration that a PIN can be used + b) Another timeout defines how long a co-browsing session is active when there is no action by any user.

FAQ10

The window asking for a PIN should also contain a field for the customer to enter a phone number that can be used to call him back.

If you would like to offer your customers a callback service you can implement your own user interface and control Unblu by using the API.

FAQ11

Can activity be logged to the statistics on Google Analytics?

Yes, Google Analytics and other customer specific logging can be implemented by using the API.

FAQ12

Is it possible to customize the PIN dialog?

Only text and color can be customized. However, there is an option to build a custom user interface based on the API according to the design of your choice.

FAQ13

Why does my browser indicate a secure/insecure warning?

This should not be the case. Please contact support@unblu.com to clarify. + Please take into consideration that, by default, images, CSS and other resources are transferred by the collaboration server from the origin server to the co-visitor. For this reason the server must have access to these resources. This is needed because our desk (co-visitor) is accessed through HTTPS, thus mixing HTTPS and HTTP causes the co-visitor browser to indicate a secure/insecure warning.

FAQ14

How can I see all content of the page on the co-visitor browser when there is a secure/insecure warning?

This should not be the case. Please contact support@unblu.com to clarify. It is recommended to avoid mixed content. But if mixed content is used, the following applies: + IE8: On IE8 you get a popup warning asking you if only the secure resources of the page should be loaded. You can just click “NO”. + IE9: At the bottom of your browser you get a warning asking you whether to show all the content of the page. You should click on “Show All Content”. + Chrome: In the address bar you will see a shield icon on which you can click and then click on “Load anyway”.

FAQ15

Is it possible to configure Unblu to use a specific language? + Is the language which Unblu displays only HTTP header language accepted or is there another way to configure this?

Unblu uses the default behavior of the browser language and English as a fallback. If you want to support different regions and languages that differ from the browser language, e.g., when a user on an English-adjusted browser visits a German website and you want it to be in German. See Selecting the Language.

FAQ16

What languages are supported by Unblu?

There are many languages supported out of the box, e.g., English, German, Italian, French. If you want to support a languages that is not shipping out of the box yet, you can provide us the texts available so that we can configure the language for you.

FAQ17

Is there a request to the Unblu JavaScript for every page view?

Universal does not require the snippet on page load whereas Embedded co-browsing always requires the snippet on all pages. Normally, the script will load one time per visit; meaning that Unblu uses a strong caching mechanism, ensuring that revisited pages will load from cache.

FAQ18

Is it correct that in 'View-and-Point' mode, the co-visitor’s clicks are visualized for the visitor?

Yes, the co-visitor cannot navigate or fill-in any form. However, clicks are visualized with little circles in the customer browser. In addition, the co-visitor can use the "Marker" to highlight available elements (input, pictures, links) for the customer.

FAQ19

A message is displayed after the co-browsing session is terminated on both sides. Is it possible to customize this message (in appearance and text) to match customer requirements?

The message is displayed only on the client side. The texts are easily configurable by properties. The appearance can only be customized by using the API.

FAQ20

Is it possible to have a confirmation dialog ("Do you really want to quit") before the co-browsing session is terminated?

During a 'join' (Embedded) session, both parties are able to terminate the session. During a 'show' (Universal) session only the agent can terminate the session.

FAQ21

Is placement, text and design (color) of the tab possible?

Yes, there are some parameters to position the tab. To customize the look beyond the basic configuration, the API can be used.

FAQ22

What happens if someone just tries out codes without being invited to a co-browsing session?

It is very unlikely to guess the PIN code by trial and error. (See Guessing the PIN Code In addition, the codes are only valid for a limited time and the number of digits and types of characters can be adjusted.

FAQ23

Is it possible to reuse a code?

No. The PIN can be used only once.

FAQ24

The PIN code is only valid for a certain time. Is it possible to invalidate it, or to configure the timeout?

Yes, it is configurable for the on-premises version of Embedded. For Universal, it is preset.

FAQ25

What are the hardware requirements to run the collaboration server with in-house hosting?

See On-Premises requirements.

FAQ26

How does Unblu scale?

Unblu can scale for about 2500 agents (based on 250 concurrent sessions) on a single multi-core server. Note that scaling becomes less linear when large files are shared. The way your system is set up can have a big impact. For example, Universal co-browsing is powered by Docker and scales differently from embedded co-browsing and 'chat'. You should consult with your DB Admin to assess your needs. If you have any questions about scaling, do not hesitate to contact support@unblu.com.

FAQ27

Can I use Unblu in clustered environments?

Yes. See Cluster Hardware Requirements.

FAQ28

The message 'Page too Complex' is displaying. How do I fix this?

This may be a browser problem or a hardware deficiency or, more likely, it is because the DOM has 'too many' nodes. See DOM Capturing for more.