Passer au contenu principal

Mise à niveau de votre connexion Salesforce pour utiliser l'External Client App et prendre en charge BYOC

Guide étape par étape pour mettre à niveau votre connexion Salesforce avec Fin afin d'utiliser l'External Client App et passer de Enhanced Chat à BYOC.

Bring Your Own Channel (BYOC) est une nouvelle méthode pour les clients Fin permettant d'activer Fin Messenger comme leur agent IA de chat en direct. Se connecter via BYOC plutôt que Enhanced Chat améliore la gestion de certains comportements des users, comme les conversations simultanées sur plusieurs onglets, pour que vous puissiez continuer à bénéficier du service de premier ordre de Fin. La migration est simple, utilisant des environnements de test avant le déploiement en production sans interruption. Suivez le guide ci-dessous pour l'implémenter sur votre espace de travail.

Utilisez cet article pour mettre à niveau votre connexion Fin for Salesforce existante afin d'utiliser la nouvelle External Client App (ECA). Ce guide s'adresse aux administrateurs Salesforce migrant un déploiement Fin for Salesforce existant — vous aurez besoin d'un accès admin Salesforce et d'un abonnement actif Fin for Salesforce. À la fin, vous aurez installé les packages gérés requis, connecté via la nouvelle ECA, configuré les permissions et — si vous utilisez Fin Messenger — établi une connexion de chat en direct entre Fin et Salesforce via Bring Your Own Channel (BYOC), le cadre d'intégration de canal standard de Salesforce pour connecter des fournisseurs de messagerie tiers.

Il y a 6 étapes à suivre :

  1. Connectez-vous à Salesforce via l'External Client App

  2. Configurez les permissions

  3. Passez à l'utilisation des identifiants External Client App

  4. Exécutez le script de migration Apex

  5. Désinstallez le package obsolète et déconnectez l'Connected App

  6. Mettez à jour votre déploiement Fin Messenger [optionnel]

Note : Si vous configurez Fin uniquement pour gérer les cas Salesforce (sans messagerie), vous pouvez ignorer la section Mises à jour de Fin Messenger ci-dessous.


Étape 1 : Connectez-vous à Salesforce via l'External Client App

Allez dans Connect dans votre espace de travail Fin, puis cliquez sur l'onglet Bring Your Own Channel.

Cet onglet sert de page de migration pour passer à la nouvelle External Client App (ECA) — une méthode d'authentification basée sur OAuth 2.0 avec des identifiants client qui remplace l'ancienne Connected App (une intégration OAuth plus ancienne nécessitant de stocker les identifiants users).

Vous verrez vos connexions existantes listées comme Not Connected dans cet onglet. Le statut de connexion concerne l'External Client App.

Suivez les étapes ci-dessous pour installer un package géré dans Salesforce. Le package géré installe l'External Client App, ainsi que toutes les permissions et champs dont Fin a besoin pour fonctionner.

  1. Cliquez sur le bouton Connect sur toute connexion existante que vous souhaitez connecter (test ou production), puis cliquez sur Install Package.

  2. Sélectionnez Install for all users. Cela signifie que le jeu de permissions peut être attribué à n'importe quel user dans votre organisation Salesforce si vous le souhaitez.

  3. Attendez la fin de l'installation. Aucune erreur ne doit apparaître.

  4. Une fois l'installation terminée, retournez à la page Connect et cliquez sur le bouton Connect to Salesforce à l'Étape 2, puis autorisez l'établissement de la connexion.

Le package géré Fin for Salesforce est une version publiée qui s'installe à la fois dans les organisations sandbox et production. Après installation, il apparaît dans Installed Packages avec l'espace de noms finai et Fin comme éditeur.


Étape 2 : Configurez les permissions

Allez dans Connect > External Client App (Tab) > Assign permissions in Salesforce depuis votre espace de travail Fin et suivez les étapes pour créer un nouveau jeu de permissions et attribuer toutes les permissions dont Fin a besoin pour fonctionner.

