Sign inGet Started

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 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 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. 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

HasilArti dan tindakan berikutnya
SuccessEvent telah dimasukkan ke antrean untuk automation. Lanjutkan panggilan.
FailureEvent 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 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 tidak mengirim event. Pilih sampel berhasil atau gagal untuk langkah ini.

Gunakan definisi

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

Contoh kode
{
  "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" }
  }
}
KolomNilai
config{}.
input.automation_idWajib. ID automation di workspace ini.
input.eventWajib. Nama event automation: 1 hingga 128 huruf, angka, titik, garis bawah, atau tanda hubung.
input.dataOpsional, 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.
Hasilsuccess dan failure, masing-masing dengan output {}. failure yang tidak terhubung membuat proses gagal.

Langkah berikutnya

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini.