Zum Hauptinhalt springen

Fin für Salesforce Unlocked Package

Dieser Artikel richtet sich an Salesforce Systemadministratoren, die den Fin AI Agent mit Salesforce Cases oder Fin Messenger einrichten. Er ist in Plänen mit Salesforce-Integration verfügbar – prüfen Sie Ihren Intercom-Plan, wenn Sie unsicher sind.

Das Fin für Salesforce Unlocked Package gibt Fin die Salesforce-Berechtigungen und benutzerdefinierten Case-Felder, die benötigt werden, um Salesforce Cases im Namen Ihrer Kunden zu erstellen, zu lesen und zu aktualisieren. Ein Unlocked Package ist ein Container für Salesforce-Metadaten – Felder, Berechtigungssätze und zugehörige Konfiguration –, der automatisch zu Ihrer Salesforce-Organisation hinzugefügt wird, wenn Sie es installieren. Das Unlocked Package installiert die folgenden Komponenten:

Welche benutzerdefinierten Felder fügt das Fin für Salesforce Package zu Salesforce hinzu?

Das Unlocked Package fügt dem Salesforce Case-Objekt vier benutzerdefinierte Felder hinzu. Diese Felder ermöglichen es Fin, seine Beteiligung, den Lösungsstatus, die Spam-Erkennung und die Gesprächs-ID bei jedem Case zu verfolgen. Wenn Sie diese Felder manuell anlegen statt das Package zu installieren, müssen die Application Programming Interface (API) Namen exakt übereinstimmen.

Feldname

Metadaten

FinInvolved__c

Speichert, ob Fin an diesem Case beteiligt war

  • Typ: Kontrollkästchen

  • Bezeichnung: FinInvolved

  • Standardwert: false

FinResolutionState__c

Speichert den Lösungsstatus von Fin

  • Typ: Auswahlliste

  • Bezeichnung: FinResolutionState

  • Werte:

    • Weiche Lösung
      ​(API Name: soft_resolution)

    • Harte Lösung
      ​(API Name: hard_resolution)

    • An Team weitergeleitet
      ​(API Name: routed_to_team)

    • Abgebrochen
      ​(API Name: abandoned_negative_feedback)

FinMarkedAsSpam__c
Speichert, ob das Gespräch von Fin als Spam markiert wurde

  • Typ: Kontrollkästchen

  • Bezeichnung: FinMarkedAsSpam

  • Standardwert: false

FinConversationId__c
Speichert die Gesprächskennung zur Verknüpfung mit der Fin-Plattform

  • Bezeichnung: FinConversationId

  • Länge: 255 Zeichen

Hinweis: FinConversationId__c ist ein Textfeld (Typ: Text, maximale Länge: 255 Zeichen). Stellen Sie sicher, dass dies beim manuellen Erstellen des Feldes korrekt eingestellt ist.

Welche Berechtigungen benötigt das Fin für Salesforce Package?

Das Fin für Salesforce Unlocked Package erstellt einen PermissionSet namens Fin for Salesforce permissions (API-Name: Fin_for_Salesforce_permissions). Dieser PermissionSet muss dem Salesforce-Benutzer zugewiesen werden, der Fin mit Ihrer Salesforce-Organisation verbindet. Er gewährt die minimalen Berechtigungen, die Fin benötigt, um Cases zu verwalten, und umfasst:

Objektberechtigungen

  • Case: Erstellen, Lesen, Bearbeiten (kein Löschen, kein Ändern/Anzeigen aller Datensätze)

  • Kontakt: Lesen, Bearbeiten (kein Erstellen/Löschen, kein Ändern/Anzeigen aller Datensätze)

  • Account: Lesen, Bearbeiten (kein Erstellen/Löschen, kein Ändern/Anzeigen aller Datensätze)

Feldberechtigungen (Lese- und Schreibzugriff)

  • Case-Felder: ContactId, Description, FinInvolved__c, FinMarkedAsSpam__c, FinConversationId__c, FinResolutionState__c, Origin, SourceId, Subject, SuppliedEmail, SuppliedName

  • Kontaktfelder: Email

  • Aufgabenfelder: ActivityDate, Description, Type, WhatId, WhoId

Systemberechtigungen

  • API Enabled

  • Kann Feed-Systemfelder einfügen

  • Aufgabe bearbeiten

  • Alle Users anzeigen

  • Rollen anzeigen

  • Setup anzeigen

Changelog

v1.0 - Version 1

  • Erstellt 4 benutzerdefinierte Case-Felder FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c & FinConversationId__c

  • Erstellt 1 Berechtigungssatz namens Fin for Salesforce permissions

FAQs

Wie installiere ich das Fin für Salesforce Package?

