Sie können Fin Messenger auf Ihrer Salesforce-Seite mit einem vorgefertigten Paket installieren. Nach der Installation konfigurieren Sie benutzerdefinierte Einstellungen, aktualisieren Ihre Content-Security-Policy (CSP) und verbinden Fin sicher mit Ihrer Salesforce-Umgebung.
Fin Messenger auf einer Salesforce-Webseite installieren
1. Paket in Salesforce installieren
Um Fin Messenger auf einer Salesforce-Webseite zu installieren, haben wir ein Paket erstellt, das Sie installieren können und das einfach eine benutzerdefinierte Einstellung definiert.
Sie müssen das Paket in Ihrer Salesforce-Umgebung installieren, bevor Sie die untenstehenden Schritte ausführen.
Oder
2. Fin Messenger-Einstellungen in Salesforce konfigurieren
Nach der Installation sehen Sie eine neue benutzerdefinierte Einstellung namens Fin Messenger Settings. Diese verwenden Sie, um Salesforce mit Ihren Fin-App-Zugangsdaten zu verbinden.
A) Zugriff auf Fin Messenger Settings
In Salesforce:
Gehen Sie zu Setup > Custom Settings.
Öffnen Sie Fin Messenger Settings.
Klicken Sie auf Manage.
Klicken Sie auf New, um den Default Organization Level Value festzulegen.
B) Konfigurieren Sie das benutzerdefinierte Feld App ID
In Fin gehen Sie zu Settings > General, um Ihre App ID zu finden.
Öffnen Sie in Salesforce Fin Messenger Settings.
Geben Sie Ihre App ID im benutzerdefinierten Feld App ID ein.
C) Konfigurieren Sie das benutzerdefinierte Feld JWT Secret Key
In Fin gehen Sie zu Settings > Fin Messenger, um Ihren JWT Secret Key zu finden.
Öffnen Sie in Salesforce Fin Messenger Settings.
Geben Sie Ihren JWT Secret Key im benutzerdefinierten Feld JWT Secret Key ein.
3. Content-Security-Policy (CSP) konfigurieren
Sobald Ihre Fin Messenger-Einstellungen konfiguriert sind, richten Sie die erforderlichen CSP-Regeln ein, damit Fin Messenger sicher geladen werden kann.
A) Zugriff auf Site Security & Privacy
In Salesforce:
Gehen Sie zu Setup > Sites > (Ihre Seite) Builder.
Öffnen Sie Settings > Security & Privacy.
B) Sicherheitsstufe konfigurieren
Setzen Sie die Security Level auf Relaxed CSP. Dadurch können Sie das erforderliche Skript im Head-Markup der Seite hinzufügen.
C) Vertrauenswürdige Sites für Skripte konfigurieren
Fügen Sie diese vertrauenswürdigen Sites hinzu:
https://widget.intercom.io – lädt den Messenger
https://js.intercomcdn.com – lädt zusätzliche Assets
D) Vertrauenswürdige URLs konfigurieren
Gehen Sie zu Setup > Trusted URLs.
Fügen Sie die URLs aus diesem Artikel mit den entsprechenden CSP-Direktiven hinzu.
Setzen Sie CSP Context auf All oder Experience Builder Sites.
4. Fügen Sie das Fin Messenger-Skript zu Ihrem Salesforce-Portal hinzu
Fügen Sie das folgende JavaScript in das Head Markup Ihrer Seite ein.
Dieses Skript hört auf das finMessengerData-Ereignis und lädt dann Fin Messenger dynamisch mit dem codierten JWT und der 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>
Wichtig: Der Wert api_base muss basierend auf Ihrem regionalen Standort aktualisiert werden. Wählen Sie den richtigen Wert aus der untenstehenden Tabelle aus:
Regionaler Standort | API-Basis zum Einstellen |
USA |
|
EU |
|
Australien |
|
5. Fügen Sie die Fin Messenger-Komponente zu Ihrer Salesforce-Webseite hinzu
In Salesforce:
Gehen Sie zu Setup > Sites > (Ihre Seite) Builder.
Ziehen Sie die Fin Messenger-Komponente per Drag & Drop auf Ihre Portal-Seite, um sie bereitzustellen.
6. Bearbeiten Sie die Apex-Klasse, um die an Fin gesendeten Benutzerdaten zu steuern
In Salesforce:
Gehen Sie zu Setup > Apex Classes > JwtGenerator.
Klicken Sie auf Edit.
Sie können:
Die Salesforce-Abfrage aktualisieren, um zu definieren, wie aktuelle Benutzerinformationen abgerufen werden.
Festlegen, welches Feld die
userIdfür die eindeutige Benutzeridentifikation setzt.An
additionalAttributesanhängen, um weitere Benutzerdatenattribute einzuschließen, die an Fin gesendet werden.
FAQs
Wie finde ich meine Fin App ID?
Gehen Sie zu Settings > General. Ihre App ID wird im Abschnitt App details angezeigt.
Wo finde ich den JWT Secret Key?
Kopieren Sie in Settings > Fin Messenger Ihren JWT Secret Key.
Was, wenn der Messenger nicht lädt?
Überprüfen Sie Ihre CSP-Einstellungen. Stellen Sie sicher, dass sowohl vertrauenswürdige Skript-URLs als auch vertrauenswürdige URLs korrekt konfiguriert sind und die Sicherheitsstufe auf Relaxed CSP gesetzt ist.
Kann ich einschränken, welche Benutzerdaten an Fin gesendet werden?
Ja. Bearbeiten Sie die JwtGenerator Apex Class, um anzupassen, welche Benutzerfelder und Attribute eingeschlossen werden.