Technical requirements needed for iAdvize – Help Center iAdvize

Generally, iAdvize is best with the two last versions of Google Chrome, Mozilla Firefox, Edge and Safari to the extent that such versions have been tested and approved by our technical team.

iAdvize can work on older versions (details below) but they are not officially supported anymore. That is why we do not undertake to make systematically fixes on these older versions.

Also, we advise you to update your browser regularly.

Note : If you do not know your browser’s version or how to update it, take a look at this page : https://updatemybrowser.org/

1.1 Visitor side (Livechat)

Recommended browsers:

Edge, the last two versions
Firefox, the last two versions
Chrome, the last two versions
Safari, the last version

Supported browsers:

Edge 16+
Firefox 52+
Chrome 56+
Safari 12+
Opera 38+
Internet Explorer 11*

Supported browsers on mobile depend of the OS version. Here the supported OS:

iOS 10+
Android 8+

Note :
- We still support Internet Explorer 11 but we strongly advise not to use . This outdated browser have slow performance with heavy Javascript solution like iAdvize.
It should also be noted that we ensure the follow-up and the technical maintenance only for critical functionalities in the use of the iAdvize solution on Internet Explorer 11.
- Some browser versions are no longer maintained by their owners, so they may not support the latest web technologies used by iAdvize. This is why this list of supported browsers may evolve.

1.2 Back office side (Conversation panel, iAdvize Administration, Ibbü Administration, ...)

Recommended browsers:

Edge, the last two versions
Firefox, the last two versions
Chrome, the last two versions
Safari, last version

Supported browsers:

Edge 16+
Firefox 52+
Chrome 56+
Safari 12+
Opera 38+
Internet Explorer 11*

1.3 Browsers required configurations

Javascript must be enabled
Cookies must be accepted
LocalStorage * must be enabled
Websockets must be accepted

Note : If this configuration is not respected, we cannot guarantee that iAdvize will work properly.
* Note also that Safari's private browsing disables 'localstorage', which is necessary for the proper functioning of iAdvize. Chat can not be displayed.

2. Network and domains requirement

We require broadened access to provide for our future developments in terms of protocols and network infrastructure, and to avoid you having to systematically change your configuration at each change on our side.

2.1 Ports and Protocol

Opening ports 80 and 443 is mandatoy (ideally on all protocols). Please be sure these protocols are open on your network.

HTTP
HTTPS
WSS (websocket)

Note : If these ports or protocols are not open on your network, we cannot guarantee that iAdvize will work properly.

2.2 Domains

Note : We are using dynamic IP ranges. Please refer to domain name exclusively if you need to apply filtering.

2.2.1 Global configuration on domains and protocols

It is essential not to filter requests between your agents and our servers.
We therefore ask you a bypass *.iadvize.com on your network equipment (proxy, firewall, etc.).
Be sure to open this domain on all protocols used by iAdvize solution :

https://*.iadvize.com
wss://*.iadvize.com

iAdvize solution is using Launchdarkly in order to proceed to continuous deployments, helping us to deploy new features in specific contexts. Therefor we invite you to bypass this domain:

https://*.launchdarkly.com

Mixpanel solution is used to follow usages of iAdvize solution. Moreover this service display informal messages of next major features rollouts. Therefor we invite you to bypass these domains:

https://*.mixpanel.com
https://*.mxpnl.com

2.2.2 Configuration mandatory for video & call channels

Bypassing *.twilio.com is also mandatory if you are using:

the video channel
the call channel, only if your agents are answering the calls from the iAdvize discussion panel (without using a phone)

Twilio is also using https and wss protocols, so please be also sure to open the domain *.twilio.com on all protocols used by the Twilio solution:

https://*.twilio.com
wss://*.twilio.com

2.2.3 Configuration mandatory for the automatic translation tool and the file upload

https://*.googleapis.com : Bypassing this domain is necessary if you need to use the automatic translation feature on the conversation panel. This domain also provides font and css sheet.
https://*.amazonaws.com : Bypassing this domain is also necessary if you need to use the send a file feature on the conversation panel.

