Data gebruiken in een spraaksequentie

Waarschuwing: Spraaksequenties zijn in preview. Stappen, invoerdata en de indeling van de sequentiedefinitie kunnen zodanig veranderen dat bestaande sequenties en API-verzoeken niet meer werken.

Definieer de data die een oproepinvoer accepteert en gebruik die data vervolgens in ondersteunde stapvelden. Een herinnering kan bijvoorbeeld een klantnaam en afspraaktijd accepteren van de applicatie die de oproep start.

Gebruik de veldkiezer om te zien welke bronnen en waardemodi de geselecteerde stap ondersteunt.

Invoerdata definiëren

1. Selecteer de Start call-vermelding in je concept.
2. Voeg de datavelden toe en markeer de verplichte velden.
3. Selecteer een latere stap en open de uitgebreide editor.
4. Kies een veld uit Available data en bekijk een voorbeeld met representatieve invoerdata.

De sequence.trigger_data van een API-oproep moet een object zijn dat overeenkomt met het schema van de geselecteerde invoer. Geef {} mee wanneer de invoer geen data nodig heeft. Een inkomende nummerroute levert {}, dus de invoer moet een leeg object accepteren. Houd inkomende velden optioneel en verwerk ontbrekende waarden in latere stappen.

Applicatiedata staat los van de oproepidentiteit. Een veld met de naam caller dat door je applicatie wordt meegestuurd, stelt niet vast wie er belt en verleent geen toestemming om een nummer te gebruiken.

Een waarde toewijzen of tekst samenstellen

Ondersteunde velden bieden vaste waarden, waarden uit eerdere stappen, tekst met ingevoegde waarden of fx-expressies. Gebruik een directe waarde voor een getypeerd veld en tekst met ingevoegde waarden voor gesproken zinnen. Een string met cijfers blijft tekst.

Definieer bijvoorbeeld een verplicht stringveld met de naam customer_name op de invoer. Combineer in een ondersteund spraakveld Hello, een spatie, de veldwaarde en , your appointment is confirmed. Bekijk een voorbeeld met {"customer_name":"Ada"} om de voorbereide tekst te inspecteren.

Spraakexpressies lezen invoervelden als trigger.data.customer_name. Eerdere in aanmerking komende uitvoer gebruikt steps.<step_id>.output. De bronkiezer helpt je de juiste stap en het juiste veld te kiezen.

Ontbrekende data en vertakkingen afhandelen

Optionele velden kunnen afwezig, null of leeg zijn. Bekijk die gevallen in het voorbeeld en kies een expliciete terugvalwaarde wanneer dat passend is. Een stap op een niet-genomen pad heeft in die uitvoering geen uitvoer.

Oproepobservaties staan onder execution. Het nummer van de oorspronkelijke beller kan bijvoorbeeld afwezig zijn. Een beveiligde expressie leest het veilig uit:

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

Deze observaties beschrijven telefooneindpunten; ze authenticeren geen persoon. Het voorbeeld heeft een uitvoeringsample nodig wanneer een bereikte expressie execution gebruikt. Zonder sample stopt het voorbeeld vóór de evaluatie van die stap. Lever het aan via Advanced scenario JSON, volgens de structuur die door validatie wordt gemeld.

Privétoetsenbord-observaties zijn niet beschikbaar voor latere expressiebronnen of vastgehouden stapdetails. Ontwerp geen later spraak- of resultaatveld rond privécijfers.

Data doorgeven bij een doorverbinding

Een lokale Transfer levert een nieuw object aan de bestemmingsinvoer. Wijs de waarden toe die die invoer nodig heeft en controleer de verplichte velden.

De bestemming ontvangt nieuwe trigger.data en eerdere stapuitvoer wordt gewist. Oproepidentiteit, opnamestatus en uitvoeringslimieten blijven bestaan. Een waarde expliciet meegeven is nodig wanneer de nieuwe invoer informatie uit het vorige pad nodig heeft.

Volgende stappen

• Prompts en toetsenbordmenu's configureren.
• Oproepen kiezen en doorverbinden.
• Een sequentie bekijken en controleren.
• Een oproep starten via de API.