Menggunakan data dalam sequence suara
Peringatan: Sequence suara masih dalam tahap pratinjau. Langkah, data entri, dan format definisi sequence dapat berubah dengan cara yang merusak sequence dan permintaan API yang sudah ada.
Tentukan data yang diterima oleh entri panggilan, lalu gunakan data tersebut di field langkah yang didukung. Misalnya, pengingat dapat menerima nama pelanggan dan waktu janji temu dari aplikasi yang memulai panggilan.
Gunakan pemilih field untuk melihat sumber dan mode nilai yang didukung oleh langkah yang dipilih.
Tentukan data entri
- Pilih entri Start call di draf Anda.
- Tambahkan field datanya dan tandai yang wajib diisi.
- Pilih langkah berikutnya dan buka editor lengkapnya.
- Pilih field dari Available data, lalu pratinjau dengan data entri representatif.
sequence.trigger_data panggilan API harus berupa objek yang sesuai dengan skema entri yang dipilih. Berikan {} jika entri tidak memerlukan data. Rute nomor masuk menyediakan {}, sehingga entrinya harus menerima objek kosong. Buat field masuk opsional dan tangani nilai yang hilang di langkah-langkah berikutnya.
Data aplikasi terpisah dari identitas panggilan. Field bernama caller yang dikirim oleh aplikasi Anda tidak menetapkan siapa yang menelepon atau memberikan izin untuk menggunakan suatu nomor.
Petakan nilai atau susun teks
Field yang didukung menawarkan nilai tetap, nilai dari langkah sebelumnya, teks dengan nilai yang disisipkan, atau ekspresi fx. Gunakan nilai langsung untuk field bertipe dan teks dengan nilai yang disisipkan untuk kalimat yang diucapkan. String yang berisi angka tetap berupa teks.
Misalnya, tentukan field string wajib bernama customer_name pada entri. Di field ucapan yang didukung, gabungkan Hello, spasi, nilai field, dan , your appointment is confirmed. Pratinjau dengan {"customer_name":"Ada"} untuk memeriksa teks yang disiapkan.
Ekspresi suara membaca field entri sebagai trigger.data.customer_name. Output sebelumnya yang memenuhi syarat menggunakan steps.<step_id>.output. Pemilih sumber membantu Anda memilih langkah dan field yang benar.
Menangani data yang hilang dan percabangan
Field opsional dapat tidak ada, null, atau kosong. Pratinjau kasus-kasus tersebut dan pilih fallback eksplisit jika diperlukan. Langkah pada jalur yang tidak diambil tidak memiliki output pada eksekusi tersebut.
Observasi panggilan berada di bawah execution. Misalnya, nomor pemanggil asli bisa tidak tersedia. Ekspresi berjaga membacanya dengan aman:
execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''Observasi ini mendeskripsikan endpoint telepon; tidak mengautentikasi seseorang. Pratinjau memerlukan sampel eksekusi jika ekspresi yang dijangkau menggunakan execution. Tanpa sampel, pratinjau berhenti sebelum mengevaluasi langkah tersebut. Berikan melalui Advanced scenario JSON, mengikuti bentuk yang dilaporkan oleh validasi.
Observasi keypad privat tidak tersedia untuk sumber ekspresi berikutnya atau detail langkah yang disimpan. Jangan merancang field ucapan atau hasil di langkah berikutnya berdasarkan digit privat.
Meneruskan data melalui transfer
Transfer lokal menyediakan objek baru ke entri tujuan. Petakan nilai yang dibutuhkan entri tersebut dan periksa field wajibnya.
Tujuan menerima trigger.data baru, dan output langkah sebelumnya dihapus. Identitas panggilan, status perekaman, dan batas eksekusi tetap berlanjut. Meneruskan nilai secara eksplisit diperlukan jika entri baru membutuhkan informasi dari jalur sebelumnya.
Langkah berikutnya
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.