Avant de suivre les étapes de configuration, vous devez d’abord consulter les notes de version et télécharger la dernière version du pack Salesforce de l’application Webex.

Exigences requises

Salesforce Enterprise Edition

Cette intégration nécessite au minimum Salesforce Enterprise Edition. Voir Salesforce Editions pour plus d'informations.

Mon domaine dans l’organisation Salesforce

Vous devez déployer Mon domaine dans votre organisation si vous souhaitez utiliser des composants Lightning. Reportez-vous à la documentation Mon domaine Salesforce pour plus d'informations.

Accès des utilisateurs dans Control Hub

Vous devez configurer l’accès des utilisateurs aux extensions dans votre organisation.

• Sans Pack Pro–Lorsque vous disposez du Control Hub de base, vous pouvez choisir d’autoriser ou de refuser l’accès à toutes les extensions pour tous vos utilisateurs.

• Avec le Pack Pro—Avec le Pack Pro, vous disposez de fonctionnalités avancées pour gérer l'accès aux extensions pour les utilisateurs.

Voir Configurer l'accès utilisateur aux extensions pour plus d'informations.

Appels

• Webex Calling est entièrement pris en charge pour les appels entrants et sortants pour le contrôle des appels au sein de Salesforce.

• L’appel dans Webex (Unified CM) est partiellement pris en charge. Seuls les appels sortants ouvrent une fenêtre contextuelle de journalisation dans Salesforce. Pour les appels entrants, l’application Webex sonne mais Salesforce ne peut pas intercepter l’appel, de sorte que la fenêtre contextuelle de journalisation ne s’affiche pas.

Si vous travaillez avec Webex pour Salesforce version 1.18 ou version antérieure, avant de pouvoir travailler avec Webex Calling dans Salesforce, vous devez configurer une autorisation Salesforce. Suivez les sections de cet article pour être opérationnel.

Ces procédures s'appliquent aux clients utilisant la version 1.18 et antérieure de l'intégration Webex Salesforce. Voir les instructions mises à jour pour les versions 1.19 et ultérieures : Configurer une autorisation Salesforce (1.19 et version plus récente) dans l'onglet Installer et administrer

1. Créer une application connectée

Pour créer une nouvelle application connectée :

1. Dans Setup, recherchez App Manager, puis choisissez New Connected App.

   

2. Saisissez un Nom de l'application connectée, par exemple, MyExampleApp.
3. Saisissez une adresse e-mail de contact.
4. Cochez Activer les paramètres OAuth.
5. Spécifiez une URL de rappel d'espace réservé (nous la mettrons à jour ultérieurement), par exemple, https://localhost/espace réservé.

   

6. Faites défiler vers le bas et choisissez les périmètres OAuth suivants :
   • Accès complet (complet)
   • Effectuer des demandes à tout moment (refresh_token, offline_access)

   

   La portée Exécuter les demandes à tout moment permet aux identifiants nominatifs d'actualiser votre jeton d'accès à l'expiration d'une session.

7. Faites défiler jusqu'au bas de la page et cliquez sur Enregistrer, puis sur Continuer.
8. Sur la page suivante, accédez à API (Enable OAuth Settings) et cliquez sur Manage Consumer Details.

   

   Vous devrez peut-être vous réauthentifier auprès de Salesforce.

9. Notez la Clé Consommateur et le Secret Consommateur.

   

2. Créer un fournisseur d’authentification

Vous devrez ensuite créer un fournisseur d’authentification, qui facilite l’authentification avec votre organisation Salesforce.

Pour créer un fournisseur d’authentification :

1. Dans Setup, recherchez Auth et sélectionnez Auth. Prestataires. Cliquez sur Nouveau.

   

2. Sélectionnez Salesforce comme Provider Type.
3. Saisissez un nom pour le fournisseur d'authentification, par exemple, ApexMDTAPI.
4. Collez les Consumer Key et Consumer Secret que vous avez enregistrés lors de la configuration de votre application connectée.
5. Saisissez les périmètres suivants dans Périmètres par défaut, full refresh_token offline_access.
6. Laissez tout le reste vide et cliquez sur Enregistrer.

   

