1. Les navigateurs compatibles

iAdvize est une application SaaS riche qui utilise de nombreuses technologies récentes. Elle nécessite donc un navigateur internet performant.

L'utilisation d'iAdvize est optimale avec les deux dernières versions de Google Chrome, Mozilla Firefox, Edge, Opera et Safari. Ces versions sont testées et approuvées par nos équipes techniques.

iAdvize peut fonctionner sur des versions antérieures (le listing est affiché ci-dessous). Cependant nous ne pouvons en garantir le bon fonctionnement de 100% de la solution.
C'est pourquoi nous ne nous engageons pas à apporter des corrections systématiques sur ces versions antérieures.

Aussi, nous vous conseillons de mettre à jour votre navigateur régulièrement.

Note : Si vous ne connaissez pas la version de votre navigateur ou comment le mettre à jour, vous trouverez de l'aide sur cette page : https://updatemybrowser.org/ 

1.1 Côté visiteur (Livechat)

Les navigateurs recommandés sont :

• Edge, les 2 dernières versions
• Firefox, les 2 dernières versions
• Chrome, les 2 dernières versions
• Safari, la dernière version 

Les navigateurs supportés sont : 

• Edge 92 et plus
• Firefox 78 et plus
• Chrome 92 et plus
• Safari 14.1 et plus
• Opera 80 et plus

Les navigateurs supportés sur mobile dépendent de l'OS. Voici les OS supportés : 

• iOS 13 et plus
• Android 8 et plus

1.2 Côté agent/manager/administrateur (Pupitre de discussion, Administration iAdvize, Administration Ibbü,...)

Les navigateurs recommandés sont :

• Edge, les 2 dernières versions
• Firefox, les 2 dernières versions
• Chrome, les 2 dernières versions
• Safari, la dernière version

Les navigateurs supportés sont : 

• Edge 92 et plus
• Firefox 78 et plus
• Chrome 92 et plus
• Safari 14.1 et plus
• Opera 80 et plus

1.3 Les pré-requis nécessaires sur les navigateurs

• Le Javascript doit être activé
• Les Cookies doivent être acceptés
• Le LocalStorage doit être activé
• Les Websockets doivent être acceptés

Note : Si ces configurations ne sont pas respectées, nous ne pouvons garantir le bon fonctionnement de la solution. 

2. Les pré-requis nécessaires sur les résolutions d'écran

Le pupitre de discussion iAdvize est une interface riche en informations.
Afin de bénéficier d'une vision claire des conversations et d'un meilleur accès aux actions et interactions importantes, nous recommandons l'utilisation d'une résolution d'écran élevée.

Note : Les recommandations suivantes sur les résolutions d'écran correspondent aux dimensions de la zone d'affichage (autrement appelé viewport) des navigateurs utilisés pour afficher l'interface iAdvize. Elles ne correspondent pas à la résolution réelle des écrans. En effet, le navigateur ou le système d'exploitation occupent déjà de la place sur l'écran via des barres horizontales ou latérales (barre de raccourcie, barre de recherche, ...).
A noter également que si vous utilisez le pupitre de discussion iAdvize dans une iFrame (par exemple dans un autre logiciel comme Salesforce), nous recommandations s'appliquent sur les dimensions de l'iFrame intégrant l'interface iAdvize.

La résolution optimale recommandée :

• Largeur >= 1920px
• Hauteur >= 930px

La résolution recommandée :

• Largeur >= 1440px
• Hauteur >= 750px

La résolution minimale recommandée :

• Largeur = 1280px
• Hauteur = 650px

Note : La fonctionnalité de partage d'écran du pupitre de discussion se base sur la taille réelle de l’écran du visiteur, mais n’est pas une reproduction 100% fiable de l'expérience visiteur. Pour les mobiles, certaines préférences du visiteur ne sont pas prises en compte, comme le mode sombre et le zoom du visiteur si le site du client n'est pas responsive.

3. Les pré-requis nécessaires sur la configuration réseaux

