⚠️ Veraltet – nicht mehr die empfohlene Einrichtung
Dieser Artikel behandelt die Einrichtung der JWT-Authentifizierung für einen Salesforce Enhanced Chat Messaging Channel. Neue Salesforce-Implementierungen sollten stattdessen Bring Your Own Channel (BYOC) verwenden: [link]. Diese Schritte bleiben für Arbeitsbereiche mit bereits laufendem Enhanced Chat erhalten.
Dieser Artikel erklärt, wie das JSON Web Token (JWT) generiert und konfiguriert wird, das Fin Messenger benötigt, um users bei der Weiterleitung von Gesprächen an Salesforce Enhanced Chat zu authentifizieren. Durch diese Schritte kann Fin die Benutzeridentität sicher an Fin und Salesforce übermitteln, sodass Ihre Teammitglieder der Identität der Kunden vertrauen können, mit denen sie sprechen.
Hinweis: Voraussetzungen: Fin Messenger muss bereits in Ihrer App installiert sein, und ein Salesforce Enhanced Chat Messaging Channel muss konfiguriert sein. Das Ruby jwt Gem wird benötigt, wenn Sie die untenstehenden Rails-Codebeispiele verwenden. Diese Funktion ist in Fin Messenger-Plänen mit Salesforce-Integration verfügbar – wenden Sie sich an Ihr Account-Team, um den Zugriff zu bestätigen.
Sie müssen das JWT zu Ihren intercomSettings-Attributen hinzufügen, um die Fin Messenger-Authentifizierung mit Salesforce Enhanced Chat zu aktivieren:
intercom_user_jwt
Dies wird verwendet, um Fin sicher die Contact ID und alle Attribute für den Contact oder Account bereitzustellen, die Sie Fin (oder Salesforce) übermitteln möchten.
Das Weglassen von intercom_user_jwt bedeutet, dass Fin keine Kontaktdaten sicher an Salesforce übermitteln kann.
Das JWT muss serverseitig bei jedem Seitenaufruf für den aktuellen user mit einem privaten Schlüssel generiert werden. Befolgen Sie diese Schritte, um jeden Schlüssel zu erhalten und die Benutzerüberprüfung in Fin Messenger und Salesforce zu aktivieren:
Rufen Sie Ihren Intercom-Privatschlüssel ab – gehen Sie zu Einstellungen > Messenger > Sicherheit und kopieren Sie Ihr Messenger API Secret. Dies ist der Signaturschlüssel für intercom_user_jwt.
Siehe Fin Messenger: Aktivierung der Benutzerüberprüfung in Salesforce für eine Schritt-für-Schritt-Anleitung zur Aktivierung der Benutzerüberprüfung in Salesforce. Fin übernimmt die Generierung des Salesforce JWT, sobald es konfiguriert ist.
Das folgende Rails-Beispiel zeigt, wie das JWT für die Authentifizierung von Fin Messenger und Salesforce Enhanced Chat generiert und in Ihr intercomSettings-Objekt übergeben wird:
Rails-Ansicht – Übergabe von JWTs an intercomSettings für 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 %>",
};
Rails-Helfer – Generierung des Fin JWT für Fin Messenger:
intercom_jwt verwendet HS256 (HMAC-SHA256, einen symmetrischen Signaturalgorithmus) mit Ihrem 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
Hinweis: Das JWT läuft nach 1 Stunde ab (exp: Time.now.to_i + 3600). Es muss bei jedem Seitenaufruf neu generiert werden – speichern Sie es nicht zwischen den Sitzungen. Wenn ein JWT während eines Gesprächs abläuft, muss der Kunde möglicherweise die Seite aktualisieren, um sich erneut zu authentifizieren.