Cette installation va générer le Portail Client directement dans votre application web.
Étape 1
Sur les pages où vous souhaitez afficher le Portail Client, copiez-collez ce code dans la balise <head>.
<script type="text/javascript" src="https://portal.proabono.com/Get/portal.js"></script>
Étape 2
Placez une balise <div> dans la page à l’endroit où vous souhaitez que le Portail Client soit généré.
<div id="proabono_portal">loading...</div>
Son contenu sera écrasé après le chargement.
Étape 3
Chargez le Portail Client avec le code ci-dessous et observez le résultat.
Le paramètre customer_ref doit être déduit de l’identifiant de vos utilisateurs. La valeur ci-dessous n’est donnée qu’à titre d’exemple.
Cet article vous apportera plus de détails sur les paramètres d’ouverture.
<script type="text/javascript">
ProAbonoPortal.open({
business_id: 42,
segment_ref: "demo-eur",
customer_ref: "cust-42",
customer_name: "John Doe", // optionnel
customer_lang: "en", // optionnel
});
</script>
| Paramètres | Descriptions |
| business_id | Identifiant de votre environnement ProAbono. |
| segment_ref | Le segment dans lequel votre client est stocké. Lorsque votre activité se développe, vous pouvez avoir besoin de segments supplémentaires. Pour le moment, utilisez simplement celui de l’exemple ci-dessus. |
| customer_ref | Référence unique du client. Recommandé : utiliser votre identifiant interne avec un préfixe (par exemple : cust-42). Cela permet d’éviter de stocker un champ supplémentaire en base de données et de déduire la ReferenceCustomer à partir de vos données existantes. |
| customer_name | Nom interne du client. Jamais affiché au client. |
| customer_lang | (optionnel) langue du client |
Étape 4 (optionnel pour les tests)
Avant de passer en production, vous devez sécuriser les pages hébergées afin d’éviter toute usurpation d’identité.
Pour cela, vous devez générer un hash de sécurité pour l’utilisateur connecté, puis l’ajouter à l’appel window.ProAbono.start(...).
<script type="text/javascript">
ProAbonoPortal.open({
...
hash: "29d8bf6e5edadfgfd2dccac0d60bd3377a2331e314e752d6bf0731e7c3c22b"
});
</script>
Comment générer le hash de sécurité
Le hash de sécurité d’un client est généré à l’aide de HMAC-256, avec une clé secrète et la référence du client.
Récupérez le code permettant de générer le hash en sélectionnant le langage côté serveur que vous utilisez.