Utiliser des données dans une séquence vocale

Warning: Voice sequences are in preview. Steps, entry data, and the sequence definition format can change in ways that break existing sequences and API requests.

Définissez les données acceptées par une entrée d'appel, puis utilisez ces données dans les champs d'étape pris en charge. Un rappel de rendez-vous peut accepter un nom de client et une heure de rendez-vous depuis l'application qui lance l'appel.

Utilisez le sélecteur de champ pour voir quelles sources et quels modes de valeur l'étape sélectionnée prend en charge.

Définir les données d'entrée

1. Sélectionnez l'entrée Start call dans votre brouillon.
2. Ajoutez ses champs de données et marquez ceux qui sont obligatoires.
3. Sélectionnez une étape ultérieure et ouvrez son éditeur détaillé.
4. Choisissez un champ dans Available data, puis prévisualisez-le avec des données d'entrée représentatives.

Le sequence.trigger_data d'un appel API doit être un objet correspondant au schéma de l'entrée sélectionnée. Fournissez {} lorsque l'entrée n'a besoin d'aucune donnée. Un routage par numéro entrant fournit {}, donc son entrée doit accepter un objet vide. Gardez les champs entrants optionnels et gérez les valeurs manquantes dans les étapes suivantes.

Les données applicatives sont distinctes de l'identité de l'appel. Un champ nommé caller fourni par votre application n'établit pas l'identité de l'appelant et n'accorde pas la permission d'utiliser un numéro.

Associer une valeur ou composer du texte

Les champs pris en charge proposent des valeurs fixes, des valeurs issues d'étapes précédentes, du texte avec des valeurs insérées, ou des expressions fx. Utilisez une valeur directe pour un champ typé et du texte avec des valeurs insérées pour les phrases prononcées. Une chaîne contenant des chiffres reste du texte.

Par exemple, définissez un champ de chaîne obligatoire nommé customer_name sur l'entrée. Dans un champ de synthèse vocale pris en charge, combinez Hello, un espace, la valeur du champ, et , your appointment is confirmed. Prévisualisez avec {"customer_name":"Ada"} pour inspecter le texte préparé.

Les expressions vocales lisent les champs d'entrée sous la forme trigger.data.customer_name. Les sorties éligibles précédentes utilisent steps.<step_id>.output. Le sélecteur de source vous aide à choisir l'étape et le champ corrects.

Gérer les données manquantes et les branches

Les champs optionnels peuvent être absents, null ou vides. Prévisualisez ces cas et choisissez une valeur de repli explicite lorsque c'est approprié. Une étape sur un chemin non emprunté n'a pas de sortie pour cette exécution.

Les observations d'appel se trouvent sous execution. Par exemple, le numéro de l'appelant d'origine peut être absent. Une expression protégée le lit en toute sécurité :

execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''

Ces observations décrivent des terminaux téléphoniques ; elles n'authentifient pas une personne. La prévisualisation a besoin d'un échantillon d'exécution lorsqu'une expression atteinte utilise execution. Sans cela, la prévisualisation s'arrête avant d'évaluer cette étape. Fournissez-le via Advanced scenario JSON, en suivant la structure indiquée par la validation.

Les observations de clavier privées ne sont pas accessibles aux sources d'expression ultérieures ni au détail conservé de l'étape. Ne concevez pas un champ de synthèse vocale ou de résultat ultérieur autour de chiffres privés.

Transmettre des données via un transfert

Un Transfer local fournit un nouvel objet à l'entrée de destination. Associez les valeurs dont cette entrée a besoin et vérifiez ses champs obligatoires.

La destination reçoit des trigger.data nouvelles, et les sorties des étapes précédentes sont effacées. L'identité de l'appel, l'état d'enregistrement et les limites d'exécution persistent. Transmettre une valeur explicitement est nécessaire lorsque la nouvelle entrée a besoin d'informations provenant du chemin précédent.

Étapes suivantes

• Configurer les invites et les menus de clavier.
• Composer et transférer des appels.
• Prévisualiser et vérifier une séquence.
• Créer un appel via le API.