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 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 14 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 domaines, protocoles et ports obligatoires pour faire fonctionner iAdvize

Domaine Protocole Port sortant Port entrant Transport Nécessaire sur  Objectif
*.iadvize.com HTTPS/WSS Tous

443

5222 (App mobile)

TCP

Livechat

Pupitre

App mobile

Administration

Service principal

*.twilio.com HTTPS/WSS Tous

3478

443 (Failover)

TCP et UDP

Livechat

Pupitre

App mobile

Service dédié au SMS, voix, video

*.launchdarkly.com HTTPS Tous

443

TCP

Livechat

Pupitre

App mobile

Administration

Service dédié au déploiement de fonctionnalités

 

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.
- Si ces domaines, protocoles et domaines ne sont pas ouverts sur votre réseaux, nous ne pouvons garantir le bon fonctionnement de la solution.
- Vous pouvez tester la compatibilité de votre configuration réseau avec la solution iAdvize depuis cette page : https://networktest.iadvize.com/
- Vous pouvez également tester la compatibilité de votre configuration réseau avec la solution partenaire d'iAdvize Twilio depuis cette page : https://networktest.twilio.com/

 

3.2 Les domaines, protocoles et ports optionnels pour faire fonctionner iAdvize

Domaine Protocole Port sortant Port entrant Transport Nécessaire sur  Objectif
*.auth0.com HTTPS Tous

443

TCP

Livechat

Pupitre

App mobile

Administration

Service d'authentification utilisé pour l'implémentation SAML

*.googleapis.com HTTPS Tous

443 

TCP

Pupitre

App mobile

Service dédié à la traduction automatique des conversations

*.appcue.com HTTPS Tous

443

TCP

Pupitre

App mobile

Administration

Service dédié à l'affichage d'aide à la navigation

*.mixpanel.com HTTPS Tous

443

TCP

Pupitre

App mobile

Administration

Service dédié à l'analyse de l'utilisation d'iAdvize 

 

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.
- Vous pouvez tester la compatibilité de votre configuration réseau avec la solution iAdvize depuis cette page : https://networktest.iadvize.com/

 

3.3 Configurations spécifique à la génération automatique des liens riches depuis le pupitre iAdvize

Si vous souhaitez utiliser la fonction de génération de liens riches depuis le pupitre de discussion, l'ouverture des ip suivantes sur votre site est nécessaire afin d'autoriser nos robots à parcourir les meta données de vos pages : 35.158.241.155, 35.158.90.142, 35.156.32.28

Si l'accès de ces ip est bloqué, la génération des liens riches depuis le pupitre de discussion peut être dégradée, voir non-fonctionnelle.

 

4. Les pré-requis nécessaires pour 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 : 

 

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 15 et plus
  • Android 7 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 15 et plus
  • Android 5 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.