Zum Hauptinhalt springen

Aktualisierung Ihrer Salesforce-Verbindung zur Nutzung der External Client App und Unterstützung von BYOC

Schritt-für-Schritt-Anleitung zur Aktualisierung Ihrer Salesforce-Verbindung mit Fin zur Nutzung der External Client App und zum Wechsel von Enhanced Chat zu BYOC.

Bring Your Own Channel (BYOC) ist eine neue Möglichkeit für Fin-Kunden, Fin Messenger als ihren Live-Chat-KI-Agenten zu aktivieren. Die Verbindung über BYOC statt Enhanced Chat verbessert die Handhabung bestimmter Nutzerverhalten, wie gleichzeitige Gespräche über mehrere Tabs, sodass Sie weiterhin den erstklassigen Service von Fin genießen können. Die Migration ist einfach und nutzt Testumgebungen, bevor sie ohne Ausfallzeiten in die Produktion übergeht. Folgen Sie der untenstehenden Anleitung zur Implementierung in Ihrem Workspace.

Verwenden Sie diesen Artikel, um Ihre bestehende Fin for Salesforce-Verbindung auf die neue External Client App (ECA) zu aktualisieren. Diese Anleitung richtet sich an Salesforce-Administratoren, die eine bestehende Fin for Salesforce-Installation migrieren — Sie benötigen Salesforce-Administratorzugang und ein aktives Fin for Salesforce-Abonnement. Am Ende haben Sie die erforderlichen Managed Packages installiert, die Verbindung über die neue ECA hergestellt, Berechtigungen konfiguriert und — falls Sie Fin Messenger nutzen — eine Live-Chat-Verbindung zwischen Fin und Salesforce über Bring Your Own Channel (BYOC), das Standard-Channel-Integrationsframework von Salesforce für Drittanbieter-Messaging-Anbieter, eingerichtet.

Es sind 6 Schritte erforderlich:

  1. Verbinden Sie sich über die External Client App mit Salesforce

  2. Berechtigungen einrichten

  3. Wechseln Sie zur Nutzung der External Client App-Anmeldedaten

  4. Führen Sie das Apex-Migrationsskript aus

  5. Deinstallieren Sie das veraltete Paket und trennen Sie die Connected App

  6. Aktualisieren Sie Ihre Fin Messenger-Installation [optional]

Hinweis: Wenn Sie Fin nur für die Bearbeitung von Salesforce-Fällen (ohne Messaging) einrichten, können Sie den Abschnitt Updates to Fin Messenger unten überspringen.


Schritt 1: Verbinden Sie sich über die External Client App mit Salesforce

Gehen Sie in Ihrem Fin-Workspace zu Connect und klicken Sie dann auf den Tab Bring Your Own Channel.

Dies dient als Migrationstab für den Wechsel zur neuen External Client App (ECA) — eine OAuth 2.0 Client-Credentials-basierte Authentifizierungsmethode, die die veraltete Connected App ersetzt (eine ältere OAuth-basierte Integration, die das Speichern von Benutzeranmeldedaten erforderte).

Sie sehen Ihre bestehenden Verbindungen in diesem Tab als Not Connected aufgelistet. Der Verbindungsstatus bezieht sich auf die External Client App.

Folgen Sie den untenstehenden Schritten, um ein Managed Package in Salesforce zu installieren. Das Managed Package installiert die External Client App sowie alle Berechtigungen und Felder, die Fin benötigt, um zu funktionieren.

  1. Klicken Sie auf die Schaltfläche Connect bei einer bestehenden Verbindung (Test oder Live), die Sie verbinden möchten, und klicken Sie dann auf Install Package.

  2. Wählen Sie Install for all users. Das bedeutet, dass das Berechtigungsset jedem Benutzer in Ihrer Salesforce-Organisation zugewiesen werden kann, wenn Sie dies wünschen.

  3. Warten Sie, bis die Installation abgeschlossen ist. Es sollten keine Fehler angezeigt werden.

  4. Nach Abschluss der Installation kehren Sie zur Seite Connect zurück und klicken auf die Schaltfläche Connect to Salesforce in Schritt 2, um die Verbindung herzustellen.

Das Fin for Salesforce Managed Package ist eine veröffentlichte Version, die sowohl in Sandbox- als auch in Produktionsorganisationen installiert wird. Nach der Installation erscheint es unter Installed Packages mit dem Namespace finai und Fin als Herausgeber.


Schritt 2: Berechtigungen einrichten

Gehen Sie in Ihrem Fin-Workspace zu Connect > External Client App (Tab) > Assign permissions in Salesforce und folgen Sie den dortigen Schritten, um ein neues Berechtigungsset zu erstellen und alle Berechtigungen, die Fin benötigt, zuzuweisen.

Erstellen Sie ein neues Berechtigungsset

  1. Erstellen Sie in Salesforce ein neues Berechtigungsset. Die Bezeichnung und der API-Name können beliebig sein — dieses Berechtigungsset wird nur dem Integrationsbenutzer zugewiesen.

  2. Wählen Sie bei der Lizenzvergabe eine Lizenz, die die Berechtigung Set Audit Fields upon Record Creation enthält, zum Beispiel die Salesforce-Lizenz. Einige Lizenzen enthalten diese Berechtigung nicht.

  3. Speichern Sie das neue Berechtigungsset.

Der Salesforce-Bildschirm für neues Berechtigungsset zeigt das Lizenz-Dropdown auf 'Salesforce' gesetzt — der Lizenztyp, der die erforderliche Berechtigung 'Set Audit Fields upon Record Creation' enthält.

Hinweis: Nicht alle Salesforce-Lizenztypen enthalten die Berechtigung Set Audit Fields upon Record Creation. Wenn diese Option für eine von Ihnen in Betracht gezogene Lizenz nicht verfügbar ist, wählen Sie einen anderen Lizenztyp (z. B. die Standard-Salesforce-Lizenz), der diese Berechtigung enthält.

Weisen Sie dem Integrationsbenutzer Berechtigungssets zu

Sowohl das bestehende Berechtigungsset Fin for Salesforce permissions als auch das neu erstellte Berechtigungsset müssen dem Integrationsbenutzer zugewiesen werden.

  1. Navigieren Sie in Salesforce zum Profil des Integrationsbenutzers.

  2. Gehen Sie zu Permission Set Assignments und klicken Sie auf Edit Assignments.

  3. Fügen Sie sowohl das Berechtigungsset Fin for Salesforce permissions als auch das neu erstellte Berechtigungsset zur Spalte Enabled Permission Sets hinzu und klicken Sie auf Save.

Der Salesforce-Bildschirm für Berechtigungsset-Zuweisungen des Integrationsbenutzers zeigt sowohl 'Fin for Salesforce permissions' als auch das neu erstellte Berechtigungsset in der Spalte Enabled Permission Sets.


Schritt 3: Wechseln Sie zur Nutzung der External Client App-Anmeldedaten

Sie können zur Nutzung der External Client App-Anmeldedaten für eine Salesforce-Verbindung wechseln, indem Sie den Schalter Use External Client App credentials beim Verwalten einer Verbindung unter Connect > External Client App (Tab) umlegen.

Nach dem Einschalten verwendet Fin die External Client App-Anmeldedaten für alle Anfragen an Salesforce, einschließlich:

  • Abfragen zum Abrufen des Verbindungsstatus.

  • Erstellen eines Salesforce-Falls über den Workflow-Schritt.

  • Erstellen eines Salesforce-Falls bei Fin-Auflösung oder Benutzerinaktivität.

  • Antworten auf über den Salesforce-Fälle-Kanal erstellte Fälle.

  • Importieren von Knowledge-Artikeln.

  • Importieren historischer Salesforce-Fälle.

Nach dem Einschalten können Sie es wieder ausschalten, wenn Sie glauben, dass etwas nicht stimmt. So können Sie in jeder Umgebung — Sandbox, UAT (User Acceptance Testing) und Produktion — testen und Vertrauen in die neuen ECA-Anmeldedaten gewinnen, ohne die veralteten Connected App-Anmeldedaten zu stören.

Sobald alle Verbindungen Use External Client App credentials aktiviert haben, ist die Migration abgeschlossen. Der Verbindungsstatus jeder Eintragung wird im Tab External Client App auf Connected aktualisiert. Folgen Sie den untenstehenden Schritten, um Ihre Daten zu migrieren und das veraltete Paket zu entfernen, sobald Sie sicher sind, dass alle Systeme wie vorgesehen funktionieren.


