⚠️ Obsoleto - configuração não recomendada
Este artigo aborda a configuração da autenticação JWT para um Canal de Mensagens Salesforce Enhanced Chat. Novas implantações Salesforce devem usar Bring Your Own Channel (BYOC): [link]. Estes passos permanecem para workspaces já usando Enhanced Chat.
Este artigo explica como gerar e configurar o JSON Web Token (JWT) necessário para o Fin Messenger autenticar users ao direcionar conversas para Salesforce Enhanced Chat. Completar esses passos permite que o Fin transmita com segurança a identidade do usuário para Fin e Salesforce, para que sua equipe confie na identidade dos clientes com quem falam.
Nota: Pré-requisitos: Fin Messenger deve estar instalado no seu app e um Canal de Mensagens Salesforce Enhanced Chat configurado. A gem Ruby jwt é necessária se usar os exemplos de código Rails abaixo. Este recurso está disponível nos planos Fin Messenger que incluem integração Salesforce — contate sua equipe de conta para confirmar acesso.
Você deve adicionar o JWT aos seus atributos intercomSettings para habilitar a autenticação Fin Messenger com Salesforce Enhanced Chat:
intercom_user_jwt
Isso é usado para fornecer com segurança ao Fin o Contact ID e quaisquer atributos do Contact ou Account que você queira fornecer ao Fin (ou Salesforce).
Omitir intercom_user_jwt significa que o Fin não pode transmitir dados de contato com segurança para o Salesforce.
O JWT deve ser gerado no servidor a cada carregamento de página para o usuário atual, assinado com seu Messenger API secret. Siga estes passos para obter o secret e habilitar a verificação do usuário no Fin Messenger e Salesforce:
Obtenha seu Messenger API secret: vá para Configurações > Segurança > Messenger e copie seu Messenger API secret. Este é o secret compartilhado usado para assinar intercom_user_jwt.
Veja Fin Messenger: Habilitando verificação de usuário no Salesforce para instruções passo a passo para habilitar a Verificação de Usuário no Salesforce. O Fin cuidará da geração do Salesforce JWT uma vez configurado.
O exemplo Rails a seguir mostra como gerar o JWT para autenticação Fin Messenger e Salesforce Enhanced Chat e passá-los para seu objeto intercomSettings:
Visualização Rails — passando JWTs para intercomSettings para Fin Messenger:
window.intercomSettings = {
api_base: "https://api-iam.intercom.io",
app_id: "your-app-id-here",
user_id: "<%= current_user&.id %>",
intercom_user_jwt: "<%= intercom_jwt(current_user&.id) %>",
};
Helper Rails — gerando o Fin JWT para Fin Messenger:
intercom_jwt usa HS256 (HMAC-SHA256, um algoritmo de assinatura simétrico) com seu Intercom Messenger API Secret.
def intercom_jwt(user_id)
JWT.encode({ user_id: user_id, exp: Time.now.to_i+3600 }, INTERCOM_JWT_SECRET, "HS256")
end
Nota: O JWT expira após 1 hora (exp: Time.now.to_i + 3600). Deve ser regenerado a cada carregamento de página — não o armazene em cache entre sessões. Se um JWT expirar no meio da conversa, o cliente pode precisar atualizar a página para reautenticar.