Créez un nouveau jeu de permissions

  1. Dans Salesforce, créez un nouveau jeu de permissions. Le libellé et le nom API peuvent être quelconques — ce jeu de permissions sera uniquement attribué à l'utilisateur d'intégration.

  2. Lors de la sélection d'une licence, assurez-vous d'en choisir une qui inclut la permission Set Audit Fields upon Record Creation, par exemple la licence Salesforce. Certaines licences ne comprennent pas cette permission.

  3. Enregistrez le nouveau jeu de permissions.

L'écran Nouveau Jeu de Permissions Salesforce, montrant le menu déroulant Licence réglé sur 'Salesforce' — le type de licence qui inclut la permission requise 'Set Audit Fields upon Record Creation'.

Note : Toutes les licences Salesforce n'incluent pas la permission Set Audit Fields upon Record Creation. Si cette option n'est pas disponible pour une licence que vous envisagez, choisissez un autre type de licence (comme la licence Salesforce standard) qui l'inclut.

Attribuez les jeux de permissions à l'utilisateur d'intégration

Le jeu de permissions existant Fin for Salesforce permissions et le nouveau jeu de permissions doivent tous deux être attribués à l'utilisateur d'intégration.

  1. Dans Salesforce, accédez au profil de l'utilisateur d'intégration.

  2. Allez dans Permission Set Assignments et cliquez sur Edit Assignments.

  3. Ajoutez à la colonne Enabled Permission Sets à la fois le jeu de permissions Fin for Salesforce permissions et le nouveau jeu de permissions, puis cliquez sur Save.

L'écran Permission Set Assignments de Salesforce pour l'utilisateur d'intégration, montrant à la fois 'Fin for Salesforce permissions' et le nouveau jeu de permissions déplacés dans la colonne Enabled Permission Sets.


Étape 3 : Passez à l'utilisation des identifiants External Client App

Vous pouvez passer à l'utilisation des identifiants External Client App pour une connexion Salesforce en activant Use External Client App credentials lors de la gestion d'une connexion sous Connect > External Client App (Tab).

Une fois activé, Fin utilise les identifiants External Client App pour toutes ses requêtes vers Salesforce, y compris :

  • Les requêtes pour obtenir le statut de la connexion.

  • La création d'un cas Salesforce via l'étape workflow.

  • La création d'un cas Salesforce lors de la résolution Fin ou de l'inactivité de l'user.

  • La réponse aux cas créés via le canal Salesforce cases

  • L'importation d'articles Knowledge

  • L'importation des cas Salesforce historiques

Une fois activé, vous pouvez le désactiver si vous pensez qu'il y a un problème. Cela vous permet de tester dans chaque environnement — sandbox, UAT (test d'acceptation utilisateur) et production — et de gagner en confiance avec les nouveaux identifiants ECA, sans perturber les anciens identifiants Connected App.

Une fois que toutes les connexions ont Use External Client App credentials activé, la migration est terminée. Le statut de connexion pour chaque entrée passe à Connected dans l'onglet External Client App. Suivez les étapes ci-dessous pour migrer vos données et nettoyer le package obsolète une fois que vous êtes sûr que tous les systèmes fonctionnent comme prévu.


Étape 4 : Exécutez le script de migration Apex

Lorsque vous installez le package géré de base Fin for Salesforce, il installe de nouveaux champs Fin Case qui sont dans l'espace de noms finai. L'espace de noms signifie que chaque nom de champ est préfixé par finai__ (par exemple, finai__FinConversationId__c) pour éviter les conflits de noms avec d'autres packages ou champs personnalisés dans votre organisation.

Dans le cadre de la migration, utilisez le script de migration Apex pour déplacer vos données de cas existantes des anciens champs sans espace de noms vers les nouveaux champs avec espace de noms. Le package Fin for Salesforce inclut une classe Apex préconstruite appelée FinCaseFieldMigrator.cls qui gère la logique de migration.