Schritt 4: Führen Sie das Apex-Migrationsskript aus

Beim Installieren des Basispakets Fin for Salesforce werden neue Fin Case-Felder installiert, die mit finai namespace versehen sind. Namespacing bedeutet, dass jeder Feldname mit finai__ (z. B. finai__FinConversationId__c) vorangestellt wird, um Namenskonflikte mit anderen Paketen oder benutzerdefinierten Feldern in Ihrer Organisation zu vermeiden.

Im Rahmen der Migration verwenden Sie das Apex-Migrationsskript, um Ihre bestehenden Falldaten von den älteren, nicht namespaced Feldern auf die neuen namespaced Felder zu übertragen. Das Paket Fin for Salesforce enthält eine vorgefertigte Apex-Klasse namens FinCaseFieldMigrator.cls, die die Migrationslogik übernimmt.

Apex innerhalb eines verwalteten Pakets löst nicht qualifizierte benutzerdefinierte Feldnamen gegen seinen eigenen Namespace auf. Eine Abfrage für FinConversationId__c, die innerhalb des finai-Pakets ausgeführt wird, gibt stattdessen finai__FinConversationId__c zurück, sodass verpackter Code die Legacy-Felder überhaupt nicht lesen kann, und das gleichzeitige Benennen beider in einer Abfrage schlägt mit einem duplicate field selected-Fehler fehl. Die Migration muss daher von außerhalb des Pakets ausgeführt werden – deshalb müssen Sie die untenstehenden Klassen manuell in Ihrer Organisation hinzufügen. Die Klassen selbst enthalten keine Migrationslogik; sie rufen die vom verwalteten Paket installierte Migrationsklasse auf und führen sie in Chargen von jeweils 200 Datensätzen aus.

Sie fügen Ihrer Organisation zwei Apex-Klassen hinzu, führen die Migration einmal aus und löschen dann beide Klassen, sobald sie nicht mehr benötigt werden:

  • FinCaseFieldMigration führt die Migration aus.

  • FinCaseFieldMigrationTest ist der Test dazu. Salesforce wird Apex ohne Test nicht in die Produktion bereitstellen, und dieser Test überprüft auch, ob Ihre Organisation korrekt eingerichtet ist, bevor etwas ausgeführt wird.

4a. Kopieren Sie die beiden Klassen

FinCaseFieldMigration

public without sharing class FinCaseFieldMigration implements Database.Batchable<SObject>, Database.Stateful {

private final finai.FinCaseFieldMigrator migrator;

public FinCaseFieldMigration() {
this.migrator = new finai.FinCaseFieldMigrator();
}

public static Id run() {
return run(200);
}

public static Id run(Integer scopeSize) {
if (scopeSize == null || scopeSize < 1 || scopeSize > 2000) {
throw new IllegalArgumentException('scopeSize must be between 1 and 2000, got: ' + scopeSize);
}
return Database.executeBatch(new FinCaseFieldMigration(), scopeSize);
}

public Database.QueryLocator start(Database.BatchableContext bc) {
return Database.getQueryLocator(migrator.queryString());
}

public void execute(Database.BatchableContext bc, List<SObject> scope) {
migrator.migrate(scope);
}

public void finish(Database.BatchableContext bc) {
migrator.report(bc.getJobId());
}
}

FinCaseFieldMigrationTest

