Salesforce

L’intégration Hyperline-Salesforce offre une connexion transparente entre votre instance Salesforce et Hyperline. Grâce à cette intégration, vous pouvez accéder à un widget dédié directement depuis Salesforce, vous permettant de créer et gérer les devis, abonnements et clients Hyperline sans quitter votre CRM. Cette fonctionnalité intègre l’interface complète d’Hyperline dans Salesforce, garantissant des flux fluides et efficaces. De plus, l’intégration permet une synchronisation optionnelle et automatique des données entre les entités Hyperline — telles que les devis, abonnements et détails de factures — et les objets personnalisés de Salesforce. Cela garantit que vous disposez toujours des informations les plus à jour à portée de main, permettant à ces données d’être utilisées pour des automatisations internes, des workflows et du reporting dans Salesforce.

​

Prérequis

Vous devez avoir un compte Salesforce valide et accéder aux paramètres de votre compte Hyperline. Nous recommandons d’expérimenter avec un Salesforce Developer Account avant de passer en production. Vous pouvez créer une instance Salesforce Developer gratuite et utiliser le mode test de votre compte Hyperline pendant la configuration et les tests.

​

Permissions

Hyperline configure automatiquement les composants techniques requis dans votre instance Salesforce lors de la connexion pour activer les notifications et la synchronisation en temps réel. Pour cette raison, nous recommandons d’utiliser un utilisateur avec le profil System Administrator lors de la connexion de votre instance Salesforce. Sinon, des permissions spécifiques doivent être accordées manuellement à l’utilisateur.

Accorder manuellement les permissions à un utilisateur non-System Administrator

L’utilisateur doit disposer des permissions suivantes :

• API Enabled — Permet à l’utilisateur d’exécuter des appels API.
• Author Apex — Permet à l’utilisateur de créer et modifier des classes et triggers Apex.
• Customize Application ou Modify All Data — Permet à l’utilisateur de créer ou modifier les paramètres de remote site.

Ces permissions peuvent être mises à jour comme suit :

1. Cliquez sur l’icône Gear (coin supérieur droit) et sélectionnez Setup.
2. Dans la boîte Quick Find, tapez « Profiles » et sélectionnez Profiles.
3. Cliquez sur Edit à côté du profil que vous souhaitez mettre à jour.
4. Activez les cases à cocher des permissions requises et cliquez sur Save.

​

Interfaces Hyperline embarquées dans Salesforce

​

Installation

Lors de la connexion de votre instance Salesforce à Hyperline, un package Hyperline Salesforce est automatiquement installé. Ce package comprend un composant Salesforce natif qui peut être facilement ajouté à vos page layouts, permettant à vos équipes revenue de continuer à utiliser Salesforce tout en accédant de manière transparente à toutes les fonctionnalités d’Hyperline. Pour ajouter le composant à une page Account ou Opportunity :

1. Naviguez vers n’importe quelle page Account ou Opportunity.
2. Cliquez sur le menu dans le coin supérieur droit et sélectionnez Edit Page.
3. Recherchez le composant Hyperline et glissez-déposez-le dans la page layout.
4. Cliquez sur Save. S’il s’agit de votre première édition de cette layout, Salesforce vous invitera à Activer la vue mise à jour.

​

Composant

Une fois installé, ce composant peut être utilisé sur les pages Account et Opportunity. Il propose plusieurs actions disponibles, vous permettant de :

• créer des devis Hyperline
• créer des abonnements Hyperline
• gérer le client Hyperline associé

Chaque action ouvre une interface Hyperline dédiée intégrée directement dans Salesforce, vous donnant accès à l’expérience Hyperline complète sans quitter votre CRM — garantissant une interopérabilité transparente entre les deux systèmes.

​

Paramètres

Le comportement du composant peut être affiné depuis Settings > Integrations > Salesforce.

​

Objet racine

Contrôle quel objet Salesforce le composant traite comme source de vérité lors de l’affichage des données de facturation Hyperline (devis et abonnements). Deux modes sont disponibles :

