Comment mettre à niveau votre package Calendly Salesforce de la version 1 à la version 2

Découvrez comment mettre à niveau votre package Calendly Salesforce de la version 1 à la version 2 tout en conservant les personnalisations que vous pourriez avoir. 

Si vous téléchargez le package Salesforce pour la première fois, vous pouvez ignorer cet article et suivre les étapes de Comment installer le package Calendly dans Salesforce pour télécharger la version 2 par défaut.

Améliorations de la version 2

Package géré

La version 1 (v1) n'est pas gérée, mais la version 2 (v2) est gérée. Avec des packages gérés, vous pouvez mettre à jour sans avoir à désinstaller et à réinstaller.

Si vous ne savez pas quelle version vous utilisez, consultez votre page d'intégration Salesforce pour confirmer.

Plus de données dans Salesforce

La version 2 (v2) capturent plus d'informations sur vos événements Calendly. Avec un module Salesforce mis à jour, vous pouvez consulter :

• Emplacement de la réunion

• réunions replanifiées

• toutes les 10 questions et réponses personnalisées

• statut d'absence

Processus supprimé

La version 2 (v2) n'inclut pas le processus OnCalendlyActionCreated, vous n'aurez donc pas besoin du générateur de processus. Vous pouvez désormais ajouter une logique conditionnelle directement dans les flux Calendly.

Conserver les personnalisations effectuées à la version 1

Les modifications que vous avez apportées à la version 1 du package Calendly par défaut ne seront pas automatiquement transférées à la version 2. Avant de passer à une nouvelle version, vérifiez les flux et les processus personnalisés dans votre instance Salesforce.

• Vous pouvez voir si vous avez des personnalisations en suivant les étapes de la section Comment vérifier vos personnalisations dans Salesforce.

Si vous avez des personnalisations existantes, faites une liste ou prenez des captures d'écran de ces personnalisations avant de désinstaller le package afin de pouvoir les implémenter de nouveau. Vous voudrez les reconstruire dans votre environnement de test v2 avant de les ajouter dans la production.

• Consultez Comment effectuer une mise à niveau vers la version 2 (avec des personnalisations) pour connaître les étapes à suivre.
• Si vous n'avez pas de personnalisations existantes, passez à la section Comment effectuer une mise à niveau vers la version 2 (sans personnalisations).

Vérifiez les personnalisations effectuées dans la version 1

1. Connectez-vous à Salesforce.

2. Pour vérifier si vous avez personnalisé des flux, allez dans la section Flux.

3. Pour le flux CreateEvent, sélectionnez Afficher les détails et les versions. Comparez votre version existante à la version par défaut du package. Consultez le tableau ci-dessous pour les numéros de version par défaut. Si votre version active est un numéro qui n'est pas le numéro de version par défaut, vous avez personnalisé vos flux.

   Remarque : si vous avez des flux personnalisés, affichez-les en production et prenez des captures d'écran. Vous ajouterez ces personnalisations lorsque vous remplirez Comment effectuer la mise à niveau vers la version 2 (avec personnalisations).

4. Pour vérifier si vous avez personnalisé des processus, accédez au générateur de processus. Pour le processus OnCalendlyActionCreated, sélectionnez la flèche à côté pour développer les détails. Si vous avez une version active autre que la version 3, cela signifie que vous avez personnalisé le processus. Consultez le tableau ci-dessous pour les numéros de version par défaut.

   Remarque : si vous avez un processus personnalisé, consultez les détails du processus actif sur la production pour comprendre la logique conditionnelle qui se déclenche lorsqu'un flux est exécuté. Prenez une capture d'écran de toutes les personnalisations. Comme il n'y a pas de générateur de processus dans la v2, vous ajouterez ces personnalisations directement aux flux de la v2 lorsque vous remplirez le guide de mise à niveau vers la version 2 (avec personnalisations).

Passer à la version 2 (sans personnalisations)

Suivez ces étapes si…

• vous utilisez déjà la version 1 du package Salesforce