@IsTest
private class FinCaseFieldMigrationTest {

private static final String LEGACY_FIELD = 'FinConversationId__c';
private static final String TARGET_FIELD = 'finai__FinConversationId__c';

// Absent legacy field means the old unlocked package was never installed here, so there is
// genuinely nothing to migrate and the test below has nothing to prove. Every other
// precondition is a misconfiguration and is asserted, so it fails the deploy rather than
// passing green on a migration that would silently copy nothing.
private static Boolean orgHasLegacyField() {
return Schema.SObjectType.Case.fields.getMap().containsKey(LEGACY_FIELD);
}

@IsTest
static void copiesLegacyDataOntoTheNamespacedField() {
if (!orgHasLegacyField()) {
return;
}
Map<String, Schema.SObjectField> fields = Schema.SObjectType.Case.fields.getMap();
System.assert(
fields.containsKey(TARGET_FIELD),
TARGET_FIELD + ' does not exist — install the finai managed package before this class'
);
System.assert(
fields.get(LEGACY_FIELD).getDescribe().isAccessible(),
'cannot read ' + LEGACY_FIELD + ' — the legacy permission set must stay assigned'
);
System.assert(
fields.get(TARGET_FIELD).getDescribe().isUpdateable(),
'cannot write ' + TARGET_FIELD + ' — assign finai__Fin_for_Salesforce_permissions'
);

Case seeded = new Case(Subject = 'fin case field migration test', Status = 'New');
seeded.put(LEGACY_FIELD, 'conv-under-test');
insert seeded;
Id seededId = seeded.Id;

Test.startTest();
FinCaseFieldMigration.run();
Test.stopTest();

SObject migrated = Database.query(
'SELECT Id, ' + TARGET_FIELD + ' FROM Case WHERE Id = :seededId LIMIT 1'
)[0];
System.assertEquals(
'conv-under-test',
migrated.get(TARGET_FIELD),
'the legacy value should have been copied onto the namespaced field'
);
}

@IsTest
static void runReturnsAJobId() {
Test.startTest();
Id jobId = FinCaseFieldMigration.run(50);
Test.stopTest();
System.assertNotEquals(null, jobId, 'run() should return the id of the batch job it queued');
}

@IsTest
static void runRejectsAScopeSizeOutsideTheBatchLimits() {
for (Integer scopeSize : new List<Integer>{ null, 0, 2001 }) {
try {
FinCaseFieldMigration.run(scopeSize);
System.assert(false, 'expected IllegalArgumentException for scopeSize ' + scopeSize);
} catch (IllegalArgumentException e) {
System.assert(
e.getMessage().contains('scopeSize must be between 1 and 2000'),
'unexpected message: ' + e.getMessage()
);
}
}
}
}

4b. Fügen Sie die Klassen zu Ihrer Salesforce-Organisation hinzu

Wie Sie dies tun, hängt davon ab, welche Organisation Sie migrieren.

Migration einer Sandbox

  1. Gehen Sie zu Setup > Apex Classes und klicken Sie auf Neu.

  2. Fügen Sie den Code von FinCaseFieldMigration ein und klicken Sie auf Speichern.

  3. Klicken Sie erneut auf Neu, fügen Sie den Code von FinCaseFieldMigrationTest ein und klicken Sie auf Speichern.

  4. Klicken Sie auf Alle Tests ausführen oder öffnen Sie FinCaseFieldMigrationTest, klicken Sie auf Test ausführen und bestätigen Sie, dass er bestanden wurde.

Migration der Produktion mit einem Change Set (kein Befehlszeilen-Tool erforderlich)

Produktionsorganisationen erlauben es nicht, Apex-Klassen im Setup zu erstellen, daher erstellen Sie diese in einer Sandbox und stellen sie von dort bereit.

  1. Erstellen Sie in einer mit der Produktion verbundenen Sandbox, in der das neue Paket installiert ist, beide Klassen wie oben beschrieben.

  2. Gehen Sie in der Sandbox zu Setup > Outbound Change Sets und klicken Sie auf Neu. Fügen Sie beide Apex-Klassen hinzu und klicken Sie auf Hochladen, wobei Sie Ihre Produktionsorganisation als Ziel auswählen.

  3. Gehen Sie in der Produktion zu Setup > Deployment Settings und stellen Sie sicher, dass Ihre Sandbox berechtigt ist, eingehende Änderungen zu senden.

  4. Gehen Sie in der Produktion zu Setup > Inbound Change Sets, öffnen Sie das Change Set und klicken Sie auf Bereitstellen.

  5. Wählen Sie unter Testoption wählen die Option "Ausgewählte Tests ausführen", geben Sie FinCaseFieldMigrationTest ein und klicken Sie auf Bereitstellen.

Migration der Produktion mit der Salesforce CLI

Speichern Sie jede Klasse als .cls-Datei in einem case-field-migration/classes/-Ordner. Fügen Sie neben jeder eine .cls-meta.xml-Datei mit demselben Namen hinzu (zum Beispiel FinCaseFieldMigration.cls-meta.xml) mit folgendem Inhalt:
​

