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 qui peut 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édias, 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 de réponse commune précédé d'un composant Définir une variable.

Dans la sous-catégorie Fonctions propres à un canal, il existe des exemples d'utilisation d'extensions disponibles pour les canaux Slack et Microsoft Teams.

Le composant User Feedback (Rétroaction des utilisateurs) vous permet de collecter des données de rétroaction pour les données clés 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 de rétroaction d'utilisateur n'autorise pas les entrées dans le désordre. Si vous utilisez la trousse SDK 21.10 ou une version ultérieure, ce composant produit un système de notation en étoile horizontal.

Bien que vous puissiez modifier le comportement de ce composant à l'aide des propriétés du composant, vous pouvez en modifier l'aspect lorsque vous utilisez la trousse 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 rétroaction par une autre icône.

Ce composant peut retourner 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 - Retourne la notation de l'utilisateur.
• system.userFeedbackText - Lorsque enableTextFeedback est réglé à true, votre compétence peut demander une rétroaction lorsque les notations sont inférieures à la valeur threshold. system.userFeedbackText retourne l'entrée de l'utilisateur (${system.userFeedbackText.value}).

Le texte d'affichage standard du composant est stocké dans les entrées d'ensemble de ressources. Ces entrées d'ensemble ont un texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce groupe de pages :

Copie les valeurs d'une variable dans une autre.

Les définitions de ces propriétés n'ont pas à se refléter. Bien que vous puissiez définir à la fois des variables de destination et des variables sources en tant que listes de variables, 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 spécifiée.

Ce composant rétablit les valeurs des variables spécifiées à zéro.

Le composant Set Variable définit la valeur d'une variable prédéfinie.

Le composant Detect Language (Détecter la langue) utilise le service de traduction pour détecter la langue de l'utilisateur à partir de l'entrée utilisateur.

Ce composant définit une variable nommée profile.languageTag avec la chaîne de paramètres régionaux. Vous pouvez définir des variables avec la langue courante 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 compétence, puis stocke la traduction en anglais. Il s'appuie sur la compétence configurée avec un service de traduction, qui reconnaît la langue de l'entrée de l'utilisateur et la convertit en anglais. Ce composant ne fonctionne pas avec les compétences qui utilisent le mode linguistique pris en charge de manière native.

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

Étant donné que ce composant tire parti du service de traduction, qui détecte la langue de l'utilisateur, il n'est pas nécessaire de suivre les états qui détectent ou définissent la langue.

Le groupe de pages Traduire sortie permet de traduire le texte précisé 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 compétence 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 spécifiée par la propriété Variable.

Ce composant ne fonctionne pas avec les compétences qui utilisent le mode linguistique pris en charge de manière native.

Le composant Correspondance d'entité appelle le moteur d'intention 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 offre également deux transitions prédéfinies : match et nomatch.

Utilisez ce composant pour obtenir le code d'autorisation pour les services sécurisés par un code d'autorisation, par exemple LinkedIn, Twitter, Google ou Microsoft. Les composants personnalisés de la compétence peuvent échanger le code d'autorisation contre un jeton d'accès qu'ils utilisent ensuite pour appeler le service final.

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

Pour chaque état qui nécessite une autorisation avant d'être appelé, vous réglez le paramètre Requires Authorization (Exige une autorisation) à True. Voir Autorisation de l'utilisateur pour connaître les étapes de configuration.

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

Ce composant peut retourner les actions suivantes :

Le texte d'affichage standard du composant est stocké dans les entrées d'ensemble de ressources. Ces entrées d'ensemble ont un texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce groupe de pages :

Voir Modifier une entrée d'ensemble de ressources pour connaître les étapes permettant de modifier le message par défaut d'une entrée d'ensemble de ressources.

Lorsque le moteur de dialogue détecte ce composant, le robot de compétence invite l'utilisateur avec deux liens — Login (Connexion) et Cancel (Annuler).

Description de l'illustration 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 qui est nommé par l'action fail.

• L'utilisateur ne clique sur aucun bouton mais entre du texte. Le composant passe à l'état qui est 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 en tant que vue Web, comme illustré dans l'exemple ci-dessous. Une fois l'autorisation reçue, le composant passe à l'état nommé par l'action pass (ou à l'état suivant s'il n'y a pas d'action pass), qui appelle généralement un composant personnalisé qui échangé le code d'autorisation contre un jeton d'accès.