• vous avez accès à la version 2 (vous verrez une bannière de mise à niveau sur votre page d'intégration Salesforce)

• et vous n'avez pas effectué de personnalisations à votre package Salesforce

1. À partir de votre page d'intégration Salesforce, cliquez sur Déconnexion. Remarque : il est préférable de se déconnecter en dehors des heures de travail pour limiter les interruptions dans Salesforce.

2. Dans Salesforce, désinstallez le package v1.

   Recherchez des packages installés et sélectionnez Désinstaller à côté du package Calendly. Si vous êtes invité à désactiver des flux ou des processus, faites-le.

   • Plus de détails et de bonnes pratiques de Salesforce sur la désinstallation d'un package.

   • Une fois que vous avez désinstallé la version 1, vos flux, personnalisations et processus actuels seront supprimés.

3. Dans Calendly, sélectionnez Commencer l'intégration. Saisissez vos informations d'identification Salesforce et sélectionnez Se connecter.

4. Sélectionnez autoriser l'accès.

5. Sélectionnez Installer le package Calendly et sélectionnez Installer pour tous les utilisateurs.  Sélectionnez Terminé.

6. Une fois le package installé, revenez à Calendly et sélectionnez Rafraîchir pour terminer la connexion entre Calendly et Salesforce.
   

7. Votre page d'intégration Salesforce doit répertorier la version 2.x.

Passer à la version 2 (avec des personnalisations)

Suivez ces étapes si…

• vous utilisez déjà la version 1 du package Salesforce

• vous avez accès à la version 2 (vous verrez une bannière de mise à niveau sur votre page d'intégration Salesforce)

• vous avez accès à un environnement de production et à un environnement sandbox Salesforce

• vous avez effectué des personnalisations approfondies à votre package Salesforce, et il est essentiel de maintenir une connexion Salesforce à Calendly tout en personnalisant la version 2

Étape 1 – Configurer l'environnement sandbox Salesforce

Pour minimiser les temps d'arrêt pendant le processus de migration, configurez votre environnement sandbox avant de déconnecter votre instance de production de Calendly.

1. Dans Salesforce, créez un nouvel environnement sandbox ou utilisez un environnement existant qui n'a pas de package Calendly installé. Si vous utilisez un environnement sandbox existant, actualisez votre environnement sandbox avec les dernières données de production avant de continuer.

Étape 2 – Dans Calendly, déconnecter le compte Salesforce et connecter l'environnement sandbox

1. Dans Calendly, accédez à la page d'intégration de Salesforce. Sélectionnez déconnecter.

2. Dans Calendly, sélectionnez Connectez-vous à Sandbox.

3. Entrez vos informations d'identification dans votre sandbox et téléchargez le nouveau package Calendly dans votre environnement sandbox.

4. Une fois connecté, sélectionnez Rafraîchir la page. La page doit répertorier la version 2.x.

Si vous avez besoin de plus d'aide pour connecter votre environnement sandbox, consultez les instructions ici.

Étape 3 – Dans Calendly, réserver des réunions de test à envoyer dans un sandbox

1. Dans Calendly, réservez une ou deux réunions de test. Les réunions planifiées créeront des enregistrements de référence dans un sandbox. Vous pouvez cloner ces enregistrements pour tester les personnalisations des flux.

2. Pour confirmer que les données d'événement de vos réunions de test apparaissent, créez un onglet pour l'objet CalendlyActions dans Salesforce. Accédez à l'onglet et affichez tous les enregistrements pour confirmer que les données de réunion ont été correctement envoyées.

Étape 4 – Dans Calendly, reconnecter l'environnement de production au package v1

Reconnectez votre environnement de production à Calendly, afin que les données de réunion en direct ne soient pas perdues lors des tests dans le sandbox.

1. Dans Calendly, sélectionnez déconnecter pour déconnecter votre instance de sandbox.

2. Sélectionnez Procéder à l'intégration maintenant et connectez-vous avec vos informations d'identification Salesforce.

Étape 5 – Dans le sandbox, faites des copies des flux Calendly et ajoutez vos personnalisations

1. Dans Salesforce, accédez à votre environnement sandbox et faites une copie des modèles dans le package géré, CreateEventTemplate et CancelEventTemplate. Apportez vos personnalisations avant d'activer les flux personnalisés et de désactiver les flux modèles. Pour faciliter ce processus, ouvrez l'environnement sandbox et l'environnement de production dans des fenêtres séparées.

   Remarque : si vous avez personnalisé le processus OnCalendlyAction pour qu'il s'exécute de manière conditionnelle, vous devrez créer cette logique conditionnelle au début de vos flux.

Étape 6 – Dans un environnement de test, tester les flux personnalisés

1. Clonez les enregistrements CalendlyAction existants, invitee.created et invitee.canceled, et modifiez des parties de ces enregistrements pour déclencher les flux pour différentes situations.

   • Par exemple, vous pouvez déclencher le flux lorsqu'un invité planifie avec une nouvelle adresse e-mail dans Salesforce ou lorsqu'un invité planifie avec une adresse e-mail qui existe déjà dans Salesforce.

   • Utilisez l'onglet CalendlyActions que vous avez créé à l'étape 3.2 pour surveiller les données de réunion.

Étape 7 - Dans Salesforce, désinstallez le package Calendly non géré

Dans Salesforce, accédez à votre environnement de production et désinstallez le package Calendly non géré.

1. Recherchez les packages installés et sélectionnez Désinstaller à côté du package Calendly non géré. Si vous êtes invité à désactiver des flux ou des processus, faites-le.

Étape 9 – Dans Salesforce, activez des flux personnalisés.

1. Dans Salesforce, migrez les flux personnalisés du sandbox à la production à l'aide d'ensembles de modifications. Désactivez les flux de modèle inclus dans le package.

2. Activez vos flux personnalisés et vos automatisations sur la production, et conservez les modèles désactivés.

Étape 10 – Réserver une réunion de test dans Calendly

Vérifiez que vos flux fonctionnent comme prévu sur la production en réservant une réunion de test.