La nouvelle installation In-site présente plusieurs avantages par rapport à l’ancienne installation en iframe :
- Hauteur de page : l’intégration en iframe nécessite que l’iframe ait une hauteur spécifique, ce qui peut entraîner une zone vide sous les pages courtes ou une barre de défilement pour les pages longues.
- CSS : l’intégration in-site héritera du CSS de votre page, ce qui lui permettra de s’intégrer beaucoup plus efficacement dans votre application.
Pré-requis
Vous devez disposer de la dernière version des pages hébergées afin de pouvoir utiliser l’intégration In-site.
Voir ce guide pour vérifier si vous disposez de la bonne version ou non.
Vous devez comprendre ce qu’est un Parcours client.
Étape 1 – Installation du Customer Portal
Vous devez d’abord remplacer votre installation en iframe par la nouvelle installation in-site en suivant la procédure décrite dans la section Integration / Installation / InSite.
Pour retrouver l’installation en iframe dans votre base de code, recherchez un fetch vers l’objet Customer via l’API Live, où le lien rel=hosted-home est utilisé comme source d’un iframe.
Étape 2 – Migration des Parcours client
Votre installation utilise peut-être certains parcours qui s’ouvrent dans un iframe.
Vous pouvez les identifier en vérifiant où l’API Live est utilisée pour récupérer des liens depuis les objets Customer, Subscription, Invoice ou Offer. Le paramètre href de ces liens est utilisé pour ouvrir un iframe.
Si c’est le cas, vous devrez légèrement modifier le processus :
- Conservez la valeur du lien rel= que vous utilisez actuellement ; c’est le parcours que vous souhaitez ouvrir.
- Cet article vous expliquera comment ouvrir un parcours spécifique via l’installation in-site.