Passer au contenu principal

Fin pour le package géré Salesforce

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 géré Fin pour Salesforce donne à Fin les autorisations 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 géré 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 géré installe les composants suivants :

Quels champs personnalisés le package Fin pour Salesforce ajoute-t-il à Salesforce ?

Le package géré 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'identifiant de conversation pour 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
      (Nom API : soft_resolution)

    • Résolution dure
      (Nom API : hard_resolution)

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

    • Abandonné
      (Nom API : 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 autorisations le package Fin pour Salesforce requiert-il ?

Le package géré 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 autorisations minimales nécessaires à Fin pour gérer les cas, et inclut :

Autorisations 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)

  • Compte : Lire, Modifier (pas de Création/Suppression, pas de Modification/Vue de tous les enregistrements)

Autorisations 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 Tâche : ActivityDate, Description, Type, WhatId, WhoId

Autorisations système

  • API Enabled

  • Can Insert Feed System Fields

  • Edit Task

  • View All Users

  • View Roles

  • View Setup

Changelog

v1.0 - Version 1

  • Crée 4 champs personnalisés pour les cas FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c et FinConversationId__c

  • Crée un ensemble d'autorisations nommé Fin for Salesforce permissions


FAQs

Comment installer le package Fin pour Salesforce ?

Le package géré s'installe via la page Connect dans votre espace de travail Fin. Allez dans Connect, cliquez sur le bouton Connect à côté du type d'organisation que vous souhaitez connecter, puis cliquez sur Install Package. Sélectionnez Install for all users et attendez la fin de l'installation.

Que faire si je ne souhaite pas installer le package ?

Si vous préférez ne pas installer le package déverrouillé, 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-t-il à 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 autorisations d'objet, d'accès aux champs et système listées dans la section « Quelles autorisations 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 Assign permissions in Salesforce dans votre flux Connect.

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

  4. Les futures mises à jour du package seront documentées dans le changelog.

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 e-mail lorsque votre export de données sera prêt. Téléchargez les données sauvegardées des champs au format .csv en cliquant sur Data dans l'écran d'export de données Salesforce, comme illustré ci-dessous.

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

  5. Allez dans Connect > Assign permissions in Salesforce dans votre espace de travail Fin

  6. Suivez les étapes de l'article How to connect Fin to Salesforce pour installer le package géré et compléter la connexion.

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 et FinResolutionState__c.

Approche optionnelle :

Ajoutez ou mettez à jour manuellement les composants du package géré documentés dans cet article. Les mises à jour du package géré seront documentées ici dans le changelog.

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 autorisations supplémentaires. La migration vers le package géré est la voie recommandée pour rester à jour. Les ajouts futurs seront documentés dans le changelog ci-dessus.

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