Cet article n’est plus à jour et décrit une implémentation ou une fonctionnalité obsolète. Veuillez consulter la documentation actuelle.
Contexte
Par défaut, les liens générés par ProAbono renvoient vers une version non intégrée du “Portail Client”
(ex : https://mon-app.proabono.com/subscribe-offer/xxxxx).
Mais, si vous renseignez l’URL de la page, votre application intégrant le portail client ProAbono
(ex : https://mon-app.com/ma-page)
alors ProAbono sera en mesure de rediriger directement les clients vers le “Portail Client” intégré
(ex : https://mon-app.com/ma-page?crylk=https%3a%2f%2fmon-app.proabono.com%2fsubscribe-offer%2xxxxx)
Prérequis
Avoir intégré le portail client dans votre service/application.
Si vous ne l’avez pas encore fait : Comment intégrer le “Portail Client” ?.
Procédure
1/ Renseignez l’URL
Depuis le backoffice ProAbono :
- Cliquez sur le bouton « Paramètres » du menu de gauche.
- Cliquez sur « Portail client » dans la section « Pages hébergées »
Renseignez l’URL correspondant à la page qui intègre le “Portail Client” dans le champ URL du portail intégré.
2/ Rajoutez la récupération du lien pour un appel extérieur
Vous devez ajouter un bout de code permettant de charger le portail client non plus depuis une requête à ProAbono, mais depuis les paramètres d’URL.
En effet, lorsque ProAbono construit un lien vers cette page (ex : dans les liens inclus dans les e-mails envoyés par ProAbono), vous trouverez le paramètre d’URL “crylk“ qui contient le lien direct vers le portail client du bon client.
Exemple : https://mon-app.com/ma-page?crylk=https%3a%2f%2fmon-app.via.proabono.com%2fsubscribe-offer%2f0p9i35O1V9_JJRfC0nIeE96ot9e1LcN349
vous n’avez plus qu’à récupérer la donnée : https%3a%2f%2fmon-app.via.proabono.com%2fsubscribe-offer%2f0p9i35O1V9_JJRfC0nIeE96ot9e1LcN349
Le paramètre étant URL encodé, vous devez la décoder : https://mon-app.via.proabono.com/subscribe-offer/0p9i35O1V9_JJRfC0nIeE96ot9e1LcN349
Et enfin l’utiliser en tant que source dans l’IFrame:
<iframe src=”https://mon-app.via.proabono.com/subscribe-offer/0p9i35O1V9_JJRfC0nIeE96ot9e1LcN349” style=”width:100%; height:700px;” frameborder=”0″></iframe>
Si le paramètre crylk n’existe pas ou n’est pas valide, vous pouvez toujours continuer d’utiliser le lien retourné grâce à un appel à l’API Customer.