Vous pouvez installer Fin Messenger sur votre site Salesforce en utilisant un package préconstruit. Une fois installé, vous configurerez les paramètres personnalisés, mettrez à jour votre politique de sécurité du contenu (CSP) et connecterez Fin en toute sécurité à votre environnement Salesforce.
Installer Fin Messenger sur une page Salesforce
1. Installer le package dans Salesforce
Pour installer Fin Messenger sur une page Salesforce, nous avons créé un package que vous pouvez installer, qui crée simplement une définition de paramètre personnalisé.
Vous devrez installer le package dans votre environnement Salesforce avant de suivre les étapes ci-dessous.
Ou
2. Configurer les paramètres de Fin Messenger dans Salesforce
Après l'installation, vous verrez un nouveau paramètre personnalisé appelé Fin Messenger Settings. Vous l'utiliserez pour connecter Salesforce avec vos identifiants d'application Fin.
A) Accéder aux Fin Messenger Settings
Dans Salesforce :
Allez dans Setup > Custom Settings.
Ouvrez Fin Messenger Settings.
Cliquez sur Manage.
Cliquez sur New pour définir la Default Organization Level Value
B) Configurer le champ personnalisé App ID
Dans Fin, allez dans Settings > General pour trouver votre App ID.
Dans Salesforce, ouvrez Fin Messenger Settings.
Saisissez votre App ID dans le champ personnalisé App ID.
C) Configurer le champ personnalisé JWT Secret Key
Dans Fin, allez dans Settings > Fin Messenger pour trouver votre JWT Secret Key.
Dans Salesforce, ouvrez Fin Messenger Settings.
Saisissez votre JWT Secret Key dans le champ personnalisé JWT Secret Key.
3. Configurer la politique de sécurité du contenu (CSP)
Une fois vos paramètres Fin Messenger configurés, mettez en place les règles CSP requises pour permettre à Fin Messenger de se charger en toute sécurité.
A) Accéder à la sécurité et confidentialité du site
Dans Salesforce :
Allez dans Setup > Sites > (votre site) Builder.
Ouvrez Settings > Security & Privacy.
B) Configurer le niveau de sécurité
Réglez le Security Level sur Relaxed CSP. Cela vous permet d'ajouter le script requis dans le balisage head du site.
C) Configurer les sites de confiance pour les scripts
Ajoutez ces sites de confiance :
https://widget.intercom.io – charge le messenger
https://js.intercomcdn.com – charge des ressources supplémentaires
D) Configurer les URLs de confiance
Allez dans Setup > Trusted URLs.
Ajoutez les URLs de cet article avec les directives CSP appropriées.
Réglez le CSP Context sur All ou Experience Builder Sites.
4. Ajoutez le script Fin Messenger à votre portail Salesforce
Ajoutez le JavaScript suivant dans le Head Markup de votre site.
Ce script écoute l'événement finMessengerData, puis charge dynamiquement Fin Messenger avec le JWT encodé et l'App ID.
<script>
window.addEventListener('finMessengerData', function (e) {
const finMessengerData = e.detail;
// Do not boot if no JWT
if (finMessengerData.jwt == null) {
return;
}
window.intercomSettings = {
app_id: finMessengerData.appId,
intercom_user_jwt: finMessengerData.jwt,
api_base: "https://api-iam.intercom.io"
};
loadIntercom(finMessengerData.appId);
});
function loadIntercom(appId){var w=window;var ic=w.Intercom;if(typeof ic==="function"){ic('reattach_activator');ic('update',w.intercomSettings);}else{var d=document;var i=function(){i.c(arguments);};i.q=[];i.c=function(args){i.q.push(args);};w.Intercom=i;var l=function(){var s=d.createElement('script');s.type='text/javascript';s.async=true;s.src='https://widget.intercom.io/widget/'+appId;var x=d.getElementsByTagName('script')[0];x.parentNode.insertBefore(s,x);};if(d.readyState==='complete'){l();}else{if(w.attachEvent){w.attachEvent('onload',l);}else{w.addEventListener('load',l,false);}}}}
</script>
Important : La valeur api_base devra être mise à jour selon votre localisation régionale, consultez le tableau ci-dessous pour choisir la bonne valeur :
Localisation régionale | Base API à définir |
US |
|
EU |
|
Australie |
|
5. Ajoutez le composant Fin Messenger à votre page Salesforce
Dans Salesforce :
Allez dans Setup > Sites > (votre site) Builder.
Faites glisser et déposez le composant Fin Messenger sur la page de votre portail pour le déployer.
6. Modifiez la classe Apex pour contrôler les données utilisateur envoyées à Fin
Dans Salesforce :
Allez dans Setup > Apex Classes > JwtGenerator.
Cliquez sur Edit.
Vous pouvez :
Mettre à jour la requête Salesforce pour définir comment les informations de l'utilisateur actuel sont récupérées.
Choisir quel champ définit le
userIdpour l'identification unique de l'utilisateur.Ajouter à
additionalAttributespour inclure plus d'attributs de données utilisateur envoyés à Fin.
FAQ
Comment trouver mon Fin App ID ?
Allez dans Settings > General. Votre App ID est listé dans la section Détails de l'application.
Où puis-je trouver la JWT Secret Key ?
Dans Settings > Fin Messenger, copiez votre JWT Secret Key.
Que faire si le messenger ne se charge pas ?
Vérifiez vos paramètres CSP. Assurez-vous que les URLs de scripts de confiance et les URLs de confiance sont correctement configurées et que le niveau de sécurité est réglé sur Relaxed CSP.
Puis-je restreindre les données utilisateur envoyées à Fin ?
Oui. Modifiez la classe Apex JwtGenerator pour personnaliser les champs et attributs utilisateur inclus.