Apex à l'intérieur d'un package géré résout les noms de champs personnalisés non qualifiés en fonction de son propre namespace. Une requête pour FinConversationId__c exécutée à l'intérieur du package finai retourne finai__FinConversationId__c à la place, donc le code packagé ne peut pas lire du tout les champs legacy, et nommer les deux dans une même requête échoue carrément avec une erreur duplicate field selected. La migration fetch doit donc être exécutée depuis l'extérieur du package — c'est pourquoi vous devez ajouter manuellement les classes ci-dessous dans votre org. Les classes elles-mêmes ne contiennent aucune logique de migration ; elles appellent la classe de migration installée par le package géré et l'exécutent par lots de 200 enregistrements à la fois.

Vous ajouterez deux classes Apex à votre org, exécuterez la migration une fois, puis supprimerez les deux classes une fois qu'elles ne seront plus nécessaires :

  • FinCaseFieldMigration exécute la migration.

  • FinCaseFieldMigrationTest est son test. Salesforce ne déploiera pas Apex en production sans test, et celui-ci vérifie aussi que votre org est correctement configuré avant toute exécution.

4a. Copiez les deux classes

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. Ajoutez les classes à votre organisation Salesforce

La manière de procéder dépend de l'organisation que vous migrez.

Migration d'un sandbox

  1. Allez dans Setup > Apex Classes et cliquez sur New.

  2. Collez le code de FinCaseFieldMigration et cliquez sur Save.

  3. Cliquez de nouveau sur New, collez le code de FinCaseFieldMigrationTest, puis cliquez sur Save.

  4. Cliquez sur Run All Tests, ou ouvrez FinCaseFieldMigrationTest et cliquez sur Run Test, puis confirmez que le test réussit.

Migration en production avec un change set (sans ligne de commande)

Les orgs de production ne permettent pas de créer des classes Apex dans Setup, créez-les donc dans un sandbox et déployez-les depuis là.

  1. Dans un sandbox connecté à la production, avec le nouveau package installé, créez les deux classes comme décrit ci-dessus.

  2. Dans le sandbox, allez dans Setup > Outbound Change Sets et cliquez sur New. Ajoutez les deux classes Apex et cliquez sur Upload, en choisissant votre org de production comme cible.

  3. En production, allez dans Setup > Deployment Settings et assurez-vous que votre sandbox est autorisé à envoyer des changements entrants.

  4. En production, allez dans Setup > Inbound Change Sets, ouvrez le change set, et cliquez sur Deploy.

  5. Sous Choose a Test Option, sélectionnez Run specified tests, entrez FinCaseFieldMigrationTest, puis cliquez sur Deploy.

Migration en production avec la Salesforce CLI

Enregistrez chaque classe en tant que fichier .cls dans un dossier case-field-migration/classes/. À côté de chaque fichier, ajoutez un fichier .cls-meta.xml portant le même nom (par exemple FinCaseFieldMigration.cls-meta.xml) contenant :
​

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

Puis exécutez :

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

Ce qu'un déploiement réussi vous indique : pendant le déploiement, le test crée un Case temporaire, le migre, et vérifie que la valeur est bien arrivée sur le nouveau champ. Salesforce annule ensuite les données de test. Donc un déploiement réussi signifie que la migration fonctionne déjà dans votre org. Si le déploiement échoue, le message d'erreur indique pourquoi, par exemple un package manquant ou un jeu de permissions manquant.

4c. Exécutez la migration

  1. Allez dans Salesforce setup > Developer Console

  2. Cliquez sur Debug > Open Execute Anonymous Window

  3. Collez le code ci-dessous, cliquez sur Execute

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


    La migration traite par défaut 200 Cases par lot. Si votre org a des triggers, flows ou autres automatisations sur Case qui atteignent les limites de gouverneur à cette taille, utilisez une taille de lot plus petite :

    FinCaseFieldMigration.run(50);

4d. Vérifiez le résultat

  • Setup > Apex Jobs affiche la progression du job FinCaseFieldMigration.

  • Lorsque le job se termine, l'administrateur qui l'a lancé reçoit un email de rapport. Il liste chaque Case ignoré ou échoué, avec le champ et la raison.

