---
title: "Memulai Automation dari urutan suara"
description: "Kirim event aplikasi dari panggilan untuk memulai Automation tanpa menunggunya, lalu petakan data penelepon, panggilan, dan keypad ke dalam event tersebut."
canonical: "https://bird.com/id-id/dokumentasi/guides/voice/sequences/automations"
---

# Memulai Automation dari urutan suara

> **Peringatan:** Urutan suara masih dalam tahap pratinjau. Langkah, data masukan, dan format definisi urutan dapat berubah dengan cara yang merusak urutan yang sudah ada dan permintaan API.

Gunakan **Send Automation Event** untuk memulai Automation sementara panggilan tetap berlangsung. Misalnya, saat penelepon menekan 1 untuk meminta panggilan balik, kirim nomornya ke Automation yang menjadwalkan panggilan balik tersebut. Panggilan tidak menunggu eksekusi Automation selesai.

Langkah ini masih dalam tahap pratinjau. [Automations](/docs/guides/automations) masih dalam akses awal, dan izin workspace Anda menentukan apa yang dapat Anda konfigurasi.

## Menyiapkan automation

1. Buat automation dengan **Event from your application** sebagai pemicunya.
2. Isi **Event name**, misalnya `callback_requested`.
3. Tentukan **Event fields** untuk nilai yang akan dikirim oleh panggilan, seperti field string bernama `caller` dan `digits`.
4. Publikasikan automation tersebut.

Di dalam automation, `trigger.data` adalah amplop event, dan `trigger.data.data` adalah data yang Anda petakan, sehingga nomor penelepon berada di `trigger.data.data.caller`. [Hubungkan aplikasi Anda ke automation](/docs/guides/automations/application-events) menjelaskan amplop, nama event, field event, dan eksekusi.

## Menambahkan langkah

1. Tambahkan **Send Automation Event** pada jalur yang seharusnya memulai automation, misalnya pilihan keypad untuk panggilan balik.
2. Di bagian **Automation event**, pilih automation, lalu pilih event-nya. Daftar tersebut menampilkan event yang dapat dimulai oleh versi automation yang telah dipublikasikan.
3. Di bagian **Data**, isi field event tersebut. Setiap field dapat berupa nilai tetap, nilai dari data panggilan sebelumnya, atau, untuk field teks, teks yang menggabungkan keduanya. Jika event tidak memiliki field event, tambahkan nama dan nilai Anda sendiri.
4. Hubungkan hasil **Success** dan **Failure**.

Data yang Anda petakan adalah seluruh data event. Bird tidak menambahkan field apa pun, jadi petakan setiap nilai yang dibaca automation. Nomor penelepon ada di `execution.call.orig.address` dan bisa saja tidak tersedia, jadi [lindungi nilai tersebut](/docs/guides/voice/sequences/data). ID panggilan ada di `execution.call.id`, dan digit keypad ada di `steps.<gather step>.output.digits`. ID urutan tidak tersedia sebagai data panggilan; masukkan sebagai nilai tetap jika automation membutuhkannya.

Untuk memilih automation, Anda memerlukan izin membaca Automations. Tanpa izin tersebut, masukkan sendiri ID automation, nama event, dan datanya.

## Menangani hasil

| Hasil   | Arti dan tindakan berikutnya                                                                                               |
| ------- | -------------------------------------------------------------------------------------------------------------------------- |
| Success | Event telah dimasukkan ke antrean untuk automation. Lanjutkan panggilan.                                                   |
| Failure | Event tidak dapat dimasukkan ke antrean dalam beberapa detik. Lanjutkan panggilan, atau minta penelepon mencoba cara lain. |

Hasil kegagalan yang tidak terhubung mengakhiri proses sebagai gagal. Hubungkan hasil tersebut, bahkan ke langkah yang sama dengan hasil berhasil, jika panggilan harus tetap berlanjut apa pun hasilnya.

