---
title: "Używanie danych w sekwencji głosowej"
description: "Definiuj pola wejściowe połączenia, mapuj wartości do kroków sekwencji i obsługuj opcjonalne informacje o dzwoniącym oraz nowe zakresy danych po przekierowaniu."
canonical: "https://bird.com/pl-pl/dokumentacja/guides/voice/sequences/data"
---

# Używanie danych w sekwencji głosowej

> **Ostrzeżenie:** Sekwencje głosowe są w wersji zapoznawczej. Kroki, dane wejściowe i format definicji sekwencji mogą się zmienić w sposób, który zepsuje istniejące sekwencje i żądania API.

Zdefiniuj dane akceptowane przez wejście połączenia, a następnie wykorzystaj je w obsługiwanych polach kroków. Przypomnienie może przyjmować imię klienta i godzinę wizyty z aplikacji inicjującej połączenie.

Użyj selektora pól, aby sprawdzić, które źródła i tryby wartości obsługuje wybrany krok.

## Definiowanie danych wejściowych

1. Wybierz wejście **Start call** w swoim szkicu.
2. Dodaj jego pola danych i oznacz wymagane.
3. Wybierz późniejszy krok i otwórz jego rozszerzony edytor.
4. Wybierz pole z **Available data**, a następnie wyświetl podgląd z reprezentatywnymi danymi wejściowymi.

Pole `sequence.trigger_data` połączenia API musi być obiektem zgodnym ze schematem wybranego wejścia. Podaj `{}`, gdy wejście nie wymaga danych. Trasa numeru przychodzącego dostarcza `{}`, więc jej wejście musi akceptować pusty obiekt. Oznaczaj pola przychodzące jako opcjonalne i obsługuj brakujące wartości w kolejnych krokach.

Dane aplikacji są niezależne od tożsamości połączenia. Pole o nazwie `caller` dostarczone przez aplikację nie ustala, kto dzwoni, ani nie daje uprawnień do użycia numeru.

## Mapowanie wartości lub tworzenie tekstu

Obsługiwane pola oferują wartości stałe, wartości z wcześniejszych kroków, tekst z wstawionymi wartościami lub wyrażenia **fx**. Użyj wartości bezpośredniej dla pola typowanego, a tekstu z wstawionymi wartościami dla wypowiadanych zdań. Ciąg zawierający cyfry pozostaje tekstem.

Na przykład zdefiniuj wymagane pole tekstowe o nazwie `customer_name` na wejściu. W obsługiwanym polu mowy połącz `Hello`, spację, wartość pola i `, your appointment is confirmed.` Wyświetl podgląd z `{"customer_name":"Ada"}`, aby sprawdzić przygotowany tekst.

Wyrażenia głosowe odczytują pola wejściowe jako `trigger.data.customer_name`. Wcześniejsze kwalifikujące się wyjścia używają `steps.<step_id>.output`. Selektor źródeł pomaga wybrać właściwy krok i pole.

## Obsługa brakujących danych i rozgałęzień

Pola opcjonalne mogą być nieobecne, null lub puste. Wyświetl podgląd tych przypadków i wybierz jawną wartość zastępczą, gdy jest to właściwe. Krok na niewybranej ścieżce nie ma wyjścia w danym przebiegu.

Obserwacje połączenia znajdują się w `execution`. Na przykład numer pierwotnego dzwoniącego może być nieobecny. Wyrażenie z zabezpieczeniem odczytuje go bezpiecznie:

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

Te obserwacje opisują punkty końcowe telefoniczne; nie uwierzytelniają osoby. Podgląd wymaga próbki wykonania, gdy osiągnięte wyrażenie używa `execution`. Bez niej podgląd zatrzymuje się przed ewaluacją tego kroku. Dostarcz ją przez **Advanced scenario JSON**, zgodnie ze strukturą zgłoszoną przez walidację.

Prywatne obserwacje klawiatury są niedostępne dla późniejszych źródeł wyrażeń ani zachowanych szczegółów kroku. Nie projektuj późniejszego pola mowy ani wyniku w oparciu o prywatne cyfry.

## Przekazywanie danych przez przekierowanie

Lokalny krok **Transfer** dostarcza nowy obiekt do wejścia docelowego. Zmapuj wartości wymagane przez to wejście i sprawdź jego pola obowiązkowe.

Miejsce docelowe otrzymuje świeże `trigger.data`, a wyjścia wcześniejszych kroków są czyszczone. Tożsamość połączenia, stan nagrywania i limity wykonania są zachowane. Jawne przekazanie wartości jest konieczne, gdy nowe wejście potrzebuje informacji z poprzedniej ścieżki.

## Następne kroki

- [Konfigurowanie komunikatów i menu klawiatury](/docs/guides/voice/sequences/media-and-keypad).
- [Wybieranie numeru i przekierowywanie połączeń](/docs/guides/voice/sequences/dial-and-transfer).
- [Podgląd i sprawdzanie sekwencji](/docs/guides/voice/sequences/preview).
- [Tworzenie połączenia przez API](/docs/guides/voice/create-calls).

## Related resources

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