Lisez le rapport plutôt que de supposer que l'exécution a fonctionné. Si un jeu de permissions manquait lors de l'exécution, le job peut se terminer « avec succès » sans rien copier. Le rapport vous dira quels champs ont été ignorés.

Vous pouvez relancer la migration sans risque. Elle ne remplit que les nouveaux champs encore vides, donc une deuxième exécution ne met à jour aucun enregistrement.

Ce que la migration ne fait pas :

  • Elle ne supprime ni ne modifie rien sur les anciens champs.

  • Elle ne peut pas être annulée.

  • Les deux cases à cocher, Fin Involved et Fin Marked As Spam, ne sont copiées que lorsque l'ancienne valeur est cochée. Une case décochée ne peut pas être distinguée d'une case jamais définie, donc elle n'est pas copiée. Dans tous les cas, le nouveau champ reste décoché.

4e. Supprimez les classes

Une fois que le rapport montre une exécution propre, supprimez FinCaseFieldMigration et FinCaseFieldMigrationTest. Ne sautez pas cette étape : tant que ces classes sont dans votre org, Salesforce ne vous permettra pas de désinstaller le package Fin for Salesforce.

  • Sandbox : allez dans Setup > Apex Classes et cliquez sur Del à côté de chaque classe.

  • Production : Apex ne peut pas être supprimé via Setup en production, utilisez donc la Salesforce CLI.

    • Dans un dossier vide, créez 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>

    • Puis créez un fichier package.xml dans le même dossier :

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

    • Depuis ce dossier, exécutez :

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

      Cela exécute les tests existants de votre org, comme tout déploiement en production. S'il échoue sur un test autre que FinCaseFieldMigrationTest, le problème vient de ce test, pas de la migration. Corrigez-le comme pour tout autre déploiement.


Étape 5 : Désinstallez le package obsolète et déconnectez l'application connectée

Une fois le nouveau package géré installé, toutes les connexions sont basculées vers les identifiants ECA, et les données des champs Fin Case ont été migrées vers les nouveaux champs avec namespace, désinstallez le package déverrouillé ou non géré précédent et révoquez la connexion de l'application connectée legacy.

Quel package désinstaller : Votre org a maintenant deux packages Fin. Désinstallez uniquement le package déverrouillé legacy, qui n'a pas de préfixe namespace et Intercom comme éditeur. Il peut être listé comme Fin for Salesforce ou sous un autre nom, comme IntercomFinAIPermissions. Gardez le nouveau package géré, qui a le namespace finai et Fin comme éditeur.

Désaffecter le PermissionSet hérité

