La grande majorité des modèles de la catégorie Messagerie utilisateur sont basés sur le composant Réponse commune, qui vous permet d'utiliser les propriétés et les métadonnées du composant pour créer une interface utilisateur spécialisée pouvant inclure du texte, des boutons d'action, des images et des cartes.

Dans de nombreux cas, tels que les modèles de la sous-catégorie Afficher les messages multimédia, les principales différences se trouvent dans la propriété Métadonnées du composant Réponse commune.

Dans d'autres cas, comme dans la sous-catégorie Afficher les tables et les formulaires, le modèle est constitué d'un composant Réponse commune précédé d'un composant Définir une variable.

Dans la sous-catégorie Caractéristiques propres à un canal, vous trouverez des exemples d'utilisation d'extensions disponibles pour les canaux Slack et Microsoft Teams.

Le composant Commentaires des utilisateurs vous permet de collecter des données de retour pour Informations en présentant aux utilisateurs une échelle de notation une fois qu'ils ont terminé un flux transactionnel. Les utilisateurs ne peuvent pas modifier leur notation car le composant Retour utilisateur n'autorise pas les entrées hors séquence. Si vous utilisez le SDK 21.10 ou une version ultérieure, ce composant génère un système de classement horizontal par étoiles.

Bien que vous puissiez modifier le comportement de ce composant à l'aide des propriétés du composant, vous pouvez modifier son apparence lorsque vous utilisez le SDK (version 21.10 ou ultérieure). Par exemple, vous pouvez remplacer les icônes en étoile par défaut utilisées pour les boutons de retour par une autre icône.

Ce composant peut renvoyer les actions suivantes :

Vous pouvez utiliser les variables système suivantes pour les messages générés par les états de transition :

• system.userFeedbackRating : renvoie la note de l'utilisateur.
• system.userFeedbackText : lorsque enableTextFeedback est défini sur true, votre brique peut demander un retour lorsque les notations sont inférieures à la valeur threshold. system.userFeedbackText renvoie l'entrée de l'utilisateur (${system.userFeedbackText.value}).

Le texte d'affichage standard du composant est stocké dans les entrées de regroupement de ressources. Ces entrées de bundle contiennent du texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce composant :

Copie les valeurs d'une variable vers une autre.

Les définitions de ces propriétés n'ont pas besoin de se reproduire. Vous pouvez définir les variables source et de destination en tant que listes de variables, mais vous pouvez également définir la variable source avec une seule variable et la destination en tant que liste. Si vous définissez une variable de destination supplémentaire, elle hérite de la valeur de variable de la valeur source suivante indiquée.

Ce composant permet de réinitialiser les valeurs des variables spécifiées sur NULL.

Le composant Définir variable définit la valeur d'une variable prédéfinie.

Le composant Détecter la langue utilise le service de traduction pour détecter la langue de l'utilisateur à partir de la saisie utilisateur.

Ce composant définit une variable appelée profile.languageTag avec la chaîne d'environnement local. Vous pouvez définir des variables avec la langue actuelle lorsque vous utilisez cette variable dans une expression de valeur (${profile.languageTag}).

Ce composant envoie le texte spécifié au service de traduction de la brique, puis stocke la traduction en anglais. Il repose sur la brique configurée avec un service de traduction, qui reconnaît la langue à partir de l'entrée de l'utilisateur et la traduit en anglais. Ce composant ne fonctionne pas avec les briques qui utilisent le mode de langue pris en charge de façon native.

Utilisez ce composant lorsque vous devez traiter le texte d'entrée brut avant de le faire traduire. Par exemple, vous pouvez supprimer certaines données personnelles de la saisie utilisateur avant de l'envoyer au service de traduction.

Etant donné que ce composant utilise le service de traduction qui détecte déjà la langue de l'utilisateur, ce composant n'a pas besoin de suivre les états qui détectent ou définissent la langue.

Le composant Traduire la sortie vous permet de traduire le texte spécifié dans la langue de l'utilisateur. Le composant prend la valeur définie pour la propriété Expression. Il utilise le service de traduction de la brique pour traduire le texte dans la langue détectée par le composant Détecter la langue ou par la variable profile.locale, puis le stocke dans la variable indiquée par la propriété Variable.

