Centre d'aide

Explorer notre base de connaissance
article

Pré-requis techniques nécessaires au bon fonctionnement d'iAdvize

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 16 et plus
  • Firefox 52 et plus
  • Chrome 56 et plus
  • Safari 12 et plus
  • Opera 38 et plus
  • Internet Explorer 11*

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

  • iOS 12 et plus
  • Android 8 et plus

Note :
-
Nous supportons encore Internet Explorer 11 néanmoins nous déconseillons fortement son utilisation car ce navigateur n'est pas adapté pour l'utilisation de solution lourde en Javascript comme iAdvize.
A noter également que nous assurons le suivi et la maintenance technique uniquement sur les fonctionnalités critiques dans l'utilisation de la solution iAdvize sur Internet Explorer 11
- Certaines versions de navigateur n'étant plus maintenues par leur propriétaire, elles risquent par conséquent de ne pas prendre en charge les dernières technologies web utilisées par iAdvize. C'est pourquoi cette liste de navigateurs supportés peut être amenée à évoluer.

 

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 16 et plus
  • Firefox 52 et plus
  • Chrome 56 et plus
  • Safari 12 et plus
  • Opera 38 et plus
  • Internet Explorer 11*

Note :
- Nous supportons encore Internet Explorer 11 néanmoins nous déconseillons fortement son utilisation car ce navigateur n'est pas adapté pour l'utilisation de solution lourde en Javascript comme iAdvize.
A noter également que nous assurons le suivi et la maintenance technique uniquement sur les fonctionnalités critiques dans l'utilisation de la solution iAdvize sur Internet Explorer 11
- Certaines versions de navigateur n'étant plus maintenues par leur propriétaire, elles risquent par conséquent de ne pas prendre en charge les dernières technologies web utilisées par iAdvize. C'est pourquoi cette liste de navigateurs supportés peut être amenée à évoluer.

 

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. 
* La navigation privée de Safari désactive le 'localstorage', fonctionnalité nécessaire au bon fonctionnement d'iAdvize. Le chat ne pourra donc pas s'afficher.

 

2. 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.

 

2.1 Les ports et protocoles

L'ouverture des ports 80 (HTTP) et 443 (HTTPS) est indispensable.
A l'heure actuelle, nous utilisons les protocoles :

  • HTTP
  • 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.

 

2.2 Les domaines

Note : Nos serveurs, ainsi que ceux de nos partenaire, 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.

 

2.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 : 

 

2.2.2 La configurations nécessaires pour les canaux vidéo / call

L'ouverture du domaine *.twilio.com est également 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

 

2.2.3 Configurations nécessaires à l'outil de traduction et l'upload de fichiers

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.

Si vous souhaitez utiliser la fonction la fonctionnalité de partage de fichiers disponible depuis le pupitre de discussion, l'ouverture du domaine https://*.amazonaws.com est nécessaire

 

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

 

3.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.

 

3.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;}

 

3.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 : 

 

3.3.1 Exemple de CSP compatibles 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;

 

4. 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 11.2 et plus
  • Android 4.4 (API 19) et plus

 

5. 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 9.3 et plus
  • Android 4.1 Jelly Bean (API 16) et plus 

 

6. 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.