<?xml version="1.0" encoding="UTF-8"?>
<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
<apiVersion>62.0</apiVersion>
<status>Active</status>
</ApexClass>

Dann führen Sie aus:

sf project deploy start \
--source-dir case-field-migration \
--target-org <your-org-alias> \
--test-level RunSpecifiedTests \
--tests FinCaseFieldMigrationTest

Was eine erfolgreiche Bereitstellung Ihnen sagt: Während der Bereitstellung erstellt der Test einen temporären Test-Case, migriert ihn und überprüft, ob der Wert im neuen Feld angekommen ist. Salesforce rollt die Testdaten danach zurück. Eine erfolgreiche Bereitstellung bedeutet also, dass die Migration in Ihrer Organisation bereits funktioniert. Wenn die Bereitstellung fehlschlägt, gibt die Fehlermeldung den Grund an, zum Beispiel ein fehlendes Paket oder ein fehlendes Berechtigungssatz.

4c. Führen Sie die Migration aus

  1. Gehen Sie zu Salesforce Setup > Developer Console

  2. Klicken Sie auf Debug > Open Execute Anonymous Window

  3. Fügen Sie den untenstehenden Code ein, klicken Sie auf Ausführen

    Id jobId = FinCaseFieldMigration.run();
    System.debug('Fin Case field migration job: ' + jobId);


    Die Migration verarbeitet standardmäßig 200 Cases pro Charge. Wenn Ihre Organisation Case-Triggers, Flows oder andere Automatisierungen hat, die bei dieser Größe an Governor Limits stoßen, verwenden Sie stattdessen eine kleinere Chargengröße:

    FinCaseFieldMigration.run(50);

4d. Überprüfen Sie das Ergebnis

  • Setup > Apex Jobs zeigt den Fortschritt des FinCaseFieldMigration-Jobs an.

  • Wenn der Job abgeschlossen ist, erhält der Administrator, der ihn gestartet hat, eine Berichtsemail. Diese listet jeden Case auf, der übersprungen oder fehlgeschlagen ist, mit dem Feld und dem Grund.

Lesen Sie den Bericht, anstatt davon auszugehen, dass der Lauf funktioniert hat. Wenn beim Ausführen ein Berechtigungssatz fehlte, kann der Job "erfolgreich" beendet werden, ohne etwas kopiert zu haben. Der Bericht zeigt, welche Felder übersprungen wurden.

Sie können die Migration sicher erneut ausführen. Sie füllt nur neue Felder, die noch leer sind, sodass ein zweiter Lauf keine Datensätze aktualisiert.

Was die Migration nicht tut:

  • Sie löscht oder ändert nichts an den alten Feldern.

  • Sie kann nicht rückgängig gemacht werden.

  • Die beiden Kontrollkästchen, Fin Involved und Fin Marked As Spam, werden nur kopiert, wenn der alte Wert aktiviert ist. Ein deaktiviertes Kästchen kann nicht von einem nie gesetzten unterschieden werden, daher wird es nicht kopiert. So oder so endet das neue Feld deaktiviert.

4e. Entfernen Sie die Klassen

Sobald der Bericht einen sauberen Lauf zeigt, löschen Sie sowohl FinCaseFieldMigration als auch FinCaseFieldMigrationTest. Überspringen Sie dies nicht: Solange diese Klassen in Ihrer Organisation sind, lässt Salesforce Sie das Fin for Salesforce-Paket nicht deinstallieren.

  • Sandbox: Gehen Sie zu Setup > Apex Classes und klicken Sie neben jeder Klasse auf Del.

  • Produktion: Apex kann in der Produktion nicht über Setup gelöscht werden, verwenden Sie daher die Salesforce CLI.

    • Erstellen Sie in einem leeren Ordner destructiveChanges.xml:

      <?xml version="1.0" encoding="UTF-8"?>
      <Package xmlns="http://soap.sforce.com/2006/04/metadata">
      <types>
      <members>FinCaseFieldMigration</members>
      <members>FinCaseFieldMigrationTest</members>
      <name>ApexClass</name>
      </types>
      </Package>

    • Erstellen Sie dann im selben Ordner eine package.xml-Datei:

      <?xml version="1.0" encoding="UTF-8"?>
      <Package xmlns="http://soap.sforce.com/2006/04/metadata">
      <version>62.0</version>
      </Package>

    • Führen Sie von diesem Ordner aus aus:

      sf project deploy start \
      --manifest package.xml \
      --post-destructive-changes destructiveChanges.xml \
      --target-org <your-org-alias> \
      --test-level RunLocalTests

      Dies führt die bestehenden Tests Ihrer Organisation aus, wie jede Produktionsbereitstellung. Wenn ein Test fehlschlägt, der nicht FinCaseFieldMigrationTest ist, liegt das Problem bei diesem Test, nicht bei der Migration. Beheben Sie es wie bei jeder anderen Bereitstellung.


