Vue d'ensemble des déclencheurs

Un déclencheur est une ressource de Genesys Cloud qui permet aux clients de configurer une réaction à des événements spécifiques qui se produisent dans Genesys Cloud. Les actions sont des flux de travail que vous pouvez créer via Architect. Pour plus d'informations sur la création de workflows, voir About Architect dans le centre de ressources Genesys Cloud.

Un déclencheur comprend trois éléments principaux :

  • Nom du sujet: Le sujet ou l'événement pour lequel vous voulez invoquer une action.
  • Cible du flux de travail: L'action à entreprendre sur les événements correspondants.
  • Conditions : Les critères qui doivent être remplis pour qu'un événement soit pris en compte.

Nom du sujet

De nouveaux sujets sont régulièrement mis à jour et les thèmes peuvent varier en fonction de votre organisation.

  • v2.users.{id}.activity
  • v2.detail.events.conversation.{id}.acd.end
  • v2.detail.events.conversation.{id}.acd.start
  • v2.detail.events.conversation.{id}.acw
  • v2.detail.events.conversation.{id}.wrapup
  • v2.detail.events.conversation.{id}.attributes
  • v2.detail.events.conversation.{id}.customer.end
  • v2.detail.events.conversation.{id}.customer.start
  • v2.detail.events.conversation.{id}.outbound
  • v2.detail.events.conversation.{id}.user.end
  • v2.detail.events.conversation.{id}.user.start
  • v2.detail.events.conversation.{id}.voicemail.end
  • v2.detail.events.conversation.{id}.voicemail.start
  • v2.outbound.email.campaigns.contact.preContact
  • v2.outbound.email.campaigns.contact.postContact
  • v2.outbound.messaging.campaigns.contact.preContact
  • v2.outbound.messaging.campaigns.contact.postContact
  • v2.quality.evaluations
  • v2.operations.events.{id}
  • v2.detail.events.collaboratechat.adhoc.{id}.messages
  • v2.detail.events.collaboratechat.group.{id}.messages
  • v2.workforcemanagement.managementunits.{id}.adherence
  • v2.workforcemanagement.teams.{id}.adherence
  • v2.users.{id}.workforcemanagement.adherence
  • v2.users.{id}.workforcemanagement.schedules
  • v2.users.{id}.workforcemanagement.notifications
  • v2.users.{id}.workforcemanagement.timeoffrequests
  • v2.users.{id}.integrationpresence

Lorsque vous sélectionnez le sujet dans la vue du déclencheur, le schéma d'événement du sujet s'affiche à titre de référence. Vous pouvez obtenir une liste des thèmes disponibles pour votre organisation en effectuant une requête GET. Pour plus d'informations, voir Process Automation APIs et Available topics.

Cible du flux de travail

Les administrateurs créent des flux de travail dans Architect. Dans la vue du déclencheur, vous ne pouvez sélectionner que des flux de travail actifs et publiés comme cible du flux de travail. Le format de données dans lequel les paramètres d'entrée sont envoyés au flux de travail peut être des champs primitifs de premier niveau ou JSON.

  • Les primitives de premier niveau telles que les chaînes, les énumérations, les nombres et les booléens sont envoyées au flux de travail.
  • For JSON data format, the entire event is sent to the workflow as a JSON object. The workflow must be configured to have an input variable named jsonData of type JSON.
Note: Dans Architect, les attributs du flux de travail sont sensibles à la casse. Lorsque vous faites référence à un attribut dans le flux de travail, veillez à utiliser la même casse que celle qui apparaît dans le schéma de l'événement.

Pour plus d'informations sur les flux de travail, voir Travailler avec des flux de travail.

Conditions

Les conditions sont la liste des critères selon lesquels le déclencheur invoque la cible du flux de travail. L'expression de la condition comprend trois parties :

  • Chemin JSON: Définit la partie de l'événement à comparer. Exprimez la condition à l'aide de JSONPath, le langage utilisé pour parcourir et analyser les documents JSON afin de trouver des éléments spécifiques. Vous pouvez également utiliser l'évaluateur Jayway JsonPath ou l'utilitaire de test JSONPath pour vérifier la réponse de votre charge utile JSON et de vos instructions JSONPath.
  • Opérateur: Définit le type de comparaison utilisé pour comparer la sortie JSON Path avec la valeur. Les comparaisons de chaînes sont sensibles à la casse.Dans la vue du déclencheur, pour obtenir une description de la liste des opérateurs, cliquez sur Afficher l'aide sur les opérateurs de filtrage.
  • Valeur: Valeur(s) définie(s) par l'utilisateur pour les opérations qui prennent une seule valeur ou une liste de valeurs. La valeur d'entrée peut être une chaîne de caractères, un nombre ou une valeur booléenne. Selon la sélection de l'opérateur, le type d'entrée de la valeur change en conséquence. Le type d'entrée de la valeur garantit la précision de la comparaison.
    Opérateur Type d'entrée
    Plus grand que l'égal Numéro
    Moins que l'égal Numéro
    Égal à

    Objet

    Non égal

    Objet

    Moins que

    Numéro

    Plus grand que

    Numéro

    Dans

    Tableau d'objets

    Pas dans

    Tableau d'objets

    contient

    Objet

    Tout

    Tableau d'objets

    Existe

    Booléen

    Taille

    Numéro

    Note: Un déclencheur peut comporter jusqu'à 10 conditions, qui doivent toutes être remplies pour lancer le flux de travail. Pour déclencher un flux de travail lorsque l'une des conditions est remplie (logique OU), vous devez créer plusieurs déclencheurs, chacun avec son propre ensemble de conditions.

Configuration de la synchronisation

Par exemple, s'il y a un retard dans le traitement du déclencheur pour un flux de travail de changement d'état, il n'est pas pertinent d'exécuter le flux de travail après l'heure fixée.

Ensuite, vous apprendrez à créer un déclencheur.