• Account — Tous les devis et abonnements d’un compte sont affichés à la fois sur le composant du compte et sur les composants de ses opportunités associées. Choisissez cette option si votre équipe revenue raisonne en termes de facturation au niveau du client et veut avoir la vision complète de la facturation disponible depuis n’importe quelle opportunité liée à ce client.
• Opportunity — Seuls les devis et abonnements attachés à une opportunité spécifique sont affichés sur le composant de cette opportunité. Le composant du compte affiche toujours tous les devis et abonnements du compte. Choisissez cette option si vous voulez que chaque opportunité n’affiche que ses propres éléments de facturation, sans débordement d’une opportunité à l’autre.

Ce paramètre n’affecte que ce qui est affiché dans le composant embarqué ; il ne change pas la manière dont les données sont synchronisées avec les objets personnalisés Salesforce.

​

Autoriser la création d’un nouveau client

Lorsqu’activé, un utilisateur Salesforce qui déclenche une action depuis un compte ou une opportunité non encore liée à un client Hyperline peut créer le client Hyperline correspondant à la volée et poursuivre l’action. Lorsque désactivé, les actions sont bloquées jusqu’à ce qu’un client Hyperline correspondant existe et soit lié à l’enregistrement Salesforce.

​

Afficher les données des enfants des clients

Lorsqu’activé, le composant affiche également les devis et abonnements appartenant aux enfants du client (dans la hiérarchie parent–enfant des clients Hyperline), en plus de ceux du client lui-même. Utile lorsque vous facturez les comptes parents mais souhaitez avoir la visibilité sur l’activité de leurs filiales depuis l’enregistrement Salesforce du parent.

​

Accès utilisateur

Les utilisateurs Salesforce n’ont pas besoin d’un compte Hyperline existant. Lorsqu’un utilisateur déclenche une action Hyperline pour la première fois, un utilisateur Hyperline correspondant est automatiquement créé en utilisant son adresse email Salesforce et assigné à votre rôle Hyperline par défaut (le rôle « Account manager » s’il n’est pas modifié). Lorsque les interfaces Hyperline sont ouvertes dans Salesforce, le rôle Hyperline de l’utilisateur est appliqué pour garantir les bonnes permissions de visualisation et d’édition. Ces permissions sont gérées directement dans Hyperline sous Settings > Team.

​

Réconciliation des données

Lors de la récupération des données client Hyperline depuis un enregistrement de compte ou d’opportunité Salesforce, le mécanisme de recherche suivant est appliqué :

1. S’il s’agit d’un enregistrement d’opportunité, utiliser l’enregistrement de compte associé pour la recherche.
2. Si l’enregistrement de compte est déjà lié à un client Hyperline (via la section Integrations sur la page client Hyperline), ce client est utilisé.
3. Si l’enregistrement de compte a une valeur dans le champ personnalisé Hyperline customer ID, nous tentons de résoudre le client Hyperline correspondant.
4. Si l’enregistrement de compte a une valeur dans le champ personnalisé Hyperline external ID, nous tentons de résoudre le client Hyperline dont l’ID ou l’external ID correspond à cette valeur. Si le compte Salesforce et le client Hyperline n’étaient pas liés auparavant, le lien est automatiquement créé — à condition que les paramètres de l’intégration le permettent (synchronisation client activée, direction de synchronisation incluant Salesforce → Hyperline, et compte marqué pour synchronisation).

Si un client est trouvé mais que les paramètres ne permettent pas le liage automatique, Hyperline fera apparaître le client suggéré dans Salesforce, ainsi qu’une action pour déclencher manuellement le lien. Si aucun client n’est trouvé mais que le paramètre « Allow creating new customer » est activé, l’utilisateur Salesforce pourra créer un nouveau client Hyperline associé et poursuivre l’action souhaitée.

​

Synchronisation des données

En plus des interfaces embarquées entièrement intégrées, l’intégration peut également synchroniser les données depuis Hyperline vers les objets personnalisés Salesforce. Cette synchronisation est optionnelle et peut être configurée ultérieurement. Lorsque vous connectez votre workspace Salesforce et sélectionnez les entités que vous souhaitez synchroniser dans les paramètres Hyperline, Hyperline crée automatiquement les objets personnalisés requis et leurs champs associés dans Salesforce (s’ils n’existent pas déjà) et configure les mécanismes de synchronisation. Modifier les données que vous choisissez de synchroniser nécessite de reconfigurer l’intégration. Ce processus peut prendre quelques minutes.