Ce composant ne fonctionne pas avec les briques qui utilisent le mode de langue pris en charge de façon native.

Le composant Entité de correspondance appelle le moteur d'intentions pour extraire les informations d'entité à partir du texte contenu dans la propriété Variable source. S'il existe une correspondance pour le type d'entité de la variable, la variable spécifiée par la propriété Variable est définie avec cette valeur d'entité.

Ce composant contient également deux transitions prédéfinies : match et nomatch.

Utilisez ce composant pour obtenir le code d'autorisation des services sécurisés par le flux d'octroi de code d'autorisation, comme LinkedIn, Twitter, Google ou Microsoft. Les composants personnalisés de la brique peuvent échanger le code d'autorisation avec un jeton d'accès, qui sera ensuite utilisé pour appeler le service de fin.

Le composant dirige d'abord l'utilisateur vers la page de connexion du fournisseur d'identités. Une fois la connexion établie, le composant renvoie le code d'autorisation dans une variable, que vous utilisez pour transmettre le code d'autorisation au composant personnalisé. L'API du composant personnalisé doit échanger le code d'autorisation, l'ID client et la clé secrète client avec un jeton d'accès utilisateur OAuth.

Pour chaque état nécessitant une autorisation avant de pouvoir être appelé, vous définissez son paramètre Autorisation requise sur True. Pour connaître les étapes de configuration, reportez-vous à Autorisation utilisateur.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Ce composant peut renvoyer les actions suivantes :

Le texte d'affichage standard du composant est stocké dans les entrées de regroupement de ressources. Ces entrées de bundle contiennent du texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce composant :

Reportez-vous à la section Modify a Resource Bundle Entry pour connaître les étapes à suivre pour modifier le message par défaut d'une entrée de groupe de ressources.

Lorsque le moteur de dialogue rencontre ce composant, le bot de brique invite l'utilisateur à interagir avec deux liens : Connexion et Annuler.

Description de l'image fb-oauth.png

Il existe plusieurs façons d'effectuer une transition à partir de ce composant :

• L'utilisateur clique sur le bouton d'annulation et le composant passe à l'état nommé par l'action fail.

• L'utilisateur ne clique sur aucun bouton, mais saisit du texte à la place. Le composant passe à l'état nommé par l'action textReceived.

• L'utilisateur clique sur le lien de connexion et le canal affiche la page de connexion du fournisseur d'identités ou sa boîte de dialogue d'authentification sous forme de vue Web, comme illustré dans l'exemple ci-dessous. Après l'autorisation, le composant passe à l'état nommé par l'action pass (ou à l'état suivant s'il n'existe pas d'action pass), qui appelle généralement un composant personnalisé qui échange le code d'autorisation avec un jeton d'accès.

Description de l'image webview-login.png

Si la fenêtre de test n'affiche pas la vue Web, coupez et collez le texte du lien dans votre navigateur.

Utilisez ce composant afin d'obtenir un jeton d'accès utilisateur OAuth2 (de type d'octroi Code d'autorisation) pour les ressources sécurisées par OCI IAM, Oracle Access Manager (OAM), la plate-forme d'identité Microsoft ou l'autorisation Google OAuth 2.0. Ce composant effectue toutes les étapes pour le flux OAuth2 à 3 acteurs et renvoie le jeton d'accès OAuth2.

Pour chaque état nécessitant une autorisation avant de pouvoir être appelé, vous définissez son paramètre Autorisation requise sur True. Pour connaître les étapes de configuration, reportez-vous à Autorisation utilisateur.

Si vous devez obtenir un jeton d'accès de type Informations d'identification client pour accéder aux ressources client, reportez-vous à OAuth 2.0 Client.

Pour pouvoir utiliser ce composant dans une brique, vous devez effectuer les tâches suivantes :

1. S'il n'a pas déjà été inscrit, inscrivez le client auprès du fournisseur d'identités, comme décrit dans Inscription de fournisseur d'identités.
2. Ajoutez un service d'authentification pour le fournisseur d'identités, comme décrit dans Services d'authentification.