7. Copiez l'URL de rappel à partir de la section Configuration Salesforce.

   

8. Modifiez votre application connectée et remplacez l’URL de l’espace réservé par l’URL de rappel que vous avez copiée à partir de la Configuration Salesforce ci-dessus.

   

9. Enregistrez votre application connectée.

   Vous devrez peut-être attendre jusqu’à 10 minutes pour permettre aux paramètres de prendre effet et de se propager dans toute l’infrastructure de Salesforce.

3. Créer un identifiant nommé

Vous devrez alors créer un identifiant nommé.

Pour créer un identifiant nommé :

1. Dans Setup, recherchez Named et sélectionnez Named Credentials. Cliquez sur New Legacy.

   

2. Saisissez la valeur suivante pour Étiquette, ApexMDTAPI.
3. Pour l'URL, saisissez l'URL d'instance de votre organisation, par exemple, https://na1.salesforce.com, ou, si vous utilisez Mon domaine, votre nom de domaine Mon domaine entièrement qualifié, par exemple, https://mycompany.my.salesforce.com.
4. Pour Identity Type, choisissez Named Principal.
5. Pour Protocole d'authentification, choisissez OAuth 2.0.
6. Pour Fournisseur d'authentification, choisissez le fournisseur d'authentification que vous avez créé précédemment.
7. Pour Portée, saisissez, refresh_token offline_access complet.
8. Activez Démarrer le flux d’authentification lors de l’enregistrement.

   

9. Dans Options de légende, activez Autoriser les champs de fusion dans le corps HTTP, puis cliquez sur Enregistrer.

   

10. Vous serez invité à vous connecter à votre organisation. Après vous être connecté, une boîte de dialogue Autoriser l'accès s'affiche. Cliquez sur Autoriser.
11. Vous serez alors redirigé vers l'écran Informations d'authentification nommées et le Statut authentifié indiquera Authentifié comme your-email@domain.com.

4. Créer votre site dans l’écran d’administration Webex

Enfin, passez au sujet suivant dans l'onglet Calling, Créer un site pour appeler, ci-dessous.

Veuillez suivre les conventions de nommage ci-dessus lors de la configuration du site.

Pour les extensions Webex pour Salesforce version 1.19 et versions ultérieures, suivez les instructions contenues dans cet article pour supprimer toutes les applications Webex connectées existantes pour les autorisations, les identifiants nommés et les fournisseurs d’authentification, puis créez une nouvelle application Webex connectée pour l’autorisation Salesforce.

Ces procédures s'appliquent aux clients utilisant la version 1.19 et versions ultérieures de l'intégration Webex Salesforce. Pour des instructions sur les versions 1.18 et versions antérieures, voir Configurer une autorisation Salesforce (1.18 et versions ultérieures) dans l’onglet Installer et administrer

Supprimer toutes les applications connectées Webex existantes, les identifiants nommés et les fournisseurs d’authentification

Si vous avez précédemment créé des autorisations de l’application Webex Connected, un identifiant nommé ou un fournisseur d’authentification, vous devez les supprimer avant de continuer. Sinon, continuez à Créer une nouvelle application Webex Connected ci-dessous.

Supprimer votre application Webex Connected existante :

1. Dans le coin supérieur droit de votre page d’accueil Salesforce, sélectionnez l’icône d’engrenage et choisissez Configuration.
2. Dans la zone de texte Recherche rapide, saisissez Gestionnaire d'applications et sélectionnez-le dans la liste.
3. Faites défiler jusqu'à votre application Webex Connected dans la liste, cliquez sur l'icône de la flèche descendante à droite de l'entrée et choisissez Affichage.
4. Sélectionnez Supprimer, puis sélectionnez à nouveau Supprimer lorsque vous êtes invité à confirmer.

Supprimer toutes les informations d'authentification nommées Webex existantes :

1. Dans la zone de texte Recherche rapide, saisissez les Informations d'authentification nommées et sélectionnez-les dans la liste.
2. 2. Cliquez sur la flèche vers le bas à droite de l'entrée d'informations d'identification nominatives Webex et choisissez Supprimer.
3. 3. Sélectionnez à nouveau Supprimer lorsqu'on vous demande de confirmer.

Supprimer tous les fournisseurs d’authentification Webex existants :

1. Dans la zone de texte Recherche rapide, saisissez Authentification. Fournisseurs et sélectionnez-le dans la liste.
2. Sélectionnez le lien Suppr au début de l'entrée du fournisseur d'authentification Webex.
3. Sélectionnez OK lorsque vous êtes invité à confirmer.

Passez à la section suivante pour créer une nouvelle application Webex Connected pour l’autorisation Salesforce.

Créer une nouvelle application Webex Connected pour l’autorisation Salesforce

Pour créer une nouvelle application Webex Connected pour l’autorisation Salesforce :

1. Dans le coin supérieur droit de votre page d’accueil Salesforce, sélectionnez l’icône d’engrenage et choisissez Configuration.
2. Récupérer l’URL de votre domaine : dans Recherche rapide, recherchez et sélectionnez Domaines, puis enregistrez l'URL à partir de Mon domaine.

1. Dans la zone de texte Recherche rapide, saisissez Gestionnaire d'applications et sélectionnez-le dans la liste.
2. Saisissez un Nom de l'application connectée, par exemple, Autorisation Webex Salesforce.
3. Saisissez une adresse électronique pour Contact Email.
4. Cochez Activer les paramètres OAuth.
5. Saisissez deux URL de rappel en utilisant l'URL que vous avez récupérée précédemment, une par ligne, et en ajoutant /apex/ webexsfdcauth et /apex/ cisco_webex__webexsfdcauth comme suffixes. Par exemple :

   https://my-company.my.salesforce.com/apex/webexsfdcauth

   https://my-company.my.salesforce.com/apex/cisco_webex__webexsfdcause

6. Choisissez les périmètres suivants dans la liste Périmètres OAuth disponibles dans Périmètres OAuth sélectionnés :
   • Accès complet (complet)
   • Effectuer des demandes à tout moment (refresh_token, offline_access)
7. Décochez Exiger une clé de preuve pour le numéro de poste PKCE (Code Exchange) pour les flux d'autorisation pris en charge.
8. Enregistrez l’application connectée et notez les Consumer Key et Consumer Secret générés pour une utilisation ultérieure.

Lorsqu’un nouveau pack est disponible, suivez les étapes décrites dans Installer l’application Webex dans Salesforce. Vous n'avez pas besoin de désinstaller d'abord l'ancienne version et vous ne perdrez pas vos paramètres configurés.

Pour obtenir des informations sur les nouveaux packs d'installation et où les télécharger, consultez les Notes de version de l'extension Webex Salesforce.

Pour activer ou désactiver l’historique des appels :

1. Allez à l’administration Webex.
2. Faites défiler jusqu'à Historique des appels Webex.
3. Commutez le commutateur sur le paramètre souhaité, activé ou désactivé.

   Lorsque cette option est activée, l’historique des appels est disponible pour tous les utilisateurs et profils.

Pour les utilisateurs de CUCM et Broadworks, la fonctionnalité suivante n'est pas prise en charge :

• Réception des appels entrants dans le numéroteur global Salesforce (l’application Webex recevra toujours les appels entrants)
• Affichage de la durée des appels dans la fenêtre du journal des appels Salesforce après avoir passé avec succès un appel sortant
• Mettre fin aux appels via le bouton de la fenêtre du journal des appels Salesforce après avoir passé avec succès un appel sortant
• Renseigner automatiquement les durées des appels dans la fenêtre du journal des appels Salesforce après avoir mis fin à un appel sortant

Pour toutes les extensions Salesforce, notez la limite suivante :