Schritt 5: Deinstallieren Sie das veraltete Paket und trennen Sie die Connected App

Sobald das neue verwaltete Paket installiert ist, werden alle Verbindungen auf die ECA-Anmeldedaten umgestellt und die Fin Case-Felddaten auf die neuen namespaced Felder migriert, deinstallieren Sie das vorherige unlocked oder unmanaged Paket und widerrufen Sie die Legacy Connected App-Verbindung.

Welches Paket deinstalliert werden soll: Ihre Organisation hat jetzt zwei Fin-Pakete. Deinstallieren Sie nur das Legacy-Unlocked-Paket, das keinen Namespace-Präfix hat und Intercom als Herausgeber. Es kann als Fin for Salesforce oder unter einem anderen Namen wie IntercomFinAIPermissions aufgeführt sein. Behalten Sie das neue verwaltete Paket, das den Namespace finai und Fin als Herausgeber hat.

Legacy PermissionSet zuweisen aufheben

Das Legacy PermissionSet (ein Salesforce-Objekt, das users Zugriff auf bestimmte Funktionen und Felder gewährt) muss vor der Deinstallation des Pakets zugewiesen aufgehoben werden.

Sowohl das Legacy-Paket als auch das neue Managed Package enthalten ein Permission Set mit der Bezeichnung Fin for Salesforce permissions. Heben Sie nur das Legacy-PermissionSet auf, das kein Namespace-Präfix hat. Behalten Sie finai__Fin_for_Salesforce_permissions für den Integrationsuser zugewiesen.

Wenn Sie andere Fin-bezogene Permission Sets sehen, die nicht zu einem der Pakete gehören, wurden diese wahrscheinlich manuell in Ihrer Organisation erstellt. Sie können diese entfernen, sobald Fin in der External Client App funktioniert, solange keine users mehr zugewiesen sind.

  1. Gehen Sie zu Salesforce setup > Installed Packages

  2. Klicken Sie auf das Legacy Fin for Salesforce Unlocked Package (kein Namespace-Präfix)

  3. Klicken Sie auf View Components

  4. Klicken Sie auf das Fin_for_Salesforce_permissions PermissionSet, dies sollte Sie zur PermissionSet-Seite führen.

  5. Klicken Sie auf Manage Assignments

  6. Wählen Sie alle zugewiesenen Salesforce users aus

  7. Klicken Sie auf die Schaltfläche Zuweisung entfernen

Paket deinstallieren und Daten speichern

  1. Gehen Sie zu Salesforce setup > Installed Packages

  2. Klicken Sie neben dem Legacy Fin for Salesforce Unlocked Package (kein Namespace-Präfix) auf Uninstall

    Die Salesforce-Seite Installed Packages mit dem aufgelisteten Fin for Salesforce Unlocked Package und einer sichtbaren Schaltfläche 'Uninstall' rechts daneben.
  3. Wählen Sie Save a copy of this package's data for 48 hours after uninstall. Dadurch werden alle Case-Felddaten als csv mit einer Spalte für die Salesforce Case ID gespeichert.

    Wichtig: Salesforce speichert den exportierten Datensatz nur 48 Stunden nach der Deinstallation. Laden Sie die CSV herunter, bevor dieses Zeitfenster endet. Wenn Sie das Apex-Migrationsskript bereits erfolgreich ausgeführt haben, müssen Sie nicht aus dieser Datei wiederherstellen – aber es ist eine nützliche Sicherheitsmaßnahme.

  4. Warten Sie auf die Benachrichtigung, dass die Paket-Deinstallation erfolgreich abgeschlossen wurde.

  5. Besuchen Sie erneut Salesforce setup > Installed Packages. Das deinstallierte Paket sollte unter Uninstalled Packages aufgeführt sein.

  6. Klicken Sie auf Data, dadurch werden alle Case-Daten als csv in einer zip-Datei heruntergeladen. Bewahren Sie diese zip-Datei sicher auf, da Sie sie zur Datenwiederherstellung verwenden könnten. Wenn Sie jedoch das Apex-Migrationsskript ausgeführt haben, sollten Sie bereit sein.

    Die Salesforce-Liste Uninstalled Packages zeigt das Fin for Salesforce Paket mit einem Download-Link 'Data', um den gespeicherten CSV-Export der Case-Felddaten innerhalb des 48-Stunden-Fensters herunterzuladen.