Nous demandons un accès élargi de manière à prévoir nos évolutions en termes de protocoles et d'infrastructure réseau, et pour vous éviter d'avoir à modifier votre configuration systématiquement à chaque changement.

3.1 Les ports et protocoles

Avant toute chose et afin de garantir les performances et la compatibilité de la solution iAdvize sur votre parc informatique, il est nécessaire que les protocoles TCP et UDP soient ouverts sur votre réseau.

L'ouverture du port 443 (HTTPS) est également indispensable.
A l'heure actuelle, nous utilisons les protocoles de communication suivant :

• HTTPS
• WSS (websocket)

Note : Si ces ports ou protocoles ne sont pas ouverts sur votre réseaux, nous ne pouvons garantir le bon fonctionnement de la solution.

3.2 Les domaines

Note : Nos serveurs, ainsi que ceux de nos partenaires, utilisent des plages d'IP dynamiques. Si vous souhaitez faire des autorisations sur vos filtres réseaux (proxy, firewall, ...), vous devez exclusivement utiliser le nom de domaine et protocoles.

3.2.1 La configuration globale des domaines et protocoles

Il est indispensable de ne pas filtrer les requêtes entre vos opérateurs et nos serveurs en autorisant tout le domaine iadvize : *.iadvize.com.
En appliquant les différents protocoles utilisés par iAdvize, il faut donc ouvrir à minima les protocoles/domaines suivants : 

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

La solution iAdvize utilise également le service Launchdarkly pour procéder à des déploiements progressifs et ainsi permettre l'activation/désactivation de nouvelles fonctionnalités dans des contextes définis. Nous vous invitons donc à ouvrir le domaine suivant : 

• https://*.launchdarkly.com

Le service Mixpanel est également utilisé pour suivre les cas d'usage dans la solution iAdvize, ainsi que pour pousser des messages d'information notamment sur les prochains lancements de nouvelles fonctionnalités. Nous vous invitons donc à ouvrir les domaines suivant : 

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

Note : Vous pouvez tester la compatibilité de votre configuration réseau avec la solution iAdvize depuis cette page : https://networktest.iadvize.com/

3.2.2 La configurations nécessaires pour les canaux Vidéo / Call

Pour les canaux Vidéo et Call, la solution iAdvize s'appuie sur les services proposés par la société Twilio.
L'ouverture du domaine *.twilio.com est donc indispensable si vous utilisez :

• le canal vidéo 
• le canal call, seulement si vos conseillers décrochent et traitent les appels depuis le pupitre iAdvize (sans passer par un téléphone)

De la même manière qu'avec iAdvize, Twilio utilise les protocoles https et wss. Il faut donc ouvrir à les protocoles/domaines suivants : 

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

Note : Vous pouvez tester la compatibilité de votre configuration réseau avec la solution Twilio depuis cette page : https://networktest.twilio.com/

3.2.2.1 Particularité du canal Vidéo

L'utilisation du canal video côté visiteur nécessite que la page soit chargée en HTTPS pour des raisons de sécurité :

En passant par le protocole HTTP, le canal click to video n'est pas fonctionnel.

De plus le canal vidéo s'appuie sur la technologie WebRTC. Votre navigateur donc doit pouvoir supporter WebRTC (peu importe le système d'exploitation utilisé). 
Voici les navigateurs actuellement compatibles avec le canal Video :

• Chrome (les 2 dernières versions)
• Firefox (les 2 dernières versions)
• Opéra (les 2 dernières versions)
• Edge Chromium
• Sur iOS, Safari uniquement (les 2 dernières versions)

Les navigateurs suivant ne seront jamais compatibles avec le click to video :

• Internet Explorer
• Edge Legacy
• Tous les navigateurs ne supportant pas WebRTC
  
  

3.2.3 Configurations nécessaires à l'outil de traduction et de génération des liens riches