• Salesforce applique une limite de nombre d’événements (25 000) qui peut entraîner l’échec des intégrations en cas d’utilisation intensive. Les packs Salesforce sont disponibles pour augmenter cette limite. Pour plus d’informations, voir https://developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/platform_event_limits.htm.

À l’aide du panneau de configuration Webex Webinars Importer les données du webinaire, les utilisateurs autorisés de Salesforce peuvent importer les invités, les inscrits et les invités du webinaire Webex directement dans des objets Salesforce tels que les prospects et les contacts.

L’interface de configuration Importer les données du webinaire est disponible à partir de la page Administration Webex :

Une fois l’importation des webinaires activée, les utilisateurs autorisés peuvent importer les données des webinaires Webex à l’aide du widget Webex Webinars :

Attribuer les autorisations de webinaire Webex aux utilisateurs Salesforce

Avant que vos utilisateurs puissent accéder à la fonctionnalité d’importation de webinaires Webex, vous devez attribuer l’autorisation Administration de l’importation Webex à chacun d’eux.

Pour attribuer des autorisations à un utilisateur :

1. Accédez à Intégrer Salesforce à l’application Webex.
2. Choisissez l'onglet Gérer au bas de l'article, puis développez Fournir l'accès :

   

3. Suivez les instructions pour ajouter l'autorisation Webex Import Admin à vos comptes utilisateur Salesforce.

Configurer l’affichage de la plage horaire du webinaire Webex

Pour configurer la plage horaire des webinaires Webex affichés :

1. Cliquez sur le bouton Salesforce Apps, saisissez Webex dans le champ de recherche, puis choisissez Webex Admin :

   

2. Recherchez le panneau Webinaires Webex et saisissez le nombre de jours pendant lesquels vous souhaitez afficher les webinaires passés et à venir dans le widget de la page d’accueil Webinaires Webex :

   

Continuez à configurer les mappages des champs d’importation du webinaire Webex.

Configurer les mappages des champs d’importation des webinaires Webex

À l’aide des paramètres d’importation de webinaires Webex, vous définissez des mappages entre les objets Salesforce et les champs de l’objet Webinaire. Par exemple, vous pouvez mapper les noms et prénoms d’un objet Salesforce Contact avec les noms des champs parallèles des invités, des inscrits et des participants au webinaire : prénom et nom.

Pour configurer les paramètres d’importation du webinaire Webex :

1. Dans la page Administration Webex, faites défiler jusqu’au panneau Importer les données du webinaire :

   

2. Choisissez un objet Salesforce dans la liste déroulante Objet :

   

   Pour l'Objet, vous pouvez choisir parmi les objets Salesforce standard suivants en plus des objets Personnalisés configurés disponibles :

   • Contacts
   • Prospects

   Choisissez le bouton Insérer des nouveaux enregistrements pour chaque webinaire si vous souhaitez que tous les participants au webinaire importés soient créés en tant que nouveaux enregistrements d’objets, à moins qu’ils n’aient déjà été importés pour le même webinaire (en fonction de la clé principale sélectionnée). Les enregistrements existants ne seront pas mis à jour, même si la clé principale correspond, à moins qu’ils ne soient importés pour le même webinaire Webex.

   Pour ces objets standard, vous pouvez choisir de les lier à vos campagnes Salesforce comme suit :

   • Membres de la campagne : Les prospects et contacts importés sont disponibles dans la section Membres de la campagne Salesforce cible, qui est une fonctionnalité standard de Salesforce. (Disponible dans la version 1.16 et versions ultérieures)
   • Membres de la campagne Webex Webinar : Les prospects et contacts importés sont disponibles dans la section Membres de la campagne Webex Webinar d’une campagne Salesforce cible, qui est une fonctionnalité Webex personnalisée.
   • Membres de la campagne et membres de la campagne Webex Webinar : Les prospects et contacts importés sont disponibles dans les deux emplacements dans une campagne Salesforce. (Disponible dans la version 1.16 et versions ultérieures)

   Tout autre objet Personnalisé que vous choisirez dans la liste sera importé dans la section Membres de la campagne Salesforce Webinar cible.

