Pour permettre une automatisation fluide et des expériences de support intelligentes, Fin s'intègre profondément à votre instance Salesforce. Cette intégration nécessite des autorisations spécifiques au niveau des objets et des champs, qui permettent à Fin de créer, mettre à jour et synchroniser les données avec Salesforce.
Cet article vous guidera à travers :
Pourquoi ces autorisations sont importantes
Qui en a besoin
Quelles autorisations l'utilisateur OAuth requiert
Comment configurer les autorisations
Comment se connecter à l'API Enhanced Chat de Salesforce pour Fin Messenger
Un tableau de référence complet des autorisations requises
Pourquoi ces autorisations sont importantes
Fin s'appuie sur les données Salesforce pour créer des cas, publier des résumés, lire les informations de contact et acheminer les conversations vers les agents. Sans les autorisations appropriées, Fin peut être incapable d'interagir efficacement avec votre environnement Salesforce, ce qui entraîne des synchronisations échouées, des automatisations bloquées ou des fonctionnalités limitées.
Qui a besoin de ces autorisations
Deux utilisateurs Salesforce clés sont impliqués dans l'intégration :
L'utilisateur OAuth Salesforce – celui lié lors de la configuration de l'intégration
L'utilisateur assigné comme Fin – l'utilisateur que Fin imite lorsqu'il répond, publie ou effectue des actions dans les workflows
Quelles autorisations l'utilisateur OAuth requiert
Votre organisation Salesforce doit avoir l'API activée - voir Erreur Salesforce 'API not enabled for this Organization or Partner'
L'utilisateur qui se connecte à Salesforce ne doit pas avoir de restrictions API - voir Restreindre l'accès aux API avec les applications connectées
L'utilisateur qui se connecte à Salesforce doit avoir l'autorisation Approve Uninstalled Connected Apps activée. Cela est nécessaire pour autoriser les applications tierces lors de la configuration de l'intégration.
Comment configurer les autorisations
Accédez à Connect > Installer et attribuer les autorisations dans Salesforce.
Suivez les étapes pour installer un package déverrouillé dans Salesforce avec toutes les autorisations et champs nécessaires pour que Fin fonctionne.
Lancez l'installation du package d'autorisations.
Dans la section Que faire si les noms des composants existants entrent en conflit avec ceux de ce package ?, sélectionnez Ne pas installer.
Sélectionnez Installer pour tous les users – cela signifie que l'ensemble d'autorisations peut être attribué à n'importe quel user si vous le souhaitez.
Attendez la fin de l'installation - aucune erreur ne doit apparaître.
Fin Messenger : Se connecter à l'API Enhanced Chat de Salesforce
Note : Cette section est uniquement requise si vous utilisez Fin Messenger. Si vous configurez Fin pour gérer uniquement les cas Salesforce, vous pouvez passer cette section.
Pour que Fin puisse transférer les chats en direct à votre équipe dans Salesforce, une connexion à l'API Enhanced Chat est nécessaire. Cela requiert la mise en place d'un déploiement de service intégré dans Salesforce.
Allez dans le déploiement de service intégré dans Salesforce.
Cliquez sur Nouveau déploiement.
Cliquez sur Messagerie pour In-App et Web.
Choisissez Client personnalisé.
Donnez-lui un nom (par exemple « Fin »), sélectionnez votre canal de messagerie, puis enregistrez. Si vous n'avez pas encore de canal de messagerie, vous devrez en créer un.
Accédez à votre nouveau client personnalisé, et cliquez sur le bouton publier en haut à droite.
Sélectionnez Extrait de code.
Copiez le nom du développeur et l'URL.
Allez dans Connect > Connect to the Salesforce Enhanced Chat API dans votre espace de travail Fin.
Copiez le nom du développeur et l'URL dans le formulaire de la section « Connect ».
Cliquez sur Connect to Enhanced Chat API.
Configurer et attribuer l'ensemble d'autorisations
Maintenant que vous avez installé l'ensemble d'autorisations dans Salesforce, vous devez l'attribuer à l'utilisateur qui a autorisé la connexion à Fin.
Dans vos paramètres Salesforce Setup > Interface utilisateur, activez Définir les champs d'audit lors de la création et de la mise à jour des enregistrements avec des propriétaires inactifs.
Dans vos Salesforce Setup > Permission Sets, trouvez Fin for Salesforce permissions et activez Définir les champs d'audit lors de la création d'enregistrements.
Dans Salesforce, accédez à l'utilisateur qui a autorisé la connexion à Fin
Depuis son profil, faites défiler jusqu'à la section Assignations d'ensembles d'autorisations et cliquez sur Modifier les assignations
Sélectionnez Intercom Fin for Salesforce permissions et attribuez l'ensemble d'autorisations
Note : Il est recommandé d'activer les champs d'audit afin que les éléments du fil d'actualité et les messages électroniques soient correctement attribués à Fin.
Autorisations Salesforce requises
Objet Salesforce | Champs | Opérations | Qui en a besoin | Pourquoi c'est nécessaire |
EmailMessage | Id, FromName, FromAddress, ToAddress, Subject, ThreadIdentifier, HtmlBody, TextBody, CreatedById, CreatedDate, Incoming, ParentId, LastModifiedDate, LastModifiedById | Créer, Lire | Utilisateur connecté, Fin | Utilisé pour créer des messages et des réponses pour les workflows email-to-case |
CaseFeed | Id, Title, Body, Type, CreatedBy.*, CreatedDate, Visibility, ParentId, LastModifiedDate | Lire | Utilisateur connecté | Nécessaire pour suivre l'activité des cas |
FeedItem | Id, Body, ParentId, IsRichText, Type, Visibility, CreatedDate, CreatedById, LastEditById | Créer | Utilisateur connecté, Fin | Ajoute des transcriptions de conversation et des résumés AI aux cas |
Case | Id, Subject, Description, ContactId, OwnerId, SuppliedEmail, SuppliedName, Origin, SourceId, FinInvolved__c, FinResolutionState__c, FinMarkedAsSpam__c, FinConversationId__c | Créer, Lire, Mettre à jour | Tous les rôles | Création, transfert et synchronisation des champs principaux des cas |
Contact | Id, Email, CreatedDate, FirstName, LastName | Créer, Lire | Utilisateur connecté | Nécessaire lors de la création ou de l'association de contacts aux cas |
User | Id, ContactId, FirstName, LastName, Email, UserType, IsActive | Lire | Utilisateur connecté | Permet d'assigner des cas à des users spécifiques |
Group | Id, Name, Type | Lire | Utilisateur connecté | Donne accès aux files d'attente Salesforce |
QueueSobject | QueueId, SobjectType | Lire | Utilisateur connecté | Permet la sélection des files d'attente pour le routage des cas |
MessagingSession | Status, ConversationId | Lire | Fin Messenger | Vérification du statut de la MessagingSession |
Conversation | Id, ConversationIdentifier | Lire | Fin Messenger | Pour obtenir la bonne session de messagerie |
PermissionSet | Nom | Lire | Connected User | Nous permet de confirmer si le package de permissions est installé |
PermissionSetAssignment | PermissionSetId, AssigneeId | Lire | Connected User | Nous permet de confirmer si le permission set est assigné au bon user. |
EmailRoutingAddress | Id, Address, EmailServicesAddressId | Lire | Connected User | Permet de lister les adresses email de routage actives. |
EmailServicesAddress | Id, IsActive | Lire | Connected User | Permet de vérifier si l'adresse email de routage listée est valide. |
Astuce : Les champs marqués avec __c (par exemple, FinInvolved__c) sont des champs personnalisés utilisés pour suivre l'implication de l'AI et l'état de résolution. Assurez-vous qu'ils sont configurés dans Settings → Salesforce Integration.
Liste de contrôle de mise en œuvre
Avant de passer en production, assurez-vous de :
Assignez le Fin for Salesforce permissions Permission Set personnalisé
Activez Chatter et Feed Tracking dans Salesforce
Confirmez la visibilité des champs personnalisés comme
FinInvolved__c,FinResolutionState__c,FinMarkedAsSpam__c&FinConversationId__cTestez l'intégration en utilisant un environnement sandbox ou non-production