​

Prérequis

Pour synchroniser les données, Hyperline exige que des objets personnalisés spécifiques existent dans votre instance Salesforce. Hyperline n’a pas la permission de créer automatiquement des objets personnalisés dans votre instance Salesforce. Vous devez les créer manuellement en utilisant les noms d’objet listés ci-dessous. Si un objet personnalisé requis n’existe pas, vous ne pourrez pas activer la synchronisation pour cette entité, et aucune donnée ne sera poussée vers Salesforce.

Créer un objet personnalisé dans Salesforce

Pour créer les objets personnalisés requis :

1. Cliquez sur l’icône Gear (coin supérieur droit) et sélectionnez Setup.
2. Dans la boîte Quick Find, tapez « Object Manager » et sélectionnez Object Manager.
3. Cliquez sur le menu déroulant Create et choisissez Custom Object.
4. Remplissez les champs Label, Object Name et Record Name.

L’Object Name doit correspondre exactement aux noms requis listés ci-dessus. Les autres champs peuvent être configurés selon vos besoins.

5. Répétez ce processus pour chaque entité que vous souhaitez synchroniser.

​

Synchronisation des clients

Lorsqu’activée, les clients Hyperline sont synchronisés avec les comptes Salesforce. Vous pouvez choisir la direction de synchronisation (à sens unique ou bidirectionnelle). Lors de la configuration de l’intégration, Hyperline crée un champ personnalisé case à cocher « (Hyperline) Synchronize » (slug HyperlineSync__c) sur l’objet Account. Un compte Salesforce est importé et synchronisé dans Hyperline uniquement lorsque cette case est cochée ; les comptes sans la case cochée sont ignorés.

​

Mapping

Voici les mappings de champs par défaut entre les entités Hyperline et les objets Salesforce.

​

Déclencher manuellement une synchronisation

Vous pouvez également déclencher manuellement la synchronisation des données client depuis la page client Hyperline. Dans le menu déroulant Integrations, cliquez sur « Sync with Salesforce » pour pousser (ou tirer, selon la direction de synchronisation) les données du client et envoyer tous les devis, abonnements et factures associés vers Salesforce.

​

Dépannage

Si vous rencontrez des problèmes avec l’intégration (données manquantes, synchronisation d’entité échouée, etc.), nous vous recommandons de consulter la page des problèmes Hyperline pour plus de détails : Settings > Integrations > Salesforce > View issues.

​

Problèmes courants

Le composant est vide avec l’affichage « Nothing yet » et aucun bouton Ce problème se produit généralement lorsque l’instance Salesforce n’est pas connectée au bon environnement Hyperline (production vs. sandbox). Dans Salesforce, allez dans Setup > Custom Code > Custom Settings, cliquez sur Manage pour Hyperline Settings, puis Edit. Assurez-vous que le champ Environment correspond soit à Production, soit à Sandbox, selon votre configuration. Lors de l’ouverture d’une action, la modale charge indéfiniment Ce problème se produit généralement lorsque les cookies tiers sont bloqués dans le navigateur. Nous en avons besoin pour authentifier correctement l’utilisateur et charger les interfaces. Veuillez vérifier ceci dans les paramètres de votre navigateur (chrome://settings/cookies pour Chrome ou Arc) et assurez-vous qu’il n’y a pas d’extensions qui les bloquent. Le composant Salesforce est vide (seuls les boutons apparaissent, sans données) Ce problème se produit généralement lorsque le même ID Salesforce est attribué à plusieurs clients dans Hyperline. Hyperline utilise le premier client correspondant trouvé, mais ce client peut ne pas contenir de données. Assurez-vous que l’ID Salesforce est attribué à un seul client dans Hyperline — le bon.

​

Déconnexion

À tout moment, vous pouvez déconnecter l’intégration en cliquant sur le bouton Disconnect situé dans le coin supérieur droit de la page des paramètres de l’intégration Salesforce. Déconnecter l’intégration arrêtera toute synchronisation, mais les objets personnalisés, champs personnalisés et toute donnée précédemment poussée dans Salesforce resteront intacts — ils ne seront pas supprimés.