Connected App-Verbindung widerrufen

Connected App-Tokens werden in jeder Salesforce-Organisation separat gespeichert, daher wirkt sich das Widerrufen in einer Sandbox- oder UAT-Organisation nicht auf Ihre Produktionsverbindung aus. Widerrufen Sie die Tokens in jeder Organisation nur, wenn die Fin-Verbindung Use External Client App credentials aktiviert ist und wie erwartet funktioniert.

  1. Gehen Sie zu Salesforce setup > Connected Apps OAuth Usage

  2. Klicken Sie auf den Zahlenlink unter der Spalte User Count für die Connected App Fin for Salesforce. Sie werden zur Seite Connected App User's Usage weitergeleitet.

    Die Salesforce-Seite Connected Apps OAuth Usage zeigt die Connected App Fin for Salesforce mit einem numerischen User Count-Link in der Spalte User Count, der den Bildschirm Connected App User's Usage öffnet.
  3. Klicken Sie neben jedem aufgelisteten user auf Revoke. Dadurch werden die OAuth-Zugriffstokens entfernt, die als Teil der Legacy Connected App-Verbindung gespeichert sind. Nach dem Widerruf erscheinen diese users nicht mehr in der Liste.

    Der Bildschirm Connected App User's Usage zeigt einzelne user-Einträge mit einem 'Revoke'-Aktionslink neben jedem, um die Legacy OAuth-Zugriffstokens zu entfernen.


Schritt 6: Aktualisieren Sie Ihre Fin Messenger-Bereitstellung

Befolgen Sie diese Schritte nur, wenn Sie Fin for Salesforce mit Messaging verwenden möchten.

Dieser Abschnitt erklärt, wie Sie Fin als Bring Your Own Channel (BYOC)-Partner in Salesforce verbinden und wie Sie bestehende Enhanced Chat-Handoff-workflows auf BYOC migrieren.

Fin mit Bring Your Own Channel verbinden

Um die BYOC-Verbindung zwischen Fin und Salesforce herzustellen, folgen Sie Schritt 1 des Artikels Fin Messenger: Einrichtung mit Salesforce. Dieser Schritt führt Sie durch das Erstellen eines Messaging-Kanals, die Konfiguration des Event Relay und die Aktivierung des Kanals in Salesforce.

Nach Abschluss sollten Sie einen aktiven Messaging-Kanal mit einem laufenden Event Relay haben – eine Salesforce-Funktion, die Echtzeit-Plattformereignisse streamt und hier verwendet wird, um Nachrichten zwischen Fin und Salesforce zu übermitteln.

Übergabe an Salesforce-Agent

Der Schritt Hand-off to Salesforce agent in Fin Messenger-workflows unterstützt jetzt das Umschalten zwischen BYOC und Enhanced Chat. So können Sie steuern, welchen Kanal die Übergabe verwendet, während Sie testen, und schrittweise ohne Ausfallzeiten wechseln.

Der Fin Messenger Workflow-Editor zeigt den Schritt 'Hand-off to Salesforce agent' mit einem Umschalter zum Wechseln zwischen BYOC- und Enhanced Chat-Übergabemodi.

Sie können mehrere workflows mit unterschiedlicher Zielgruppen- und Umgebungssteuerung erstellen, um zu kontrollieren, welcher Traffic über BYOC läuft.
​


Oder Sie können den Schritt Branches in workflows mit der Variable Environment nutzen, um ihn zu einem Hand-off to Salesforce agent Schritt mit aktiviertem BYOC vs. einem mit deaktiviertem BYOC (d.h. Enhanced Chat) zu leiten.
​