Si vous souhaitez utiliser la fonction de traduction automatique du pupitre iAdvize. L'ouverture du domaine https://*.googleapis.com est nécessaire.

Ce domaine fournit également des polices de caractères et des feuilles de style CSS.

4. Les pré-requis nécessaires sur l'implémentation d'iAdvize sur votre site

iAdvize fournit un jeu de tags Javascript à implémenter sur votre site pour installer la solution.
Nous vous invitons à ne pas modifier la structure de ces tags pour éviter toutes erreurs de chargement.
Une fois les tags Javascript iAdvize implémentés, un ensemble de ressources HTML/CSS/Javascript est alors chargé pour afficher les éléments de contacts sur votre site. Comme pour les tags Javascript, nous vous invitons à ne pas changer la nature de ces ressources.

Nous vous recommandons également de ne pas utiliser la structure des ID ou CLASS HTML/CSS des éléments de contacts iAdvize pour d'éventuels développements spécifiques propres à votre site. En effet, notre structure HTML/CSS n'est pas fixe dans le temps et peut évoluer à tout moment.

4.1 Les librairies javascript externes incompatibles

Malgré tous les efforts fournis par iAdvize pour minimiser ce type de conflit, certaines anciennes librairies Javascript tierces, potentiellement utilisées sur votre site, peuvent empêcher le bon chargement du tag iAdvize.
En effet, ces librairies Javascript écrasent la définition de certaines méthodes javascript natives aux navigateurs (ex : Array.prototype.toJSON) empêchant ainsi le tag iAdvize de les utiliser.

Ces incompatibilités peuvent gêner le bon fonctionnement de la solution et nuire à l'expérience utilisateur (les messages d'une conversation peuvent disparaître de la chatbox, le mirroring et le cobrowsing ne fonctionne pas...).

Les librairies Javascript tierces actuellement identifiées comme incompatibles sont : 
- prototype.js : toutes les versions inférieures à 1.7 (http://prototypejs.org/)
- xdomain.js : toutes les versions (https://github.com/jpillora/xdomain)

Note : iAdvize ne s'engage pas à supporter à ces librairies, ni à apporter des corrections nécessaires pour les rendre compatible le tag iAdvize avec votre site.

4.2 Les iFrames

Les iframes sont utilisées pour afficher certains contenus (notifications, chatbox,...).
Il est donc nécessaire de ne pas bloquer les iframes, leur affichage ainsi que leur contenu (HTML, CSS, JS) ainsi que leur affichage.

Si jamais vous cachez par défaut les iframes et leur contenu vous pouvez autoriser l'affichage des iframes et leur contenu utilisées par iAdvize en utilisant ce code CSS : 

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

4.3 La configuration d'une CSP

Une Content Security Policy (CSP) ou stratégie de sécurité du contenu permet d'améliorer la sécurité des sites web en permettant de détecter et réduire certains types d'attaques, dont les attaques XSS (Cross Site Scripting) et les injections de contenu.

Si vous voulez en savoir plus sur les CSP, nous vous invitons à consulter ces pages : 

• https://developer.mozilla.org/fr/docs/Web/HTTP/CSP
• https://developers.google.com/web/fundamentals/security/csp

4.3.1 Exemple de CSP compatible avec la solution iAdvize

Pour s'assurer qu'il n'y a pas de conflit entre votre site et la solution iAdvize, nous vous recommandons d'utiliser la directive "default-src". Cette directive est générique et s'applique aux autres ressources pour lesquelles aucune règle n'est définie("connect-src", "object-src", "script-src", "frame-src", "script-src", "style-src", "font-src", ...).

Pour rappel, iAdvize utilise un domaine et deux protocoles différents : 

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

C'est pourquoi nous vous invitons à ouvrir iAdvize comme tel dans vos CSP : 

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

Si vous ne pouvez pas utiliser la directive "defaut-src", nous vous recommandons d'autoriser iAdvize sur l'ensemble des sous-directives nécessaires au fonctionnement de la plateforme.

Voici un exemple de CSP avec les sous-directives :  

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' https://*.iadvize.com;
style-src 'unsafe-inline' https://*.iadvize.com;

Si vous utilisez le canal Video, nous vous demandons d'ouvrir également la domaine *.twilio sur le protocole WSS. Ce qui donne : 

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

4.3.2 Exemple de configuration avancée de CSP compatible avec la solution iAdvize

Sans le mot clé "Unsafe-inline" 

Il est possible d'appeler les directives 'script-src' et 'style-src' sans le mot-clé 'unsafe-inline'.
Cette action permet de rendre les CSP plus strictes.
Si vous utilisez cette option, l'implémentation des tags iAdvize est à adapter.
Nous vous invitons à appeler les tags iAdvize depuis des scripts externes chargés via l'attribut SRC de la balise SCRIPT.
Exemple : <script defer type="text/javascript" src="https://halc.iadvize.com/iadvize.js?sid=XXXX"></script>

Avec le mot clé "Nonce"

L'attribut nonce vous permet d'établir une "liste blanche" de certains éléments de script et de style en ligne sur votre site. Cela permet d'éviter l'utilisation du mot clé "Unsafe-inline" qui autorise l'ensemble des éléments de script et de style en ligne à s'éxécuter sur votre site.
Ce qui donne  : 

Content-Security-Policy:
connect-src https://*.iadvize.com wss://*.iadvize.com wss://*.twilio.com;
frame-src https://*.iadvize.com;
img-src https://*.iadvize.com;
script-src https://*.iadvize.com 'nonce-5109fc35-8f6c-4e20-b987-d6eed7c73415';
style-src https://*.iadvize.com;

<script type="text/javascript" nonce="5109fc35-8f6c-4e20-b987-d6eed7c73415"> 
// Appel des tags Javascript iAdvize
</script>

Veillez à vous assurer que le hash utilisé pour lister vos ressources autorisées est bien auto généré et non prédictible par un tiers. 

5. Les OS compatibles avec les App mobiles iAdvize 

Avant toute chose, assurez-vous d'avoir téléchargé la dernière version de l'Application Mobile d'iAdvize sur l'App Store (https://itunes.apple.com/fr/app/iadvize/id1052695312?mt=8) ou sur le Play Store (https://play.google.com/store/apps/details?id=com.iadvize.messenger&hl=fr).

L'application mobile iAdvize est compatible avec les OS suivants : 

• Apple iOS 13 et plus
• Android 8 et plus

6. Les pré-requis nécessaires pour l'implémentation du SDK Mobile iAdvize

Le mobile SDK iAdvize décrit sur cette page (https://developers.iadvize.com/documentation/mobile-sdk#mobile-sdk) est compatible avec les OS suivants :

• Apple iOS 13 et plus
• Android 8 et plus 

7. Les pré-requis nécessaires sur la bande passante des utilisateurs de la solution iAdvize

Afin de garantir un confort dans l'utilisation de la plateforme iAdvize, nous recommandons un débit minimum sur la connexion internet des utilisateurs de la solution.

Les valeurs demandées sont par agent et varient en fonction des canaux utilisés :

• Chat/Call/Social :
  
  Download :
  • moyenne : 0.5 Mbps
  • max : 1,5 Mbps
  Upload :
  • moyenne : 0.5 Mbps
  • max : 1,5 Mbps

• Vidéo :
  
  Download :
  • moyenne : 2 Mbps
  • max : 3 Mbps
  Upload :
  • moyenne : 2 Mbps
  • max : 3 Mbps

Note : Nous vous recommandons de prendre les valeurs max comme base de calcul dans votre configuration. Nous vous invitons à multiplier ces valeurs par le nombre d'agents utilisant la solution.

Dans le cas du partage d'écran entre un agent et visiteur, le temps d'affichage des pages dépend du poids du site et de la rapidité de la connexion du visiteur. Il est possible que l'affichage complet des pages prennent plusieurs dizaines de secondes.