A certains points d'un flux, vous pouvez souhaiter appliquer l'autorisation utilisateur.

Pour ce faire, procédez comme suit :

1. Dans les états dans lesquels vous voulez appliquer l'autorisation, définissez la propriété Nécessite une autorisation sur True. Cette propriété se trouve dans l'onglet Général de l'inspecteur de propriétés de l'état.

   Si un utilisateur qui atteint un tel état n'a pas encore autorisé, l'option Autoriser à l'aide de l'état OAuth est appelée, puis le flux appelle l'état requis pour l'autorisation.

2. Créez un composant d'autorisation et mettez-le en correspondance avec l'événement de transition standard Autoriser l'utilisateur du flux :
   1. Sélectionnez le flux, puis l'onglet Flux du flux.
   2. Cliquez deux fois sur la mosaïque Evénements du flux pour le développer.
   3. Placez le pointeur de la souris sur la mosaïque Autoriser l'utilisateur, cliquez sur le bouton Points de suspension (...) qui apparaît, puis sélectionnez Ajouter un état.
   4. Dans la catégorie Sécurité du sélecteur de modèle, sélectionnez un composant, indiquez le nom de l'état, puis cliquez sur Insérer.

      Pour plus d'informations sur chacun des modèles disponibles, reportez-vous à Modèles de sécurité.

   5. Dans l'inspecteur de propriétés du composant, configurez les propriétés du composant, y compris ses actions de transition.

Vous pouvez utiliser la fonction de numérotation automatique pour préfixer les boutons et les options de liste avec des numéros dans vos réponses.

Lorsque les utilisateurs ne peuvent pas utiliser le toucher, ils peuvent toujours déclencher les actions de postback du bouton en saisissant un nombre. Cette fonctionnalité est particulièrement utile pour les canaux de texte.

Vous configurez la numérotation automatique au niveau de la brique.

Pour configurer la numérotation automatique :

1. Dans la navigation de gauche de la brique, sélectionnez .
2. Sélectionnez l'onglet Configuration.
3. Définissez la valeur de Activer la numérotation automatique sur les actions de postback dans les flux de tâches.

   Si vous souhaitez activer la numérotation automatique pour tous les canaux, définissez la valeur sur true.

   Si vous souhaitez activer la numérotation automatique uniquement pour certains canaux, indiquez une expression pour déterminer les canaux qui recevront la numérotation automatique. Par exemple, pour activer la numérotation automatique uniquement pour les canaux Twilio, vous devez entrer :

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

Vous pouvez vous assurer que les utilisateurs ne restent pas bloqués sur une étape d'un flux de dialogue en configurant ce composant afin de limiter le nombre de fois où il répète une invite à l'utilisateur.

La propriété maxPrompts limite le nombre de fois où les composants de réponse commune peuvent inviter l'utilisateur lorsqu'ils ne trouvent pas de correspondance entre la valeur d'entrée et l'une des valeurs définies pour l'entité ou le type d'entrée référencé par la propriété variable. Vous pouvez utiliser cette propriété pour empêcher votre dialogue de tourner en rond lorsque les utilisateurs saisissent à plusieurs reprises des valeurs non valides. Vous pouvez définir le nombre maximal d'invites à l'aide d'un entier . Le dialogue passe à l'état suivant si l'utilisateur saisit une valeur valide avant d'atteindre cette limite. Sinon, le dialogue passe à l'état défini par l'action cancel.

Vous pouvez utiliser des groupes de ressources pour stocker toutes les chaînes visibles par l'utilisateur que vous ajoutez à votre flux de dialogue.

Vous référencez les clés de message de groupe de ressources via la variable rb. Une référence à un message de regroupement de ressources simple prend l'une des deux formes suivantes :

• ${skill.system.rb.RB_ENTRY_NAME}
• ${rb.RB_ENTRY_NAME}

Pour plus d'informations sur les groupes de ressources, notamment sur la création des entrées de groupe de ressources elles-mêmes et l'utilisation de formats de message complexes, reportez-vous à Groupes de ressources pour les briques.

Conseil :

La saisie semi-automatique vous aide à sélectionner les groupes de ressources référencés dans les expressions FreeMarker Apache.

Description de l'image autocomplete-resource-bundle-expression.png

Dans les flux de dialogue, vous pouvez également créer des formulaires d'entrée.

Parfois, un formulaire de saisie est la façon la plus rapide et la moins sujette aux erreurs de collecter des informations utilisateur. Plutôt que de soumettre les utilisateurs à une série de questions, votre brique peut les aider à fournir une entrée valide en leur envoyant des formulaires contenant des éléments d'entrée tels que des champs de saisie de texte, des sélecteurs d'heure et de date et des commutateurs à bascule.

Description de l'illustration editable-form-example.png

Dans votre brique, vous pouvez définir les paramètres client à référencer à partir des flux de dialogue.

Après avoir publié la brique, vous pouvez modifier les valeurs de ces paramètres (bien que vous ne puissiez pas modifier les autres détails des paramètres, ni ajouter ou supprimer des paramètres).

Les paramètres personnalisés sont présentés sous forme de variables skill.system.config à utiliser dans la définition de flux de dialogue. Par exemple, un paramètre personnalisé nommé faHostName est accessible à l'aide de l'expression suivante :

${skill.system.config.faHostName}

Pour pouvoir définir la valeur d'un paramètre d'une brique dans l'assistant numérique auquel vous ajoutez cette dernière, faites précéder le nom du paramètre de da. (sans oublier le point [.]). Par exemple, vous pouvez utiliser da.faHostName comme nom pour un paramètre de nom d'hôte.

Cette approche vous permet de définir des paramètres ayant le même nom dans plusieurs briques, d'ajouter toutes ces briques à un assistant numérique, puis de définir les valeurs des paramètres partagés à un seul endroit dans l'assistant numérique.

Pour accéder à un paramètre à partir d'un composant personnalisé, définissez un paramètre d'entrée dans le composant personnalisé, puis transmettez la valeur du paramètre de la brique à ce dernier.

Vous pouvez importer et exporter des flux de dialogue en mode visuel à l'aide des options Flux d'import et Exporter le flux sélectionné du menu Plus.

Description de l'image plus-flow-options.png