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
- Wybierz wejście Start call w swoim szkicu.
- Dodaj jego pola danych i oznacz wymagane.
- Wybierz późniejszy krok i otwórz jego rozszerzony edytor.
- 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:
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
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.