Puedes instalar Fin Messenger en tu sitio de Salesforce usando un paquete preconstruido. Una vez instalado, configurarás ajustes personalizados, actualizarás tu política de seguridad de contenido (CSP) y conectarás Fin de forma segura con tu entorno de Salesforce.
Instalar Fin Messenger en una página web de Salesforce
1. Instalar el paquete en Salesforce
Para instalar Fin Messenger en una página web de Salesforce, hemos creado un paquete que puedes instalar, el cual simplemente crea una definición de configuración personalizada.
Necesitarás instalar el paquete en tu entorno de Salesforce antes de seguir los pasos a continuación.
O
2. Configurar los ajustes de Fin Messenger en Salesforce
Después de la instalación, verás una nueva configuración personalizada llamada Fin Messenger Settings. La usarás para conectar Salesforce con tus credenciales de la app Fin.
A) Acceder a Fin Messenger Settings
En Salesforce:
Ve a Setup > Custom Settings.
Abre Fin Messenger Settings.
Haz clic en Manage.
Haz clic en New para establecer el Default Organization Level Value
B) Configurar el campo personalizado App ID
En Fin, ve a Settings > General para encontrar tu App ID.
En Salesforce, abre Fin Messenger Settings.
Introduce tu App ID en el campo personalizado App ID.
C) Configurar el campo personalizado JWT Secret Key
En Fin, ve a Settings > Fin Messenger para encontrar tu JWT Secret Key.
En Salesforce, abre Fin Messenger Settings.
Introduce tu JWT Secret Key en el campo personalizado JWT Secret Key.
3. Configurar la política de seguridad de contenido (CSP)
Una vez configurados los ajustes de Fin Messenger, configura las reglas CSP necesarias para permitir que Fin Messenger se cargue de forma segura.
A) Acceder a Seguridad y Privacidad del Sitio
En Salesforce:
Ve a Setup > Sites > (tu sitio) Builder.
Abre Settings > Security & Privacy.
B) Configurar Nivel de Seguridad
Establece el Security Level en Relaxed CSP. Esto te permite añadir el script requerido en el marcado del encabezado del sitio.
C) Configurar Sitios de Confianza para Scripts
Agrega estos sitios de confianza:
https://widget.intercom.io – carga el messenger
https://js.intercomcdn.com – carga recursos adicionales
D) Configurar URLs de Confianza
Ve a Setup > Trusted URLs.
Agrega las URLs de este artículo con las directivas CSP correspondientes.
Establece CSP Context en All o Experience Builder Sites.
4. Añadir el script de Fin Messenger a tu portal de Salesforce
Añade el siguiente JavaScript al Head Markup de tu sitio.
Este script escucha el evento finMessengerData, luego carga dinámicamente Fin Messenger con el JWT codificado y el 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>
Importante: El valor api_base deberá actualizarse según tu ubicación regional, consulta la tabla a continuación para elegir el valor correcto:
Ubicación regional | API base a configurar |
EE.UU. |
|
UE |
|
Australia |
|
5. Añadir el componente Fin Messenger a tu página web de Salesforce
En Salesforce:
Ve a Setup > Sites > (tu sitio) Builder.
Arrastra y suelta el componente Fin Messenger en la página de tu portal para desplegarlo.
6. Editar la clase Apex para controlar los datos de usuario enviados a Fin
En Salesforce:
Ve a Setup > Apex Classes > JwtGenerator.
Haz clic en Edit.
Puedes:
Actualizar la consulta de Salesforce para definir cómo se recupera la información del usuario actual.
Elegir qué campo establece el
userIdpara la identificación única del usuario.Agregar a
additionalAttributespara incluir más atributos de datos de usuario enviados a Fin.
Preguntas frecuentes
¿Cómo encuentro mi Fin App ID?
Ve a Settings > General. Tu App ID aparece en la sección App details.
¿Dónde puedo encontrar la JWT Secret Key?
En Settings > Fin Messenger, copia tu JWT Secret Key.
¿Qué pasa si el messenger no se carga?
Revisa tus ajustes CSP. Asegúrate de que tanto las URLs de scripts de confianza como las URLs de confianza estén configuradas correctamente y que el nivel de seguridad esté establecido en Relaxed CSP.
¿Puedo restringir qué datos de usuario se envían a Fin?
Sí. Edita la JwtGenerator Apex Class para personalizar qué campos y atributos de usuario se incluyen.