FAQs

Wie lange dauert die Migration?

Die technischen Schritte dauern in der Regel 1–2 Stunden. Wenn Sie jedoch den vollständigen Testzyklus durchführen – zuerst Sandbox, dann UAT (User Acceptance Testing), dann Produktion – planen Sie 1–2 Werktage von Anfang bis Ende ein. Die Hauptvariable ist, wie viele Salesforce-Umgebungen Sie vor dem Livegang validieren.

Gibt es Ausfallzeiten?

Ausfallzeiten sind nicht zu erwarten. Der Schalter Use External Client App credentials kann jederzeit wieder deaktiviert werden, wenn etwas nicht stimmt, und sowohl Enhanced Chat als auch BYOC können während der Übergangsphase gleichzeitig laufen.

In welcher Reihenfolge sollte ich die Migration in die Produktion ausrollen?

Führen Sie die vollständige Migration zuerst in einer Sandbox- oder UAT-Organisation durch und validieren Sie diese. Dann in der Produktion:

  1. Installieren Sie das Fin for Salesforce Managed Package (Schritt 1).

  2. Erstellen Sie das neue Permission Set und weisen Sie beide Permission Sets dem Integrationsuser zu (Schritt 2). Behalten Sie das Legacy Permission Set vorerst zugewiesen, da das Migrationsskript es benötigt, um die alten Felder zu lesen.

  3. Verbinden Sie sich über die External Client App und aktivieren Sie Use External Client App credentials für Ihre Produktionsverbindung (Schritt 3).

  4. Stellen Sie die beiden Migrationsklassen aus einer Sandbox mit einem Change Set oder der Salesforce CLI bereit, führen Sie die Migration durch, prüfen Sie die Berichtsemail und löschen Sie dann die Klassen (Schritt 4).

  5. Weisen Sie das Legacy-Berechtigungsset ab, deinstallieren Sie das Legacy-Paket und widerrufen Sie die Connected App-Tokens (Schritt 5).

Es wird keine Ausfallzeit erwartet. Lassen Sie die Legacy Connected App-Tokens bestehen, bis Sie sicher sind, dass die External Client App-Verbindung funktioniert, da Fin sie verwendet, wenn Sie den Schalter wieder ausschalten.

Sind zusätzliche Salesforce-Lizenzen / Add-ons erforderlich?

Nur wenn Sie Fin Messenger verwenden, um Live-Chats an Agenten in Salesforce über BYOC weiterzugeben. Dafür benötigen Sie eine Salesforce-Lizenz, die BYOC beinhaltet, zum Beispiel das Digital Engagement SKU mit dem Partner Messaging Add-on oder eine neuere SKU, die BYOC enthält, wie Agentforce Contact Center Digital. Es ist egal, welche SKU, solange BYOC enthalten ist. Diese Lizenz benötigen Sie nicht, wenn Sie Fin nur für Salesforce Cases verwenden oder wenn Fin Messenger durch das Erstellen eines Salesforce Case weitergibt. Eine Möglichkeit zu prüfen, ob Sie die relevante Lizenz haben, ist,

  1. Gehen Sie zu Salesforce setup > Company Information

  2. Überprüfen Sie, ob Sie Partner Messaging User unter Permission Set Licenses und die Gesamtzahl der verfügbaren Lizenzen aufgeführt haben.

Wenden Sie sich an Ihren Salesforce Account Executive (AE), wenn Ihnen die Lizenz oder das Add-on fehlt oder um zu bestätigen, wie viele Lizenzen Sie für die Agenten benötigen, die Fin-Chats bearbeiten werden.

Besteht ein Risiko, bestehende Salesforce-Daten zu überschreiben?

  • Es besteht ein Risiko des Datenverlusts (insbesondere der Fin benutzerdefinierten Case-Felder) beim Deinstallieren des vorherigen unlocked/unmanaged Pakets.

  • Dies wird jedoch durch Ausführen des Apex-Migrationsskripts und/oder durch Herunterladen der Case-Daten als Teil der Deinstallation gemindert.

  • Mit dieser Migration ist kein Risiko verbunden, bestehende Salesforce-Daten zu überschreiben.

Hat dies deine Frage beantwortet?