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 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,...)
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. Le pupitre les utilise sans solution de repli pour échanger les messages en temps réel, se reconnecter après une coupure et afficher la présence des conseillers : si votre réseau les bloque, le pupitre ne peut pas se connecter.
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 raccourcis, 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), nos 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éseau
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 source | Port de destination | 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é à la voix |
| *.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 ports ne sont pas ouverts sur votre réseau, 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 source | Port de destination | 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 |
| *.screeb.app | 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écifiques à 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, voire 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.
Si votre site utilise prototype.js dans une version inférieure à 1.7 et a été créé dans iAdvize après le 17 juillet 2019, le tag iAdvize ne se charge pas : aucune notification ni chatbox ne s'affiche. Dans les autres cas, ces librairies peuvent provoquer des erreurs Javascript aléatoires : notifications non affichées, messages qui disparaissent de la chatbox, page blanche à la place de la page du visiteur, mirroring et cobrowsing qui ne fonctionnent 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 les corrections nécessaires pour rendre le tag iAdvize compatible 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).
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 "default-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.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'exé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 7.0 (API 24) 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
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 prend plusieurs dizaines de secondes.