Description de l'illustration 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 pour obtenir un jeton d'accès d'utilisateur OAuth2 (type d'autorisation Code) 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 termine toutes les étapes du flux OAuth2 à trois branches et retourne le jeton d'accès OAuth2.

Pour chaque état qui nécessite une autorisation avant d'être appelé, vous réglez le paramètre Requires Authorization (Exige une autorisation) à True. Voir Autorisation de l'utilisateur pour connaître les étapes de configuration.

Si vous devez obtenir un jeton d'accès avec le type d'autorisation Données d'identification client pour accéder aux ressources clients, voir OAuth 2.0 Client.

Afin de pouvoir utiliser ce composant dans une compétence, vous devez effectuer les tâches suivantes :

1. Si ce n'est pas encore fait, inscrivez le client auprès du fournisseur d'identités comme décrit dans la rubrique Enregistrement au niveau du 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 période de conservation spécifiée pour le service d'authentification. Le système dorsal de l'assistant numérique peut utiliser le jeton d'actualisation, s'il est disponible, pour obtenir un nouveau jeton d'accès sans que l'utilisateur ait à se connecter de nouveau.

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

Ce composant peut retourner les actions suivantes :

Le texte d'affichage standard du composant est stocké dans les entrées d'ensemble de ressources. Ces entrées d'ensemble ont un texte par défaut, mais vous pouvez les personnaliser. Voici les entrées de ce groupe de pages :

Voir Modifier une entrée d'ensemble de ressources pour connaître les étapes permettant de modifier le message par défaut d'une entrée d'ensemble de ressources.

Lorsque le moteur de dialogue rencontre le composant, le robot de compétence 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 pour obtenir un jeton d'accès, le moteur affiche la page de connexion ou la boîte de dialogue d'authentification du fournisseur d'identités comme indiqué par le service d'authentification. Une fois la connexion réussie, il obtient le jeton d'accès, définit les variables identifiées par accessTokenVariableName et authenticatedUserVariableName, puis passe à l'état qui est nommé par l'action pass (ou à l'état suivant en l'absence d'action pass). Si l'utilisateur annule, l'action de republication est réglée à fail. Si l'utilisateur entre du texte, l'action textReceived est retournée.

Comme mentionné précédemment, vous pouvez définir requiresAuthorization pour un état afin de garantir que l'utilisateur dispose de l'autorisation nécessaire avant d'appeler le composant de l'état. Si l'utilisateur n'a pas encore autorisé, le dialogue appelle l'événement Autoriser l'utilisateur.

Utilisez ce composant pour obtenir un jeton d'accès OAuth2 avec le type d'autorisation Données d'identification de client. Autrement dit, vous l'utilisez pour obtenir un jeton d'accès basé sur les données d'identification du client et non sur le nom et le mot de passe de l'utilisateur. Vous pouvez utiliser ce composant pour obtenir un jeton qui permet l'accès aux ressources de client protégées par le service Oracle Identity Cloud ou Oracle Access Manager (OAM).

Si vous devez accéder aux ressources pour le compte d'un utilisateur, voir OAuth Lien de compte 2.0 et OAuth Lien de compte.

Afin de pouvoir utiliser ce composant dans une compétence, vous devez effectuer les tâches suivantes :

1. Si ce n'est pas encore fait, inscrivez le client auprès du fournisseur d'identités comme décrit dans la rubrique Enregistrement au niveau du fournisseur d'identités.
2. Ajoutez un service d'authentification client pour le fournisseur d'identités, comme décrit dans la rubrique Services d'authentification.

Ce composant ne comporte aucune action. Pour gérer les problèmes système qui peuvent survenir, ajoutez une transition next qui passe à un état pouvant traiter de telles erreurs.

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

La compétence doit inclure un état qui utilise le composant OAuth 2.0 Account Link pour le même service d'authentification et celui-ci doit être appelé avant l'état qui utilise ce composant.

Ce composant peut retourner l'action suivante :

Utilisez ce composant pour changer d'état en fonction de la valeur d'une 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 mappée à 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 courant, en transmettant éventuellement des paramètres d'entrée. Lorsque le flux enfant est 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 qui sont définies dans le groupe de pages Flux fin du flux enfant.

Avec ce composant, vous appelez le flux d'une compétence différente, en transmettant éventuellement des paramètres d'entrée. Lorsque le flux appelé est 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 compétence que vous appelez. Voir Appeler une autre compétence à partir d'un flux.

ParamName: ParamValue

Ce composant est utilisé pour terminer explicitement un flux.

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

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