Certains fournisseurs d'identités émettent des jetons d'actualisation. Lorsque vous utilisez ce composant, Digital Assistant stocke le jeton d'actualisation pendant la durée de conservation spécifiée pour le service d'authentification. Le back-end Digital Assistant peut utiliser le jeton d'actualisation, s'il est disponible, pour obtenir un nouveau jeton d'accès sans nécessiter de nouvelle connexion de la part de l'utilisateur.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Ce composant peut renvoyer les actions suivantes :

Le texte d'affichage standard du composant est stocké dans les entrées de regroupement de ressources. Ces entrées de bundle contiennent du texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce composant :

Reportez-vous à la section Modify a Resource Bundle Entry pour connaître les étapes à suivre pour modifier le message par défaut d'une entrée de groupe de ressources.

Lorsque le moteur de dialogue rencontre le composant, le bot de brique propose deux liens à l'utilisateur : Obtenir un jeton d'accès et Annuler (vous pouvez utiliser linkLabel et cancelLabel pour modifier le texte du lien).

Si l'utilisateur clique sur le lien permettant d'obtenir un jeton d'accès, cela affiche la page de connexion ou la boîte de dialogue d'authentification du fournisseur d'identités, telle que définie par le service d'authentification. Une fois la connexion établie, il obtient le jeton d'accès, définit les valeurs des variables identifiées par accessTokenVariableName et authenticatedUserVariableName, puis passe à l'état nommé par l'action pass (ou à l'état suivant si l'action pass n'existe pas). Si l'utilisateur annule, l'action de postback est définie sur fail. Si l'utilisateur saisit du texte, il renvoie l'action textReceived.

Comme indiqué précédemment, vous pouvez définir requiresAuthorization pour un état afin de vous assurer que l'utilisateur dispose des autorisations nécessaires avant d'appeler le composant de l'état. Si l'utilisateur ne dispose pas encore d'une autorisation, la boîte de dialogue appelle l'événement Autoriser l'utilisateur.

Utilisez ce composant pour obtenir un jeton d'accès OAuth2 de type d'octroi Informations d'identification client. En d'autres termes, vous l'utilisez pour obtenir un jeton d'accès basé sur les informations d'identification du client, mais pas sur son nom ni sur son mot de passe. Vous pouvez utiliser ce composant pour obtenir un jeton qui permet d'accéder aux ressources client protégées par Oracle Identity Cloud Service ou Oracle Access Manager (OAM).

Si vous devez accéder aux ressources pour le compte d'un utilisateur, reportez-vous à OAuth 2.0 Account Link et OAuth Account Link.

Pour pouvoir utiliser ce composant dans une brique, vous devez effectuer les tâches suivantes :

1. S'il n'a pas déjà été inscrit, inscrivez le client auprès du fournisseur d'identités, comme décrit dans Inscription de fournisseur d'identités.
2. Ajoutez un service d'authentification d'informations d'identification client pour le fournisseur d'identités, comme décrit dans Services d'authentification.

Ce composant n'a aucune action. Pour gérer les problèmes système susceptibles de se produire, ajoutez une transition "next" qui passe à un état permettant de gérer ces erreurs.

Utilisez ce composant pour révoquer tous les jetons d'actualisation et d'accès de l'utilisateur connecté du fournisseur d'identités représenté par le service d'authentification. Il enlève également les jetons d'actualisation de la base de données. Pour utiliser ce composant, vous devez fournir l'URL de révocation de jeton d'actualisation du fournisseur d'identités dans l'interface utilisateur du service d'authentification.

La brique doit inclure un état qui utilise le composant Lien de compte OAuth 2.0 pour le même service d'authentification, et doit être appelée avant l'état qui utilise ce composant.

Ce composant peut renvoyer l'action suivante :

Utilisez ce composant pour changer d'état en fonction d'une valeur de variable.

Ce composant détermine un chemin d'exécution en résolvant une variable ou une expression, puis en déclenchant une action de transition correspondante qui est mise en correspondance avec un état du flux.