Le PermissionSet hérité (un objet Salesforce qui accorde aux users l'accès à des fonctionnalités et champs spécifiques) doit être désaffecté avant que le package puisse être désinstallé.

Le package hérité et le nouveau package géré incluent tous deux un permission set intitulé Fin for Salesforce permissions. Désaffectez uniquement celui hérité, qui n'a pas de préfixe de namespace. Gardez finai__Fin_for_Salesforce_permissions assigné à l'utilisateur d'intégration.

Si vous voyez d'autres permission sets liés à Fin qui ne font partie d'aucun des deux packages, ils ont probablement été créés manuellement dans votre org. Vous pouvez les supprimer une fois que Fin fonctionne sur l'External Client App, tant qu'aucun user n'y est encore assigné.

  1. Allez dans Salesforce setup > Installed Packages

  2. Cliquez sur le package déverrouillé hérité Fin for Salesforce (sans préfixe de namespace)

  3. Cliquez sur View Components

  4. Cliquez sur le PermissionSet Fin_for_Salesforce_permissions, cela devrait vous amener à la page du PermissionSet.

  5. Cliquez sur Manage Assignments

  6. Sélectionnez tous les users Salesforce assignés

  7. Cliquez sur le bouton Remove Assignment

Désinstallez le package et sauvegardez les données

  1. Allez dans Salesforce setup > Installed Packages

  2. Cliquez sur Uninstall à côté du package déverrouillé hérité Fin for Salesforce (sans préfixe de namespace)

    La page Salesforce Installed Packages avec le package déverrouillé Fin for Salesforce listé et un bouton 'Uninstall' visible à sa droite.
  3. Sélectionnez Save a copy of this package's data for 48 hours after uninstall cela sauvegardera toutes les données des champs de cas sous forme de csv avec une colonne pour l'ID du cas Salesforce.

    Important : Salesforce conserve l'export des données sauvegardées pendant 48 heures seulement après la désinstallation. Téléchargez le CSV avant la fin de ce délai. Si vous avez déjà exécuté avec succès le script de migration Apex, vous n'aurez pas besoin de restaurer à partir de ce fichier — mais c'est une sécurité utile.

  4. Attendez d'être notifié que la désinstallation du package est terminée avec succès.

  5. Retournez dans Salesforce setup > Installed Packages, vous devriez voir le package désinstallé listé sous Uninstalled Packages.

  6. Cliquez sur Data, cela téléchargera toutes les données de cas sous forme de csv stocké dans un fichier zip. Conservez ce fichier zip en lieu sûr car il pourrait servir à restaurer les données si nécessaire. Mais si vous avez exécuté le script de migration Apex, tout devrait être prêt.

    La liste Salesforce Uninstalled Packages montrant le package Fin for Salesforce avec un lien de téléchargement 'Data', utilisé pour télécharger l'export CSV sauvegardé des données des champs de cas dans la fenêtre de 48 heures.

Révoquer la connexion Connected App

Les tokens Connected App sont stockés séparément dans chaque org Salesforce, donc les révoquer dans un sandbox ou org UAT n'affecte pas votre connexion de production. Dans chaque org, ne révoquez les tokens que lorsque la connexion Fin a activé Use External Client App credentials et fonctionne comme prévu.

  1. Allez dans Salesforce setup > Connected Apps OAuth Usage

  2. Cliquez sur le lien numérique sous la colonne User Count pour la Connected App Fin for Salesforce. Cela vous redirigera vers Connected App User's Usage.

    La page Salesforce Connected Apps OAuth Usage montrant la Connected App Fin for Salesforce avec un lien numérique dans la colonne User Count, qui ouvre l'écran Connected App User's Usage.
  3. Cliquez sur Revoke à côté de chaque user listé. Cela supprime les tokens d'accès OAuth stockés dans le cadre de la connexion Connected App héritée. Une fois révoqués, ces users n'apparaissent plus dans la liste.

    L'écran Salesforce Connected App User's Usage montrant les entrées utilisateurs individuelles avec un lien d'action 'Revoke' à côté de chacun, utilisé pour supprimer les tokens d'accès OAuth hérités.


Étape 6 : Mettez à jour votre déploiement Fin Messenger

Suivez ces étapes uniquement si vous avez l'intention d'utiliser Fin for Salesforce avec Messaging.

Cette section explique comment connecter Fin en tant que partenaire Bring Your Own Channel (BYOC) dans Salesforce, et comment migrer les workflows de transfert Enhanced Chat existants pour utiliser BYOC à la place.

Connecter Fin à Bring Your Own Channel

Pour établir la connexion BYOC entre Fin et Salesforce, suivez l'Étape 1 de l'article Fin Messenger : Configuration avec Salesforce. Cette étape vous guide pour créer un canal Messaging, configurer l'Event Relay, et activer le canal dans Salesforce.

Une fois terminé, vous devriez avoir un canal Messaging actif avec un Event Relay en fonctionnement — une fonctionnalité Salesforce qui diffuse en temps réel des événements de plateforme, utilisée ici pour transmettre des messages entre Fin et Salesforce — entre Fin et Salesforce.

Transfert à un agent Salesforce

L'étape Hand-off to Salesforce agent dans les workflows Fin Messenger prend désormais en charge l'alternance entre BYOC et Enhanced Chat. Cela vous permet de contrôler quel canal le transfert utilise pendant les tests, pour une transition progressive sans interruption.

L'éditeur de workflow Fin Messenger montrant l'étape 'Hand-off to Salesforce agent', avec un interrupteur pour basculer entre les modes de transfert BYOC et Enhanced Chat.

Vous pouvez créer plusieurs workflows avec des ciblages d'audience et d'environnement différents pour contrôler le trafic passant par BYOC
​


Ou vous pouvez exploiter l'étape Branches dans les workflows avec la variable Environment pour la diriger vers une étape Hand-off to Salesforce agent avec BYOC activé vs une avec BYOC désactivé (c'est-à-dire Enhanced Chat)
​


