Il est nécessaire de posséder un compte au niveau de l'entreprise pour créer une intégration Twitter avec Genesys Cloud. Cela s'explique par les récents changements apportés à la structure tarifaire et aux paliers de Twitter. Pour plus d'informations sur les niveaux et sur la façon de demander un compte d'entreprise, voir La plateforme de développement de Twitter.

Avant de configurer la messagerie ACD pour Twitter Direct Message dans Genesys Cloud, créez une application Twitter. Utilisez le Le site des développeurs de Twitter pour créer votre application Twitter. Le portail des développeurs Twitter contient un ensemble d'outils en libre-service que les développeurs peuvent utiliser pour créer et gérer applications.

Important : Étant donné que le site des développeurs de Twitter est un site tiers, les informations de configuration de cet article fournissent des instructions générales. Ces instructions peuvent changer. Comme meilleure pratique, assurez-vous de consulter la documentation officielle du tiers et confirmez que vous suivez le processus le plus récent.

Inscrivez-vous pour accéder au compte développeur

Pour créer une application Twitter, vous devez avoir un approuvé compte développeur. Twitter propose trois niveaux d'accès pour les développeurs : Essentiel accès (non disponible pour l'intégration avec Genesys Cloud), Accès en hauteur, et Accès à la recherche universitaire.

Remarque :  De nouveaux comptes de développeur sont créés avec un accès essentiel. Cependant, nous vous recommandons de demander l'accès gratuit Elevated, facilement disponible sur le portail des développeurs Twitter. La plate-forme Genesys Cloud prend actuellement en charge les intégrations de messages directs Twitter à l'aide de l'API v1.1 de Twitter. Créez une application, qui a un accès élevé au projet pour continuer plus loin. Pour en savoir plus sur les différents niveaux d'accès, rendez-vous sur Twitter à propos de l'API Twitter page. Si vous avez déjà un compte de développeur Twitter, déterminez votre niveau d'accès actuel en vous rendant sur la page principale du tableau de bord.

Créez votre application Twitter

Après avoir configuré votre compte de développeur avec un niveau d'accès élevé au projet, créez votre Application Twitter à utiliser avec Genesys Cloud

Remarque :  Bien que vous puissiez utiliser une application Twitter existante pour communiquer avec Genesys Cloud, Genesys recommande de créer une application distincte à utiliser avec Genesys Cloud.
Portez une attention particulière aux informations précédentes, lors de la configuration de votre application.

Clés et jetons

Lors de la création de votre application, une information sur la clé API vous sera présentée. Enregistrez ces informations dans un endroit sûr car vous en aurez besoin lors de la configuration de votre intégration Twitter dans Genesys Cloud.

Clés d’API grand public

  • Clé API
  • Clé secrète de l’API

Une fois votre application créée, vous devrez générer un jeton d'accès et un secret pour votre application. Sélectionnez votre application et sélectionnez la section Clés et jetons.  Dans la section Jetons d'authentification, sélectionnez le bouton Générer pour générer un jeton d'accès et un secret de jeton d'accès.  Enregistrez ces informations dans un endroit sûr car vous en aurez besoin lors de la configuration de votre intégration Twitter dans Genesys Cloud.

Jeton d'accès et secret du jeton d'accès

  • Jeton d’accès
  • Clé d’accès secret

Remarque : Assurez-vous que le tLes okens générés sont livrés avec les autorisations de lecture, d'écriture et de message direct activées pour votre application, sinon l'intégration de Twitter dans Genesys Cloud ne peut pas être terminée avec succès. Plus d'informations disponibles dans la section précédente. Assurez-vous d'enregistrer les informations sur les clés API et le jeton d'accès lors de la création de l'application, car vous ne pourrez pas y accéder ultérieurement. Vous pouvez cependant régénérer les clés et les jetons pour votre application, mais cela peut empêcher toute intégration existante utilisant votre application de fonctionner. Pour Genesys Cloud, toute interaction avec une application Twitter qui a régénéré des clés API ou des jetons devra être recréée.

Paramètres d'authentification des utilisateurs et autorisations des applications

Après avoir créé l'application, assurez-vous d'activer l'authentification OAuth 1.0a pour l'utiliser avec l'API Twitter v1.1. La plate-forme Genesys Cloud l'utilise pour prendre en charge les intégrations DM.

Pour activer votre application avec l'authentification OAuth 1.0a, dans les paramètres OAuth 1.0a, schoisissez l'autorisation Lecture et écriture et Message direct. Cette option permet à l'intégration de la plateforme Genesys Cloud de lire et de publier des messages directs aux clients finaux.

Remarque : Twitter exige que vous remplissiez le URL de rappel et URL de site web champs obligatoires dans la section Paramètres généraux d'authentification. Pour enregistrer les paramètres OAuth, entrez n'importe quelle URL dans les deux champs. Les informations que vous saisissez n'ont aucune incidence sur l'intégration entre votre application Twitter et Genesys Cloud. 

Mettre en place des environnements de développement

Pour que Genesys Cloud s'intègre à votre application Twitter, configurez un environnement de développement et associez votre application à chaque point de terminaison d'API. Configurez vos environnements de développement dans votre Portail des développeurs Twitter, en allant à Des produits > Prime > Environnements de développement. Pour associer votre application à chaque point de terminaison d'API, sélectionnez l'environnement de configuration pour chacun, créez une étiquette d'environnement de développement et associez votre application.

  1. Assurez-vous que le nom de l'application correspond à votre application Twitter que vous configurez pour la messagerie ACD pour Twitter Direct Message dans Genesys Cloud. Pour plus d'informations, voir Configurer la messagerie ACD pour la messagerie directe Twitter.
  2. Entrez les informations de l'étiquette dans Nom de l'environnement lorsque vous créez une nouvelle intégration Twitter dans votre Genesys Cloud Organization.

Remarque : Si vous ne voyez pas d'environnements de développement dans le portail de développement Twitter, vérifiez si vous disposez d'un accès développeur mis à niveau vers Elevated as dLes environnements de développement ne sont pas disponibles avec l'accès Essentiel. 

Paramétrage du compte Twitter

Après avoir créé votre application Twitter pour Genesys Cloud, il est important de configurer le compte Twitter de votre entreprise pour recevoir des messages directs de n’importe qui. Si vous ne le faites pas, les clients qui utilisent votre application Twitter Direct Message ne peuvent pas contacter vos agents dans Genesys Cloud. Vous pouvez trouver le Autoriser les demandes de message de n'importe qui dans la section Confidentialité et sécurité du menu Paramètres et confidentialité de votre compte Twitter professionnel.