Ce modèle comprend les groupes de pages Lancement agent et Conversation agent. Vous utilisez ces composants ensemble pour transférer la conversation d'une compétence vers un agent Oracle B2C Service.

• Le composant Lancement de l'agent lance l'établissement d'une liaison avec le canal Intégration d'agent spécifié par la propriété Canal Intégration d'agent du composant.
• Le composant Conversation d'agent gère l'échange entre la compétence et l'agent humain.

Ce modèle est destiné aux conversations provenant de la compétence. Ne l'utilisez pas pour les conversations provenant du clavardage Oracle B2C Service, comme décrit dans la rubrique Vue d'ensemble de l'utilisation d'un assistant numérique comme agent.

Vous utilisez le composant de transfert d'agent dans les assistants numériques as-agent pour faire revenir la conversation dans le service de clavardage. La conversation sera transférée à un agent humain selon les règles de clavardage configurées dans le service correspondant.

Ce composant est destiné aux conversations provenant du clavardage d'un service, comme décrit dans la rubrique Vue d'ensemble de l'utilisation d'un assistant numérique comme agent. Pour les conversations provenant de la compétence, utilisez plutôt le modèle de communication de 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 qui indique si les conditions ont été remplies. En outre, il définit les valeurs de la variable de mappage 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 à un point d'extrémité REST que vous avez configuré dans les paramètres des services d'API.

Voici les propriétés du composant :

Le groupe de pages affiche les actions suivantes :

Pour en savoir plus, voir Accéder aux serveurs dorsaux à l'aide du composant de service REST.

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

Pour Oracle B2C Service, les résultats de recherche dépendent du fait que les réponses sont publiques et des paramètres de niveau d'accès, de produit ou de catégorie.

Notez que vous devez créer un service de recherche de connaissances avant de pouvoir utiliser ce composant. Voir Ajouter un service de recherche de connaissances.

Voici les propriétés du composant Knowledge Search :

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

Utilisez ce composant pour accéder à une entrevue Oracle Intelligent Advisor à partir d'une compétence.

Vous devez créer une intégration de service Intelligent Advisor avant de pouvoir utiliser ce composant. Voir Ajouter un service Intelligent Advisor. En outre, l'entrevue doit avoir été déployée sur le centre de gestion Intelligent Advisor et activée sur le canal de service de clavardage. L'entrevue doit être destinée aux utilisateurs anonymes. Vous ne pouvez pas accéder aux entrevues pour les utilisateurs du portail ou les utilisateurs d'agent.

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

• L'affichage ou non des titres et de l'explication
• Les étiquettes des boutons oui, non et incertain
• Les chaînes que l'utilisateur entre pour réinitialiser, revenir à la question précédente (annuler) et quitter l'entrevue
• Le texte à afficher à la fin de l'entrevue
• La formulation de la question relative à l'affichage ou non de l'explication
• La chaîne que l'utilisateur entre pour indiquer qu'il a terminé le chargement des fichiers
• Les valeurs d'attribut et les paramètres de connecteur à transmettre à l'entrevue
• Paramètres régionaux du projet à utiliser

Le composant Webview (Vue Web) ouvre une vue Web dans votre compétence, ou pour celles exécutées sur un canal Web, dans un onglet du navigateur.

Vous utilisez ce composant pour envoyer un avis à un utilisateur lorsqu'un événement en nuage d'un type qui a été enregistré dans Oracle Digital Assistant s'est produit. Voir Événements externes pour plus d'informations sur l'enregistrement des types d'événement et la configuration d'un assistant numérique pour qu'il consomme l'événement.

Vous utilisez ce composant pour publier à l'externe un événement en nuage d'un type qui a été enregistré dans Oracle Digital Assistant. Voir Événements externes pour plus d'informations sur l'enregistrement des types d'événement et la configuration d'un assistant numérique pour la publication et la consommation d'événements.

Voici un exemple de données utiles qui peuvent être utilisées 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"

À ce stade, le système compare la propriété system.state dans les données utiles de l'action de republication entrante à l'état courant. Si les deux ne correspondent plus, la compétence exécute une transition qui peut, selon la configuration du flux de dialogue, honorer la demande de l'utilisateur ou la refuser.

Vous pouvez modifier le comportement par défaut du traitement des messages dans l'ordre en mappant l'événement de transition du système Message dans l'ordre à un composant Invoke Flow qui appelle un flux que vous avez fourni pour le traitement des messages dans l'ordre.