---
title: "Utiliser des données dans une séquence vocale"
description: "Définissez les champs d'entrée d'appel, associez des valeurs aux étapes de la séquence, et gérez les informations optionnelles de l'appelant ainsi que les nouvelles portées de données après un transfert."
canonical: "https://bird.com/fr-fr/documentation/guides/voice/sequences/data"
---

# Utiliser des données dans une séquence vocale

> **Avertissement :** les séquences vocales sont en préversion. Les étapes, les données d'entrée et le format de définition des séquences peuvent changer d'une manière qui casse les séquences existantes et les requêtes API.

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é :

```text
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 de nouvelles `trigger.data`, 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 sont conservés. Transmettez explicitement une valeur 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](/docs/guides/voice/sequences/media-and-keypad).
- [Composer et transférer des appels](/docs/guides/voice/sequences/dial-and-transfer).
- [Prévisualiser et vérifier une séquence](/docs/guides/voice/sequences/preview).
- [Créer un appel via le API](/docs/guides/voice/create-calls).

## Related resources

- [Voice sequences](/docs/guides/voice/sequence-builder) (docs)