Você pode instalar o Fin Messenger no seu site Salesforce usando um pacote pré-construído. Após a instalação, você configurará as definições personalizadas, atualizará sua política de segurança de conteúdo (CSP) e conectará o Fin com segurança ao seu ambiente Salesforce.
Instale o Fin Messenger em uma página do Salesforce
1. Instale o pacote no Salesforce
Para instalar o Fin Messenger em uma página do Salesforce, criamos um pacote que você pode instalar, o qual simplesmente cria uma definição de configuração personalizada.
Você precisará instalar o pacote no seu ambiente Salesforce antes de seguir os passos abaixo.
Ou
2. Configure as configurações do Fin Messenger no Salesforce
Após a instalação, você verá uma nova configuração personalizada chamada Fin Messenger Settings. Você usará isso para conectar o Salesforce com suas credenciais do Fin app.
A) Acesse as Configurações do Fin Messenger
No Salesforce:
Vá para Setup > Custom Settings.
Abra Fin Messenger Settings.
Clique em Manage.
Clique em New para definir o Default Organization Level Value
B) Configure o campo personalizado App ID
No Fin, vá para Settings > General para encontrar seu App ID.
No Salesforce, abra Fin Messenger Settings.
Digite seu App ID no campo personalizado App ID.
C) Configure o campo personalizado JWT Secret Key
No Fin, vá para Settings > Fin Messenger para encontrar sua JWT Secret Key.
No Salesforce, abra Fin Messenger Settings.
Digite sua JWT Secret Key no campo personalizado JWT Secret Key.
3. Configure a política de segurança de conteúdo (CSP)
Depois que as configurações do Fin Messenger estiverem configuradas, configure as regras CSP necessárias para permitir que o Fin Messenger carregue com segurança.
A) Acesse Segurança e Privacidade do Site
No Salesforce:
Vá para Setup > Sites > (seu site) Builder.
Abra Settings > Security & Privacy.
B) Configure o Nível de Segurança
Defina o Security Level para Relaxed CSP. Isso permite que você adicione o script necessário ao cabeçalho do site.
C) Configure Sites Confiáveis para Scripts
Adicione estes sites confiáveis:
https://widget.intercom.io – carrega o messenger
https://js.intercomcdn.com – carrega ativos adicionais
D) Configure URLs Confiáveis
Vá para Setup > Trusted URLs.
Adicione as URLs deste artigo com as diretivas CSP relevantes.
Defina CSP Context para All ou Experience Builder Sites.
4. Adicione o script do Fin Messenger ao seu portal Salesforce
Adicione o seguinte JavaScript ao Head Markup do seu site.
Este script escuta o evento finMessengerData e então carrega dinamicamente o Fin Messenger com o JWT codificado e o 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: O valor api_base precisará ser atualizado com base na sua localização regional, veja a tabela abaixo para escolher o valor correto:
Localização regional | Base da API para configurar |
US |
|
EU |
|
Austrália |
|
5. Adicione o componente Fin Messenger à sua página do Salesforce
No Salesforce:
Vá para Setup > Sites > (seu site) Builder.
Arraste e solte o componente Fin Messenger na página do seu portal para implantá-lo.
6. Edite a Classe Apex para controlar os dados do usuário enviados ao Fin
No Salesforce:
Vá para Setup > Apex Classes > JwtGenerator.
Clique em Edit.
Você pode:
Atualizar a consulta do Salesforce para definir como as informações do usuário atual são recuperadas.
Escolher qual campo define o
userIdpara identificação única do usuário.Adicionar a
additionalAttributespara incluir mais atributos de dados do usuário enviados ao Fin.
Perguntas Frequentes
Como encontro meu Fin App ID?
Vá para Settings > General. Seu App ID está listado na seção App details.
Onde posso encontrar a JWT Secret Key?
Em Settings > Fin Messenger, copie sua JWT Secret Key.
E se o messenger não carregar?
Verifique suas configurações CSP. Certifique-se de que tanto as URLs de scripts confiáveis quanto as URLs confiáveis estejam configuradas corretamente e que o nível de segurança esteja definido para Relaxed CSP.
Posso restringir quais dados do usuário são enviados ao Fin?
Sim. Edite a JwtGenerator Apex Class para personalizar quais campos e atributos do usuário são incluídos.