---
title: "Menggunakan data dalam sequence suara"
description: "Tentukan field data masuk panggilan, petakan nilai ke langkah-langkah sequence, dan tangani informasi pemanggil opsional serta cakupan data baru setelah transfer."
canonical: "https://bird.com/id-id/dokumentasi/guides/voice/sequences/data"
---

# 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

1. Pilih entri **Start call** di draf Anda.
2. Tambahkan field datanya dan tandai yang wajib diisi.
3. Pilih langkah berikutnya dan buka editor lengkapnya.
4. 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:

```text
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

- [Konfigurasi prompt dan menu keypad](/docs/guides/voice/sequences/media-and-keypad).
- [Panggil dan transfer panggilan](/docs/guides/voice/sequences/dial-and-transfer).
- [Pratinjau dan periksa sequence](/docs/guides/voice/sequences/preview).
- [Buat panggilan melalui API](/docs/guides/voice/create-calls).

## Related resources

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