Kedua hasil tidak melaporkan apa yang dilakukan automation. Automation yang dijeda, belum dipublikasikan, atau dihapus, nama event yang tidak digunakannya, atau data yang tidak cocok dengan field event-nya tetap menghasilkan berhasil. Periksa tab **Runs** pada automation untuk melihat apakah proses dimulai.

## Periksa sebelum memublikasikan

Saat Anda memublikasikan urutan, sistem menampilkan peringatan tanpa memblokir jika automation yang dipilih tidak ada, dijeda, atau belum dipublikasikan, atau jika versi yang dipublikasikan tidak dapat memulai proses dari event yang dipilih. Automation yang dijeda atau event yang hanya digunakan oleh aturan tunggu atau pembatalan tetap memicu peringatan, meskipun event tersebut dapat melanjutkan atau membatalkan proses yang sudah berjalan. Jika Anda tidak memiliki izin membaca Automations, peringatan menyatakan bahwa langkah tersebut tidak diperiksa.

## Pengiriman

- Langkah ini hanya berjalan setelah panggilan dijawab. Panggilan yang tidak dijawab atau ditinggalkan tidak mengirim apa pun.
- Event biasanya sampai ke automation dalam waktu sekitar satu detik setelah langkah berjalan.
- Setiap kali panggilan melewati langkah ini, satu event dikirim, dan pengiriman berulang dari event tersebut dibuang. Perlindungan terhadap duplikat memiliki batas, jadi rancang automation agar dapat menangani pengulangan yang jarang terjadi.
- [Transfer](/docs/guides/voice/sequences/dial-and-transfer) yang kembali ke langkah ini mengirim event baru.
- Setiap event dikirim ke versi automation yang dipublikasikan, termasuk dari panggilan uji. Panggilan uji adalah panggilan sungguhan, dan automation dapat menjalankan tindakan sungguhan.
- [Pratinjau](/docs/guides/voice/sequences/preview) tidak mengirim event. Pilih sampel berhasil atau gagal untuk langkah ini.

## Gunakan definisi

Dalam definisi urutan, langkah ini adalah node `automation.send_event`:

```json
{
  "id": "notify",
  "type": "automation.send_event",
  "type_version": 1,
  "config": {},
  "input": {
    "automation_id": "atm_01jz8x3v4w5y6z7a8b9c0d1e2f",
    "event": "callback_requested",
    "data": {
      "caller": {
        "$expr": "execution.call.orig != null && has(execution.call.orig.address) ? execution.call.orig.address : ''"
      },
      "digits": { "$expr": "steps.menu.output.digits" }
    }
  },
  "connections": {
    "success": { "node_id": "confirm", "port": "input" },
    "failure": { "node_id": "confirm", "port": "input" }
  }
}
```

| Kolom                 | Nilai                                                                                                                                                                                                                              |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `config`              | `{}`.                                                                                                                                                                                                                              |
| `input.automation_id` | Wajib. ID automation di workspace ini.                                                                                                                                                                                             |
| `input.event`         | Wajib. Nama event automation: 1 hingga 128 huruf, angka, titik, garis bawah, atau tanda hubung.                                                                                                                                    |
| `input.data`          | Opsional, default `{}`. Objek yang setiap nilai tingkat atasnya diikat dengan `$expr` atau `$template`, atau satu `$expr` untuk seluruh objek. Nilai yang bersarang lebih dalam tetap literal. Maksimal 16 KiB bersama sisa input. |
| Hasil                 | `success` dan `failure`, masing-masing dengan output `{}`. `failure` yang tidak terhubung membuat proses gagal.                                                                                                                    |

## Langkah berikutnya

- [Gunakan data panggilan](/docs/guides/voice/sequences/data) dalam pemetaan.
- [Konfigurasikan menu keypad](/docs/guides/voice/sequences/media-and-keypad) untuk pilihan keypad.
- [Hubungkan aplikasi Anda ke automation](/docs/guides/automations/application-events).

## Related resources

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