Passer au contenu principal

Fin pour Salesforce package unlocked

Cet article s'adresse aux administrateurs système Salesforce configurant Fin AI Agent avec Salesforce Cases ou Fin Messenger. Disponible sur les plans incluant l'intégration Salesforce — vérifiez votre plan Intercom si vous n'êtes pas sûr.

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

  • Type : Case à cocher

  • Libellé : FinInvolved

  • Valeur par défaut : false

FinResolutionState__c

Indique l'état de résolution de Fin

  • Type : Liste de sélection

  • Libellé : FinResolutionState

  • Valeurs :

    • Résolution douce
      (API Name : soft_resolution)

    • Résolution dure
      (API Name : hard_resolution)

    • Dirigé vers l'équipe
      (API Name : routed_to_team)

    • Abandonné
      (API Name : abandoned_negative_feedback)

FinMarkedAsSpam__c
Indique si la conversation a été marquée comme spam par Fin

  • Type : Case à cocher

  • Libellé : FinMarkedAsSpam

  • Valeur par défaut : false

FinConversationId__c
Stocke l'identifiant de la conversation pour le lien avec la plateforme Fin

  • Libellé : FinConversationId

  • Longueur : 255 caractères

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__c

  • Cré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 :

  1. 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é.

  2. 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.

  3. Attribuez le PermissionSet à l'utilisateur Salesforce qui a connecté Fin à Salesforce.

  4. 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 :

  1. Mettez Fin en pause.

  2. Désattribuez l'utilisateur Salesforce du PermissionSet Intercom Fin AI permission, cela vous permettra de désinstaller le package non géré.

  3. 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.

    L'écran de désinstallation Salesforce, montrant l'option de conserver et sauvegarder les données des champs avant de désinstaller le package non géré. Sélectionnez cette option pour éviter de perdre les valeurs FinInvolved__c et FinResolutionState__c.

  4. 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.

    L'écran d'export de données Salesforce après désinstallation, montrant le bouton Données utilisé pour télécharger les valeurs FinInvolved__c et FinResolutionState__c sauvegardées au format .csv.

  5. Allez dans Paramètres > Intégration Salesforce > Installer et attribuer les permissions dans Salesforce

  6. 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.

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