FAQ

Combien de temps prend la migration ?

Les étapes techniques elles-mêmes prennent généralement 1 à 2 heures. Cependant, si vous effectuez le cycle complet de tests — sandbox d'abord, puis UAT (user acceptance testing), puis production — prévoyez 1 à 2 jours ouvrables au total. La principale variable est le nombre d'environnements Salesforce validés avant la mise en production.

Y a-t-il une interruption de service ?

Aucune interruption n'est prévue. L'interrupteur Use External Client App credentials peut être désactivé à tout moment si quelque chose semble incorrect, et Enhanced Chat ainsi que BYOC peuvent fonctionner simultanément pendant la transition.

Dans quel ordre dois-je déployer la migration en production ?

Complétez et validez d'abord la migration complète dans un sandbox ou org UAT. Ensuite, en production :

  1. Installez le package géré Fin for Salesforce (Étape 1).

  2. Créez le nouveau permission set et assignez les deux permission sets à l'utilisateur d'intégration (Étape 2). Gardez le permission set hérité assigné pour l'instant, car le script de migration en a besoin pour lire les anciens champs.

  3. Connectez-vous via l'External Client App et activez Use External Client App credentials pour votre connexion de production (Étape 3).

  4. Déployez les deux classes de migration depuis un sandbox en utilisant un change set ou le Salesforce CLI, exécutez la migration, vérifiez le rapport par email, puis supprimez les classes (Étape 4).

  5. Désattribuez l'ensemble d'autorisations hérité, désinstallez le package hérité et révoquez les jetons de l'application connectée (Étape 5).

Aucune interruption n'est prévue. Laissez les jetons de l'application connectée héritée en place jusqu'à ce que vous soyez sûr que la connexion de l'application client externe fonctionne, car Fin les utilise si vous réactivez le bouton.

Des licences Salesforce supplémentaires ou des add-ons sont-ils nécessaires ?

Uniquement si vous utilisez Fin Messenger pour transférer les chats en direct aux agents dans Salesforce via BYOC. Pour cela, vous avez besoin d'une licence Salesforce incluant BYOC, par exemple le Digital Engagement SKU with the Partner Messaging add-on, ou un SKU plus récent incluant BYOC comme Agentforce Contact Center Digital. Peu importe le SKU, tant qu'il inclut BYOC. Vous n'avez pas besoin de cette licence si vous utilisez Fin uniquement pour les Cases Salesforce, ou si Fin Messenger transfère en créant un Case Salesforce. Une façon de vérifier si vous avez la licence pertinente est la suivante,

  1. Allez dans Salesforce setup > Company Information

  2. Vérifiez si vous avez Partner Messaging User listé sous Permission Set Licenses ainsi que le nombre total de licences disponibles.

Contactez votre Account Executive (AE) Salesforce si la licence ou l'add-on vous manque, ou pour confirmer le nombre de licences nécessaires pour les agents qui géreront les chats Fin.

Y a-t-il un risque d'écraser les données Salesforce existantes ?

  • Il existe un risque de perte de données (notamment les champs personnalisés Case de Fin) lors de la désinstallation du package précédent non verrouillé/non géré.

  • Cependant, ce risque est atténué par l'exécution du script de migration Apex et/ou par le téléchargement des données Case dans le cadre de la désinstallation.

  • Il n'y a pas de risque lié à l'écrasement des données Salesforce existantes avec cette migration spécifiquement.

Avez-vous trouvé la réponse à votre question ?