Vous définissez et mappez les actions de transition dans l'onglet Transitions de l'inspecteur de propriétés.

Avec ce composant, vous appelez un flux enfant à partir du flux actuel, en transmettant éventuellement des paramètres d'entrée. Une fois le flux enfant terminé, il renvoie une action et des paramètres de sortie facultatifs à son flux parent.

Les actions de transition qui peuvent être définies dépendent des actions définies dans le composant Fin de flux du flux enfant.

Avec ce composant, vous appelez un flux de brique différent, en transmettant éventuellement des paramètres d'entrée. Une fois le flux appelé terminé, il renvoie une action et des paramètres de sortie facultatifs au flux appelant.

Avant d'utiliser ce composant, un flux public doit être disponible dans la brique que vous appelez. Reportez-vous à Appel d'une autre brique à partir d'un flux.

ParamName: ParamValue

Ce composant est utilisé pour mettre fin explicitement à un flux.

Lorsque cet état est atteint, toutes les variables du flux sont effacées et le contrôle est renvoyé au flux parent (ou, s'il n'y a pas de flux parent, le flux principal).

Vous n'avez pas besoin d'un état Fin de flux pour un flux si vous n'avez pas besoin de renvoyer des paramètres ou des actions du flux vers un flux parent ou le flux principal.

Ce modèle se compose des composants Initiation d'agent et Conversation d'agent. Vous utilisez ces composants ensemble pour transférer la conversation d'une brique à un agent Oracle B2C Service.

• Le composant Lancement d'agent lance l'établissement de liaison avec le canal d'intégration d'agent indiqué par la propriété Canal d'intégration d'agent du composant.
• Le composant Conversation d'agent gère l'échange entre la brique et l'agent physique.

Ce modèle est destiné aux conversations qui proviennent de la brique. N'utilisez pas ce modèle pour les conversations qui proviennent de la discussion Oracle B2C Service, comme décrit dans Assistant numérique en tant que structure d'agent en action.

Utilisez le composant de transfert d'agent dans les assistants numériques en tant qu'agents pour renvoyer la conversation au service de discussion. La conversation sera acheminée vers un agent physique selon les règles de discussion qui ont été configurées dans le service de discussion.

Ce composant est destiné aux conversations provenant d'un service de discussion, tel que décrit dans La structure d'assistant numérique en tant qu'agent en action. Pour les conversations qui proviennent de la brique, utilisez plutôt le modèle Communication avec l'agent.

Vous pouvez utiliser le composant Condition de transfert d'agent dans les assistants numériques DA-as-agent pour déterminer si des agents sont disponibles et, le cas échéant, le temps d'attente attendu.

Vous utilisez les propriétés du composant pour spécifier les conditions de transfert et il renvoie une action indiquant si les conditions ont été remplies. En outre, il définit les valeurs de la variable de correspondance nommée.

Voici la structure de la valeur de la variable de statut de disponibilité de l'agent et les informations qui y sont stockées :

queueId (integer, optional): The engagement queue ID,
expectedTotalWaitSeconds (integer, optional): Expected wait time in the queue in seconds
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitSeconds (integer, optional): The number representing the "ss" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitMinutes (integer, optional): The number representing the "mm" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
availableAgentSessions (integer, optional): Total number of sessions available across all agents.,
totalAvailableAgents (integer, optional): Total number of agents whose status is available.,
totalUnavailableAgents (integer, optional): Total number of agents whose status is unavailable.,
totalAgentsRequestingNewEngagement (integer, optional): Total number of agents who are available and have capacity.
outsideOperatingHours (boolean, optional): True if outside operating hours. False if inside operating hours.,
engagementsInQueue (integer, optional): The number of engagements currently in the queue.
sessionId (string, optional): The session ID.,
clientId (integer, optional): The client ID.