3. Dans l'interface de sélection de la Touche principale, choisissez un champ unique comme touche principale et utilisez la flèche de droite pour le déplacer vers la liste Sélectionné :

   

   Pour la Clé primaire, choisissez un champ disponible qui sera unique à chaque enregistrement. Par exemple, vous pouvez avoir de nombreux contacts avec le prénom Mark, mais chaque contact aura une adresse e-mail unique.

4. Dans l’interface Mappage des champs de données, choisissez un champ de l’objet Salesforce que vous avez sélectionné et mappez-le à un champ correspondant à l’objet du webinaire. Utilisez le bouton + Nouveau champ pour ajouter des champs supplémentaires si nécessaire.

   Tous les champs de l’objet Salesforce doivent être mappés aux champs correspondants du webinaire comme indiqué ci-dessus.

   Seules les questions standard des formulaires d’inscription au webinaire Webex peuvent être mappées aux champs Salesforce. Les questions personnalisées du webinaire Webex ne sont pas prises en charge.

5. Vous pouvez supprimer les champs que vous avez ajoutés à l'aide de l'icône de la poubelle adjacente au champ sur la droite.
6. Cliquez sur Enregistrer lorsque vous avez terminé et une fois que vous avez vérifié votre clé principale, cliquez sur Enregistrer dans la boîte de dialogue de confirmation :

   

   Les mappages sont affichés dans le panneau mis à jour :

   

   Vous pouvez supprimer les mappages d'objets à l'aide de l'icône de la poubelle, qui affichera une boîte de dialogue de confirmation supplémentaire, ou modifier les mappages existants à l'aide de l'icône crayon.

   Vous pouvez toujours revenir ici et changer la clé principale, mais cela ne mettra pas à jour la clé principale pour les enregistrements déjà importés dans le système. Par conséquent, cela peut conduire à des doublons, donc modifiez les clés primaires avec prudence.

Une fois que vous avez configuré les mappages des champs du webinaire, choisissez qui a accès à la fonctionnalité d’importation des données du webinaire.

Activer l’importation des données du webinaire pour vos utilisateurs Salesforce

Une fois les mappages des champs du webinaire établis, vous pouvez ensuite choisir qui a accès à la fonctionnalité d’importation des données du webinaire. Les options comprennent l’accès global pour chaque compte utilisateur avec les autorisations correctes, les comptes utilisateur individuels et les utilisateurs qui sont membres de profils Salesforce particuliers.

Activer l’importation des données du webinaire pour tous les utilisateurs

Pour activer l’importation des données des webinaires pour tous les membres de votre organisation Salesforce, déplacez le curseur Activer l’importation des webinaires pour tous les profils/utilisateurs sur Activé :

Activer l’importation des données du webinaire pour les utilisateurs ou les profils sélectionnés

Vous pouvez activer l’importation des données du webinaire pour les utilisateurs individuels sélectionnés ou pour des ensembles spécifiques d’utilisateurs correspondant à un profil d’utilisateur Salesforce particulier.

Pour activer l’importation des données du webinaire pour les utilisateurs ou les profils sélectionnés :

1. Assurez-vous que l’option Activer l’importation de webinaires pour tous les profils/utilisateurs est Désactivée :

   

2. Dans la liste déroulante Activer l’importation du webinaire uniquement pour ces profils/utilisateurs, sélectionnez Profil ou Utilisateur :

   

   • Pour ajouter un profil, sélectionnez Profil, puis cliquez dans la zone de texte de recherche et choisissez un rôle Salesforce dans la liste déroulante. Cliquez sur Ajouter pour ajouter le rôle :

     

   • Pour ajouter un utilisateur individuel, sélectionnez Utilisateur et saisissez un nom d'utilisateur dans la zone de texte. Cliquez sur Ajouter pour ajouter l’utilisateur :

     

   Pour supprimer un utilisateur ou un profil, cliquez sur l'icône de la poubelle adjacente à l'entrée.