Le package unlocked Fin pour Salesforce donne à Fin les permissions Salesforce et les champs personnalisés nécessaires pour créer, lire et mettre à jour les cas Salesforce au nom de vos clients. Un package unlocked est un conteneur de métadonnées Salesforce — champs, ensembles d'autorisations et configuration associée — qui est automatiquement ajouté à votre organisation Salesforce lors de son installation. Le package unlocked installe les composants suivants :
Quels champs personnalisés le package Fin pour Salesforce ajoute-t-il à Salesforce ?
Le package unlocked ajoute quatre champs personnalisés à l'objet Case de Salesforce. Ces champs permettent à Fin de suivre son implication, l'état de résolution, la détection de spam et l'ID de conversation sur chaque cas. Si vous créez ces champs manuellement au lieu d'installer le package, les noms API doivent correspondre exactement.
Nom du champ | Métadonnées |
FinInvolved__c Indique si Fin a été impliqué dans ce cas |
|
FinResolutionState__c Indique l'état de résolution de Fin |
|
FinMarkedAsSpam__c |
|
FinConversationId__c |
|
Note : FinConversationId__c est un champ Texte (type : Texte, longueur max : 255 caractères). Assurez-vous qu'il est correctement configuré lors de la création manuelle du champ.
Quelles permissions le package Fin pour Salesforce requiert-il ?
Le package unlocked Fin pour Salesforce crée un PermissionSet nommé Fin for Salesforce permissions (nom API : Fin_for_Salesforce_permissions). Ce PermissionSet doit être attribué à l'utilisateur Salesforce qui connecte Fin à votre organisation Salesforce. Il accorde les permissions minimales nécessaires à Fin pour gérer les cas, et inclut :
Permissions d'objet
Case : Créer, Lire, Modifier (pas de Suppression, pas de Modification/Vue de tous les enregistrements)
Contact : Lire, Modifier (pas de Création/Suppression, pas de Modification/Vue de tous les enregistrements)
Account : Lire, Modifier (pas de Création/Suppression, pas de Modification/Vue de tous les enregistrements)
Permissions de champ (accès Lecture et Modification)
Champs Case : ContactId, Description, FinInvolved__c, FinMarkedAsSpam__c, FinConversationId__c, FinResolutionState__c, Origin, SourceId, Subject, SuppliedEmail, SuppliedName
Champs Contact : Email
Champs Task : ActivityDate, Description, Type, WhatId, WhoId
Permissions système
API Enabled
Peut insérer des champs système de flux
Modifier la tâche
Voir tous les Users
Voir les rôles
Voir la configuration
Journal des modifications
v1.0 - Version 1
Crée 4 champs personnalisés Case
FinInvolved__c,FinResolutionState__c,FinMarkedAsSpam__c&FinConversationId__cCrée 1 permission set nommé
Fin for Salesforce permissions
FAQ
Comment installer le package Fin pour Salesforce ?
Le package est lié à l'étape de déploiement dans le canal Fin Messenger et Salesforce Cases. Vous pouvez aussi l'installer via les liens ci-dessous
OU
Que faire si je ne veux pas installer le package ?
Si vous préférez ne pas installer le package unlocked, vous pouvez créer manuellement les mêmes composants Salesforce. Suivez ces étapes pour configurer Fin pour Salesforce sans installer le package :
Créez les quatre champs personnalisés Case définis dans la section « Quels champs personnalisés le package Fin pour Salesforce ajoute à Salesforce ? » de cet article : FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c et FinConversationId__c. Les noms API doivent correspondre exactement comme documenté.
Créez un PermissionSet avec les permissions d'objet, de champ et système listées dans la section « Quelles permissions le package Fin pour Salesforce requiert-il ? » de cet article. Le nom API du PermissionSet doit être exactement Fin_for_Salesforce_permissions. Cela débloquera l'étape Installer et attribuer les permissions dans Salesforce dans votre flux de déploiement.
Attribuez le PermissionSet à l'utilisateur Salesforce qui a connecté Fin à Salesforce.
Les futures mises à jour du package seront documentées dans le journal des modifications.
Comment migrer depuis le package non géré ?
Approche recommandée :
Mettez Fin en pause.
Désattribuez l'utilisateur Salesforce du PermissionSet Intercom Fin AI permission, cela vous permettra de désinstaller le package non géré.
Désinstallez le package non géré. Lors de la désinstallation, Salesforce vous invitera à sauvegarder vos données — sélectionnez cette option, car vous perdrez définitivement les valeurs stockées dans FinInvolved__c et FinResolutionState__c si vous la sautez. La capture d'écran ci-dessous montre l'écran de désinstallation Salesforce où vous sélectionnez l'option de conservation des données.
Une fois la désinstallation terminée, Salesforce vous enverra un email lorsque votre export de données sera prêt. Téléchargez les données de champ sauvegardées au format .csv en cliquant sur Données dans l'écran d'export de données Salesforce, comme montré ci-dessous.
Allez dans Paramètres > Intégration Salesforce > Installer et attribuer les permissions dans Salesforce
Cliquez sur Installer Fin pour Salesforce
Une fois installé, vous pouvez utiliser le DataLoader pour importer le fichier csv de l'étape 4 et mettre à jour vos Cases avec FinInvolved__c & FinResolutionState__c.
Approche optionnelle :
Ajoutez ou mettez à jour manuellement les composants du package unlocked documentés dans cet article. Les mises à jour du package unlocked seront documentées ici dans le journal des modifications.
Note : Le package non géré ne supporte pas les mises à jour. Cela signifie que les nouveaux champs et composants ajoutés dans les futures versions — tels que FinMarkedAsSpam__c et FinConversationId__c — ne seront pas automatiquement disponibles pour les organisations encore sur le package non géré. Bien que Fin continue de fonctionner pour les fonctionnalités existantes, vous manquerez les nouvelles fonctionnalités nécessitant des champs ou permissions supplémentaires. La migration vers le package unlocked est la voie recommandée pour rester à jour. Les ajouts futurs seront documentés dans le journal des modifications ci-dessus.