Das Package ist im Bereitstellungsschritt im Fin Messenger und Salesforce Cases-Kanal verlinkt. Sie können es auch über die untenstehenden Links installieren.

Fin für Salesforce in der Produktion installieren

ODER
​

Fin für Salesforce in der Sandbox installieren

Was mache ich, wenn ich das Package nicht installieren möchte?

Wenn Sie das Unlocked Package nicht installieren möchten, können Sie die gleichen Salesforce-Komponenten manuell erstellen. Folgen Sie diesen Schritten, um Fin für Salesforce ohne Installation des Packages einzurichten:

  1. Erstellen Sie die vier benutzerdefinierten Case-Felder, die im Abschnitt „Welche benutzerdefinierten Felder fügt das Fin für Salesforce Package zu Salesforce hinzu?“ dieses Artikels definiert sind: FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c und FinConversationId__c. Die API-Namen müssen exakt wie dokumentiert übereinstimmen.

  2. Erstellen Sie einen PermissionSet mit den Objektberechtigungen, Feldberechtigungen und Systemberechtigungen, die im Abschnitt „Welche Berechtigungen benötigt das Fin für Salesforce Package?“ dieses Artikels aufgeführt sind. Der API-Name des PermissionSet muss genau Fin_for_Salesforce_permissions lauten. Dies schaltet den Schritt Install and assign permissions in Salesforce in Ihrem Bereitstellungsablauf frei.

  3. Weisen Sie den PermissionSet dem Salesforce-Benutzer zu, der Fin mit Salesforce verbunden hat.

  4. Zukünftige Updates des Packages werden im Changelog dokumentiert.

Wie migriere ich vom unmanaged Package?

Bevorzugter Ansatz:

  1. Pausieren Sie Fin.

  2. Weisen Sie den Salesforce-Benutzer vom Intercom Fin AI permission PermissionSet ab, dies ermöglicht die Deinstallation des unmanaged Packages.

  3. Deinstallieren Sie das unmanaged Package. Während der Deinstallation fordert Salesforce Sie auf, Ihre Daten zu speichern – wählen Sie diese Option, da Sie sonst die in FinInvolved__c und FinResolutionState__c gespeicherten Werte dauerhaft verlieren. Der Screenshot unten zeigt den Salesforce-Deinstallationsbildschirm, in dem Sie die Option zur Datenspeicherung auswählen.

    Der Salesforce-Deinstallationsbildschirm mit der Option, Felddaten vor der Deinstallation des unmanaged Packages zu speichern. Wählen Sie diese Option, um den Verlust der Werte von FinInvolved__c und FinResolutionState__c zu vermeiden.

  4. Nach Abschluss der Deinstallation sendet Salesforce Ihnen eine E-Mail, wenn Ihr Datenexport bereitsteht. Laden Sie die gespeicherten Felddaten als .csv-Datei herunter, indem Sie im Salesforce-Datenexportbildschirm auf Daten klicken, wie unten gezeigt.

    Der Salesforce-Datenexportbildschirm nach der Deinstallation, der die Schaltfläche Daten zeigt, mit der die gespeicherten Werte von FinInvolved__c und FinResolutionState__c als .csv-Datei heruntergeladen werden können.

  5. Gehen Sie zu Einstellungen > Salesforce Integration > Install and assign permissions in Salesforce

  6. Klicken Sie auf Install Fin for Salesforce

Nach der Installation können Sie den DataLoader verwenden, um die csv-Datei aus Schritt 4 zu importieren und Ihre Cases mit FinInvolved__c & FinResolutionState__c zu aktualisieren.

Optionale Vorgehensweise:

Fügen Sie manuell Komponenten aus dem in diesem Artikel dokumentierten Unlocked Package hinzu oder aktualisieren Sie diese. Updates des Unlocked Package werden hier im Changelog dokumentiert.

Hinweis: Das unmanaged Package unterstützt keine Upgrades. Das bedeutet, dass neue Felder und Komponenten in zukünftigen Versionen – wie FinMarkedAsSpam__c und FinConversationId__c – nicht automatisch für Organisationen verfügbar sind, die noch das unmanaged Package verwenden. Während Fin für die bestehende Funktionalität weiterarbeitet, verpassen Sie neue Funktionen, die zusätzliche Felder oder Berechtigungen erfordern. Die Migration zum Unlocked Package ist der empfohlene Weg, um aktuell zu bleiben. Zukünftige Ergänzungen werden im oben genannten Changelog dokumentiert.

Verwandte Artikel
Fin für Salesforce Cases: Wie werden Daten synchronisiert?
Fin Messenger: JWT-Authentifizierung für Salesforce Enhanced Chat einrichten
Hat dies deine Frage beantwortet?