Zum Hauptinhalt springen

Fin für das Salesforce Managed 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 Managed 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 Managed 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 Managed Package installiert die folgenden Komponenten:

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

Das Managed 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 für jeden 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 Anlegen des Feldes korrekt eingestellt ist.

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

Das Fin für Salesforce Managed 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 Alle Datensätze Ändern/Anzeigen)

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

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

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

Änderungsprotokoll

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 Managed Package wird über die Connect-Seite in Ihrem Fin-Arbeitsbereich installiert. Gehen Sie zu Connect, klicken Sie auf die Connect-Schaltfläche neben dem Organisationstyp, den Sie verbinden möchten, und klicken Sie dann auf Install Package. Wählen Sie Für alle Users installieren und warten Sie, bis die Installation abgeschlossen ist.

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. Befolgen Sie diese Schritte, 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 PermissionSets muss genau Fin_for_Salesforce_permissions lauten. Dies schaltet den Schritt Berechtigungen in Salesforce zuweisen in Ihrem Connect-Flow frei.

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

  4. Zukünftige Updates des Packages werden im Änderungsprotokoll dokumentiert.

Wie migriere ich vom unmanaged Package?

Bevorzugter Ansatz:

  1. Fin pausieren.

  2. Weisen Sie den Salesforce-Benutzer vom PermissionSet Intercom Fin AI permission 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 die in FinInvolved__c und FinResolutionState__c gespeicherten Werte dauerhaft verlieren, wenn Sie sie überspringen. 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 von FinInvolved__c- und FinResolutionState__c-Werten 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 FinInvolved__c- und FinResolutionState__c-Werte als .csv-Datei heruntergeladen werden können.

  5. Gehen Sie in Ihrem Fin-Arbeitsbereich zu Connect > Berechtigungen in Salesforce zuweisen

  6. Folgen Sie den Schritten im Artikel Wie verbinde ich Fin mit Salesforce, um das Managed Package zu installieren und die Verbindung abzuschließen.

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 Managed Package hinzu oder aktualisieren Sie diese. Updates des Managed Packages werden hier im Änderungsprotokoll 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 bestehende Funktionen weiterhin funktioniert, verpassen Sie neue Features, die zusätzliche Felder oder Berechtigungen erfordern. Die Migration zum Managed Package wird empfohlen, um aktuell zu bleiben. Zukünftige Ergänzungen werden im oben genannten Änderungsprotokoll dokumentiert.

Hat dies deine Frage beantwortet?

Verwandte Artikel