Configurer l’intégration Amazon EventBridge

Après avoir installé Amazon EventBridge, un administrateur Genesys Cloud doit ajouter et configurer l'intégration Amazon EventBridge Source. Les administrateurs doivent d'abord ajouter l'intégration, puis configurer et activer l'intégration nouvellement ajoutée.

Conditions préalables
  • Intégrations > L’intégration > Tout autorisation (inclus dans le Maître admin rôle)

Ajouter l’intégration

  1. Cliquez sur Admin. 
  2. Sous Intégrationscliquez sur Intégrations.
  3. Cliquez sur Ajouter l’intégration.  
  4. Dans la zone de recherche, saisissez EventBridge.
  5. Repérez la carte intitulée Amazon EventBridge Source.
  6. Cliquez sur installer. Des détails sur l’intégration apparaissent.

    Configurer et activer 

    Ensuite, configurez et activez l’intégration Zoom Meetings :

    1. Dans l’onglet Détails, acceptez le nom par défaut (intégration Zoom Genesys Cloud ) ou saisissez un autre nom.
    2. (Facultatif) Entrez les notes dans la boîte fournie.
    3. Sélectionnez le configuration onglet.
    4. Connectez la source d'événements de votre partenaire à un bus d'événements.
    5. Saisissez votre ID de compte AWS à 12 chiffres et la région où la source de l'événement partenaire doit être créée. Pour votre région, utilisez la forme avec trait d'union telle que nous-est-1 ou nous-ouest-2. Pour plus d'informations, consultez la liste des codes de région pris en charge dans la documentation AWS.
    6. Offrir un unique Suffixe de la source de l'événement à ajouter à la source d'événement dans le compte AWS. Le suffixe peut comporter jusqu'à 64 caractères, composés de lettres minuscules et majuscules, de chiffres ou de caractères (.,-,_). Le suffixe est ajouté au nom de la source de l'événement partenaire et permet de le distinguer des autres intégrations Amazon EventBridge.
    7. Dans Filtrage des sujets, sélectionnez les sujets de notification à envoyer à EventBridge. Saisissez une liste de rubriques de notification que la source d'événement partenaire doit recevoir. Voici quelques exemples : v2.utilisateurs.{id}.présence, v2.utilisateurs.{id}.routingStatus, etc. Pour une liste de tous les sujets de notification disponibles, voir Sujets disponibles dans le Genesys Cloud Developer Center.
      Remarque :  Les rubriques n'incluent pas de paramètres et fournissent des informations pour l'ensemble de l'organisation. Choisir de recevoir v2.utilisateurs.{id}.présence les événements ne nécessitent pas de spécifier un ID utilisateur, comme c'est le cas avec l'API Notifications. Vous recevez toutes les notifications de présence pour votre organisation. Faites attention au nombre de sujets de notification que vous sélectionnez. Pour chaque rubrique sélectionnée, tous les événements correspondants pour l'ensemble de votre organisation sont envoyés à AWS EventBridge pour être acheminés vers la cible de votre choix. De plus, si vous ne sélectionnez aucun sujet de notification, aucun événement n'est envoyé.
    8. Cliquez sur Sauvegarder. 
    9. Cliquez sur l'onglet Détails.
    10. Cliquez sur la bascule pour que l’intégration soit actif.
    11. Cliquez sur Oui. En 5 minutes environ, ou après un rechargement d'application, une source d'événement partenaire est automatiquement créée dans votre compte AWS. Genesys Cloud commence à envoyer des événements dès l'activation réussie.
      Remarque : Vous pouvez configurer jusqu'à 10 instances d'intégration Amazon EventBridge pour une organisation.

    Une fois que vous avez configuré et activé l'intégration dans Genesys Cloud, configurez des règles dans la console EventBridge dans AWS pour acheminer les messages de la source de l'événement vers les cibles AWS prévues. Pour plus d'informations, consultez Configurer EventBridge pour recevoir des événements et Premiers pas avec Amazon EventBridge.

    Modifier la configuration d'intégration

    La modification de l'un des attributs suivants sur une intégration active entraîne la désactivation de l'intégration :

    • ID de compte AWS
    • Région AWS
    • Suffixe de source d'événement

    Vous devez réactiver l'intégration après avoir modifié la configuration de l'intégration. La réactivation de l'intégration supprime l'ancienne source d'événements et crée une nouvelle source d'événements.

    Les filtres thématiques peuvent être modifiés à tout moment et cela n'entraîne pas la désactivation de l'intégration. Attendez jusqu'à 1 minute pour que les modifications prennent effet.

    Désactiver l'intégration

    Une fois qu'une intégration EventBridge est activée avec succès, Genesys Cloud commence à envoyer des notifications correspondantes à la source d'événement partenaire. Les événements peuvent être temporairement désactivés en désactivant l'intégration. Cela ne modifie en rien la source de l'événement partenaire.

    Si l'intégration n'est plus nécessaire, elle peut être supprimée. La suppression de l'intégration supprime la source d'événement partenaire dans AWS.

    Erreurs courantes

    Voici quelques erreurs courantes qui peuvent apparaître lorsque vous essayez d'activer une configuration d'intégration :

    • ID de compte AWS non valide – Indique que l'ID de compte AWS spécifié n'est pas une chaîne à 12 chiffres valide.
    • Région AWS non valide – Indique que la région AWS spécifiée n'est pas l'une des Régions EventBridge.
    • Le suffixe de la source de l'événement doit être unique – Indique que le suffixe de la source d'événement correspond à un suffixe déjà défini sur une autre intégration EventBridge active pour l'organisation.