This might take {minutes, plural,
     =-1 {}
     =0 {}
     =1 {1 minute and }
     other {# minutes and }
}{seconds, plural,
     =-1 {a while}
     =0 {{minutes, plural,
          =0 {a short wait time}
          other {0 seconds}
        }}
     =1 {1 second}
     other {# seconds}
} to connect. Are you willing to wait?

Utilisez ce composant pour envoyer une demande HTTP à une adresse REST que vous avez configurée dans les paramètres des services d'API.

Voici les propriétés des composants :

Le composant renvoie les actions suivantes :

Pour en savoir plus, reportez-vous à Accès aux back-ends à l'aide du composant de service REST.

Utilisez ce composant pour rechercher des informations sur un terme de recherche donné dans Oracle B2C Service Knowledge Foundation ou Oracle Fusion Service Knowledge Management et afficher les résultats.

Pour Oracle B2C Service, les résultats de la recherche dépendent du caractère public des réponses et des paramètres de niveau d'accès, de produit ou de catégorie.

Vous devez créer un service de recherche dans la base de connaissances pour pouvoir utiliser ce composant. Reportez-vous à Ajout d'un service de recherche dans la base de connaissances.

Voici les propriétés du composant de recherche de connaissances :

Utilisez le modèle Création d'incident pour créer un rapport d'incident sur un site de service client. Pour pouvoir utiliser ce composant dans votre instance, vous devez créer une intégration de service client à partir de la page Paramètres > Services supplémentaires > Intégration de service client.

Utilisez ce composant pour accéder à une enquête Oracle Intelligent Advisor à partir d'une brique.

Vous devez créer une intégration de service Intelligent Advisor pour pouvoir utiliser ce composant. Reportez-vous à Ajout d'un service Intelligent Advisor. Par ailleurs, l'enquête doit avoir été déployée vers Intelligent Advisor Hub et activée sur le canal du service de discussion. L'enquête doit être destinée aux utilisateurs anonymes. Vous ne pouvez pas accéder aux enquêtes pour les utilisateurs de portail ou les utilisateurs d'agent.

Vous pouvez utiliser les propriétés du composant pour spécifier les paramètres d'enquête suivants :

• Affichage ou non des titres et de l'explication
• Libellés des boutons des options oui, non et incertain
• Chaînes saisies par l'utilisateur pour réinitialiser l'enquête, revenir à la question précédente (annulation) et quitter l'enquête
• Texte à afficher à la fin de l'enquête
• Formulation de la question concernant l'affichage ou non de l'explication
• Chaîne saisie par l'utilisateur pour indiquer qu'il a terminé le téléchargement des fichiers
• Valeurs d'attribut et paramètres de connecteur à transmettre à l'enquête
• Paramètres régionaux du projet à utiliser

Le composant de vue Web ouvre une vue Web dans votre brique ou dans un onglet de navigateur pour des briques qui s'exécutent dans un canal Web.

Vous utilisez ce composant pour envoyer une notification à un utilisateur lorsqu'un événement cloud d'un type inscrit dans Oracle Digital Assistant s'est produit. Pour plus d'informations sur l'inscription des types d'événement et la configuration d'un assistant numérique afin qu'il utilise l'événement, reportez-vous à Evénements externes.

Vous utilisez ce composant pour publier en externe un événement cloud d'un type inscrit dans Oracle Digital Assistant. Pour plus d'informations sur l'inscription des types d'événement et la configuration d'un assistant numérique pour la publication et l'utilisation d'événements, reportez-vous à Evénements externes.

Voici un exemple de charge utile pouvant être utilisé comme valeur pour la propriété Data :

{
    "size": "Large",
    "type": "Veggie"
}

        "system.postbackActions": {
          "small": {
            "postback": {
              "variables": {
                "size": "Small"
              },
              "system.botId": "44F2405C-F317-4A3F-8250-617F54F01EA6",
              "action": "Small",
              "system.state": "size"

A ce stade, le système compare la propriété system.state de la charge utile de l'action de postback entrante à l'état en cours. Lorsque les deux éléments ne correspondent plus, la brique exécute une transition qui peut, selon la manière dont vous configurez votre flux de dialogue, répondre à la demande de l'utilisateur ou la refuser.

Vous pouvez modifier le comportement par défaut de la gestion des messages dans le désordre en mappant l'événement de transition système Message dans le désordre avec un composant Invoke Flow qui appelle un flux que vous avez fourni pour gérer les messages dans le désordre.