Note : If these domains are not whitelisted, the look of the chatbox and notification may not display as you see in the notification and chatbox builder. Moreover, your agents will be able to send a file to visitors.

3. iAdvize implémentation requirements on your website

3.1 Compatibility with third-party Javascript librairies

Despite all the iAdvize's efforts to minimise this type of conflict, certain old third-party libraries potentially used on your site can prevent iAdvize to work well.
These libraries override the definition of certain javascript native methods (e.g. Array.prototype.toJSON) used by iAdvize solution.

As a result, some random Javascript errors can occur (like "parse error"), provoking for example :
- no iAdvize notifications displayed on your website
- missing messages between visitors and agents,
- a blank page displayed in the background instead of the page viewed by the visitor
- ...

These libraries have been identified as not compatible with iAdvize :
- prototype.js : all versions less than 1.7 (http://prototypejs.org/)
- xdomain.js : toutes les version (https://github.com/jpillora/xdomain)

Note: If you use this king of old Javascript libraries, we cannot guarantee that iAdvize will work properly. That is why we do not undertake to make systematically fixes on these libraries.

3.2 iFrames

iframes are used to display certain contents (notifications, chatbox,...).
Therefore, it is necessary not to block iframes and their content (HTML, CSS, JS).

If your internal policy is to hide iframes and their content, you can make an exception for iAdvize iframes by using this CSS:

iframe[name*='iAdvize'],iframe[title*='iAdvize']{display:block;}

3.3 CSP configuration

Content Security Policy (CSP) is a security mechanism that helps protect against content injection attacks, such as Cross Site Scripting (XSS).

If you want to know more about CSP, you can check these articles :

3.3.1 CSP configuration compatible with iAdvize

To ensure no breaking in the iAdvize working on your website, we recommend you to update the "default-src" directive (the "default-src" serving as a fallback for all the other directives), and not each one of the CSP directives ("connect-src", "object-src", "script-src", "frame-src", "script-src", "style-src", "font-src", ...).

iAdvize use two different web protocols:

HTTPS : https://*.iadvize.com
WSS : wss://*.iadvize.com

Therefore you will to bypass these two protocols.

Here an example:

Content-Security-Policy:
default-src 'unsafe-inline' 'unsafe-eval' https://*.iadvize.com wss://*.iadvize.com;

If you really can't rely on the "default-src" directive, we would recommend you to specify each one with a wildcard.

Here an example:

Content-Security-Policy:
connect-src https://*.iadvize.com wss://*.iadvize.com;
frame-src https://*.iadvize.com;
img-src https://*.iadvize.com;
script-src 'unsafe-inline' 'unsafe-eval' https://*.iadvize.com;
style-src 'unsafe-inline' 'unsafe-eval' https://*.iadvize.com;

4. Compatible OS with iAdvize mobile app

First things first, please download the lastest mobile version app on the App Store or on the Play Store according to the operating system you are using.

The iAdvize mobile application is compatible with the following OS:

Apple iOS 11.2 and more
Android 4.4 (API 19) and more

5. Technical requirements for iAdvize mobile SDK integration

The iAdvize mobile SDK describe in this page (https://developers.iadvize.com/documentation/mobile-sdk#mobile-sdk) is compatible with these following OS:

Apple iOS 9.3 and more
Android 4.1 Jelly Bean (API 16) and more

6. Bandwidth requirement for iAdvize users

In order to guarantee a smooth use of the iAdvize platform, we advise you a minimum bandwidth on agents internet connection.

These values are for one agent and depend of the channel used.

Chat/Call/Social :

Download :
- average : 0.5 Mbps
- max : 1,5 Mbps
Upload :
- average : 0.5 Mbps
- max : 1,5 Mbps

Video :

Download :
- average : 2 Mbps
- max : 3 Mbps
Upload :
- average : 2 Mbps
- max : 3 Mbps

Note : We advise you to use the maximal value in your network configuration and then multiply it with the number of agents using the iAdvize solution.

Regarding the mirroring/cobrowsing case between agents and visitors, the display time of visitors pages may vary from few second to dozens of secondes due to the websites weight and visitor internet speed connection.

Summary

1. Browsers supported