Daten in einer Sprachsequenz verwenden

Warnung: Sprachsequenzen befinden sich in der Vorschauphase. Schritte, Eingangsdaten und das Format der Sequenzdefinition können sich so ändern, dass bestehende Sequenzen und API-Anfragen nicht mehr funktionieren.

Definieren Sie die Daten, die ein Anrufeingang akzeptiert, und verwenden Sie diese Daten in unterstützten Schrittfeldern. Eine Erinnerung könnte einen Kundennamen und einen Terminzeitpunkt von der Anwendung übernehmen, die den Anruf startet.

Verwenden Sie die Feldauswahl, um zu sehen, welche Quellen und Wertmodi der ausgewählte Schritt unterstützt.

Eingangsdaten definieren

1. Wählen Sie den Eingang Start call in Ihrem Entwurf aus.
2. Fügen Sie die Datenfelder hinzu und markieren Sie die Pflichtfelder.
3. Wählen Sie einen späteren Schritt aus und öffnen Sie seinen erweiterten Editor.
4. Wählen Sie ein Feld aus Available data und prüfen Sie es mit repräsentativen Eingangsdaten in der Vorschau.

Das sequence.trigger_data eines API-Anrufs muss ein Objekt sein, das dem Schema des gewählten Eingangs entspricht. Übergeben Sie {}, wenn der Eingang keine Daten benötigt. Eine eingehende Nummernroute liefert {}, daher muss ihr Eingang ein leeres Objekt akzeptieren. Halten Sie eingehende Felder optional und behandeln Sie fehlende Werte in späteren Schritten.

Anwendungsdaten sind von der Anrufidentität getrennt. Ein Feld namens caller, das von Ihrer Anwendung bereitgestellt wird, legt nicht fest, wer anruft, und erteilt keine Berechtigung zur Nutzung einer Nummer.

Einen Wert zuordnen oder Text zusammensetzen

Unterstützte Felder bieten feste Werte, Werte aus früheren Schritten, Text mit eingefügten Werten oder fx-Ausdrücke. Verwenden Sie einen direkten Wert für ein typisiertes Feld und Text mit eingefügten Werten für gesprochene Sätze. Eine Zeichenkette mit Ziffern bleibt Text.

Definieren Sie zum Beispiel ein Pflicht-Stringfeld namens customer_name am Eingang. Kombinieren Sie in einem unterstützten Sprachfeld Hello, ein Leerzeichen, den Feldwert und , your appointment is confirmed.. Prüfen Sie den vorbereiteten Text mit {"customer_name":"Ada"} in der Vorschau.

Sprachausdrücke lesen Eingangsfelder als trigger.data.customer_name. Frühere berechtigte Ausgaben verwenden steps.<step_id>.output. Die Quellenauswahl hilft Ihnen, den richtigen Schritt und das richtige Feld zu wählen.

Fehlende Daten und Verzweigungen behandeln

Optionale Felder können fehlen, null oder leer sein. Prüfen Sie diese Fälle in der Vorschau und wählen Sie einen expliziten Fallback, wenn es angemessen ist. Ein Schritt auf einem nicht genommenen Pfad hat in diesem Durchlauf keine Ausgabe.

Anrufbeobachtungen befinden sich unter execution. Zum Beispiel kann die Nummer des ursprünglichen Anrufers fehlen. Ein abgesicherter Ausdruck liest sie sicher:

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

Diese Beobachtungen beschreiben Telefonendpunkte; sie authentifizieren keine Person. Die Vorschau benötigt ein Ausführungsbeispiel, wenn ein erreichter Ausdruck execution verwendet. Ohne eines stoppt die Vorschau vor der Auswertung dieses Schritts. Stellen Sie es über Advanced scenario JSON bereit, entsprechend der von der Validierung gemeldeten Struktur.

Private Tastatureingaben sind für spätere Ausdrucksquellen oder gespeicherte Schrittdetails nicht verfügbar. Entwerfen Sie kein späteres Sprach- oder Ergebnisfeld auf Basis privater Ziffern.

Daten über eine Weiterleitung übergeben

Ein lokaler Transfer liefert ein neues Objekt an den Zieleingang. Ordnen Sie die Werte zu, die dieser Eingang benötigt, und prüfen Sie seine Pflichtfelder.

Das Ziel erhält neue trigger.data, und frühere Schrittausgaben werden gelöscht. Anrufidentität, Aufnahmestatus und Ausführungslimits bleiben bestehen. Ein Wert muss explizit übergeben werden, wenn der neue Eingang Informationen aus dem vorherigen Pfad benötigt.

Nächste Schritte

• Ansagen und Tastaturmenüs konfigurieren.
• Anrufe wählen und weiterleiten.
• Sequenz in der Vorschau prüfen.
• Einen Anruf über die API erstellen.