Membatalkan pesanan komponen bawaan

Pesanan pembatalan komponen bawaan memeriksa tingkat otentikasi pengguna. Setelah pengguna diotentikasi, memberikan informasi tentang pesanan terbaru atau sebelumnya dari pengguna. Tujuan maka pengguna dapat memilih untuk membatalkan seluruh pesanan atau membatalkan item tertentu pesanan. Komponen ini menggunakan atribut Autentikasi retail komponen bawaan untuk mengotentikasi pengguna. Komponen ini juga menggunakan Generator untuk pasca-panggilan perangkuman dokumen.

Batasan

Selain pasal batasan komponen bawaan yang umum, komponen bawaan ini memiliki batasan berikut:

  • Komponen ini tidak mengenkripsi data apa pun.

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh metode ini komponen bawaan asli. Contoh dialog menunjukkan perilaku saat komponen yang dipanggil menggunakan telepon, yang memicu Niat Selamat Datang Default dan respons agen di awal percakapan.

Batalkan satu produk dalam pesanan terbaru

Pengguna akhir telah diautentikasi sebelumnya. Agen mengonfirmasi item mana dari pesanan terbaru harus dibatalkan. Agen memeriksa metode asli pembayaran Anda dan mengonfirmasi detail pembatalannya dengan pengguna.

Input pengguna Respons agen
Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang diakhiri dengan 12978 yang berisi 5 botol minum dan 1 kaus yang ditempatkan pada 09-11-2023 pukul 20.00?
ya
Kami menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Harap beri tahu kami produk mana yang ingin Anda batalkan.
Produk 1: botol air google, Produk 2: kaus google.

Harap ucapkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan "berikutnya" untuk menampilkan lebih banyak produk.
berikutnya
Kami tidak menemukan item lain dalam catatan kami. Silakan pilih dari daftar bersama.
Produk 1: botol air google, Produk 2: kaus google.

Sebutkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan "berikutnya" untuk menampilkan lebih banyak produk.
1
Untuk memverifikasi, Anda tertarik untuk membatalkan botol air Google. Apakah ini benar?
ya
Kita dapat melihat bahwa jumlah produk yang tersedia yang Anda pilih adalah 5. Tentukan jumlah produk yang ingin Anda batalkan.
4
Harap sebutkan alasan pembatalan. Anda dapat mengatakan misalnya: berubah pikiran, tidak perlu lagi, saya ingin membeli item lain, menunda pengiriman, membeli secara tidak sengaja, ingin mengubah metode pembayaran, atau mengatakan orang lain.
Saya ingin membeli item lain
Terima kasih telah memberi tahu kami.

Ingin membatalkan produk lain?
tidak
Untuk pembelian yang dilakukan dengan dompet Anda, pengembalian dana akan dikreditkan ke dompet atau akun kredit toko. Perlu waktu 3 hingga 5 hari kerja agar pengembalian dana muncul di rekening Anda. Harap diperhatikan bahwa jumlah pengembalian dana tidak akan mencakup biaya pengiriman dan penanganan.

Batalkan seluruh pesanan

Pengguna akhir telah diautentikasi sebelumnya. Agen mengonfirmasi bahwa pengguna ingin membatalkan pesanan tertentu, kemudian mengumpulkan alasan pembatalan. Tujuan agen memeriksa metode pembayaran asli dan mengonfirmasi pembatalan detail dengan pengguna.

Input pengguna Respons agen
Apakah Anda menghubungi kami terkait nomor pesanan terbaru Anda yang diakhiri dengan 12345 yang berisi 1 kemeja yang ditempatkan di 10-11-2023 pukul 18.00?
tidak
Ingin membatalkan pesanan lain?
ya
Bisakah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin Anda lacak?
12346
Lima digit terakhir dari ID pesanan yang kita dapatkan adalah 12346, apa itu benar?
ya
Oke, kami sudah selesai mengumpulkan ID pesanan.

Anda ingin membatalkan seluruh pesanan?
ya
Harap sebutkan alasan pembatalan. Anda dapat mengatakan misalnya: berubah pikiran, tidak perlu lagi, saya ingin membeli item lain, menunda pengiriman, membeli secara tidak sengaja, ingin mengubah metode pembayaran, atau mengatakan orang lain.
sudah tidak dibutuhkan
Terima kasih telah memberi tahu kami.

Permintaan pembatalan Anda telah dibuat.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Flow [Nama Komponen] Batalkan Pesanan
Jenis Entitas prebuilt_components_[component_name]_[entity_type] prebuilt_components_product_cancel_reason
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_cancel_order:post_cancellation_details

Parameter input

Parameter input adalah parameter yang digunakan untuk mengkonfigurasi perilaku tertentu dari komponennya. Parameter akan digunakan oleh satu atau beberapa kondisi dalam untuk menentukan bagaimana komponen harus berperilaku. Parameter cakupan alur harus diatur pada halaman awal komponen. Cakupan sesi parameter dapat disetel oleh alur panggilan, atau di awal dari komponen ini.

Komponen bawaan ini menerima parameter input berikut:

Nama Parameter Deskripsi Format Input
$session.params.phone_number (opsional) Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. string
$session.params.all_recent_order_id (opsional) Parameter ini mencantumkan ID pesanan yang terkait dengan pengguna terautentikasi, yang diurutkan menurut tanggal penempatan pesanan dalam urutan menurun. Elemen pertama array mewakili urutan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah null. Daftar (string)
$session.params.email (opsional) Email yang terdaftar di akun. string
$session.params.user_first_name (opsional) Nama depan pengguna, digunakan untuk menyambut dan mengonfirmasi kepemilikan akun. string

Komponen bawaan ini memungkinkan parameter opsional berikut untuk dikonfigurasi perilaku komponen, termasuk percobaan ulangnya.

Nama Parameter Deskripsi Format
$flow.max_retry_another_account_counter Menentukan jumlah percobaan ulang yang diizinkan saat memilih apakah akan melanjutkan dengan akun alternatif. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_retry_order_number Menentukan jumlah percobaan ulang yang diizinkan saat memberikan lima digit terakhir nomor pesanan. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_retry_another_order Menentukan jumlah percobaan ulang yang diizinkan saat memilih pesanan lain jika ID pesanan tidak ditemukan atau pesanan tidak memenuhi syarat untuk dibatalkan. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_retry_select_order_number Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan lengkap jika beberapa pesanan memiliki lima digit terakhir yang sama. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_product_display_counter Menentukan jumlah maksimum produk untuk ditampilkan dalam satu putaran. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_product_display Menentukan jumlah maksimum produk yang akan ditampilkan di seluruh percakapan. Nilai defaultnya adalah 9. bilangan bulat
$flow.max_retry_product_number_counter Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memilih produk yang akan dibatalkan. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_product_cancel_confirm_counter Menentukan jumlah percobaan ulang maksimum yang diizinkan saat mengonfirmasi produk yang dipilih. Nilai defaultnya adalah 2. bilangan bulat
$flow.max_retry_select_quantity Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memilih jumlah produk yang akan dibatalkan. Nilai defaultnya adalah 2. bilangan bulat
$flow.order_product_cancel_reason_others Menentukan nilai entity prebuilt_components_product_cancel_reason yang menunjukkan bahwa pengguna telah memilih "lainnya" alasan pembatalan. Nilai defaultnya adalah "others". string
$flow.max_retry_cancel_reason Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi alasan pembatalan. Nilai defaultnya adalah 2. bilangan bulat
$flow.order_payment_mode_COD Menentukan nilai kolom order_payment_mode yang ditampilkan oleh webhook get_order_details yang menunjukkan metode pembayaran bayar di tempat (COD). Nilai defaultnya adalah "COD". string
$flow.order_payment_mode_store_credit Menentukan nilai kolom order_payment_mode yang ditampilkan oleh webhook get_order_details yang menunjukkan metode pembayaran kredit toko. Nilai defaultnya adalah "store_credit". string

Untuk mengonfigurasi parameter input bagi komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Flows.
  6. Klik Halaman Awal di bagian Halaman.
  7. Klik Rute true di Halaman Awal.
  8. Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
  9. Klik Simpan.

Parameter output

Parameter output adalah parameter sesi yang akan tetap aktif setelah keluar komponennya. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen. Komponen bawaan ini memberikan nilai untuk output berikut parameter:

Nama Parameter Deskripsi Format Output
phone_number Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. string
all_recent_order_id Parameter ini mencantumkan ID pesanan yang terkait dengan pengguna terautentikasi, yang diurutkan berdasarkan tanggal penempatan pesanan dalam urutan menurun. Elemen pertama array mewakili urutan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah null. Daftar (string)
email Email yang terdaftar dengan akun tersebut. string
user_first_name Nama depan pengguna, digunakan untuk menyambut dan mengonfirmasi kepemilikan akun. string
transfer_reason Parameter ini menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:

agent: pengguna akhir meminta agen manusia pada suatu saat selama percakapan.

denial_of_information: pengguna akhir menolak memberikan informasi yang diminta oleh komponen.

max_no_input: percakapan mencapai jumlah percobaan ulang maksimum untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input.

max_no_match: percakapan mencapai jumlah percobaan ulang maksimum untuk peristiwa ketidakcocokan. Lihat peristiwa bawaan yang tidak cocok.

webhook_error: terjadi error webhook. Lihat peristiwa bawaan webhook.error.

webhook_not_found: URL webhook tidak dapat dijangkau. Lihat peristiwa bawaan webhook.error.not-found bawaan.
string

Generator

Komponen ini menggunakan Generator untuk mengaktifkan bagian tertentu dari percakapan.

Perangkuman

Generator Summarization digunakan untuk membuat ringkasan pasca-panggilan yang menjelaskan percakapan yang ditangani oleh komponen tersebut.

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

  1. Impor komponen bawaan.
  2. Konfigurasi alamat IP yang disediakan web webhook fleksibel dengan yang menjelaskan layanan eksternal Dialogflow Anda, lihat Webhook penyiapan.

Penyiapan webhook

Untuk menggunakan komponen ini, Anda perlu mengonfigurasi web webhook fleksibel untuk mengambil informasi yang dibutuhkan dari layanan eksternal Anda.

Autentikasi

Jika Anda belum pernah mengonfigurasi layanan eksternal yang diperlukan untuk Anda perlu mengkonfigurasi mereka untuk mengaktifkan otentikasi dari pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi retail untuk petunjuk terperinci.

Dapatkan detail pesanan

Webhook prebuilt_components_cancel_order:get_order_details digunakan oleh komponen untuk mengambil detail pesanan untuk pesanan tertentu.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter Deskripsi Format Input
$flow.order_id ID Pesanan untuk mengambil detailnya. string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
order_date Tanggal pesanan dilakukan, dalam format YYYY-MM-DD. string
order_time Waktu pemesanan dilakukan, dalam format HH:MM. string
order_product_count Jumlah produk unik dalam pesanan. bilangan bulat
order_payment_mode Menunjukkan mode pembayaran yang digunakan saat melakukan pemesanan. string
cancelable_product_id Daftar ID produk untuk produk yang dapat dibatalkan dalam pesanan. Daftar (string)
cancelable_product_name Daftar nama produk untuk produk yang dapat dibatalkan dalam pesanan. Daftar (string)
cancelable_product_brand_name Daftar nama merek untuk produk yang dapat dibatalkan dalam pesanan. Daftar (string)
cancelable_product_quantity Daftar jumlah untuk produk yang dapat dibatalkan dalam pesanan. Daftar (string)

Untuk mengonfigurasi webhook Dapatkan detail pesanan untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_cancel_order:get_order_details.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
  9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Simpan.

Dapatkan detail pesanan duplikat

Webhook prebuilt_components_retail_services:get_duplicate_order_details digunakan oleh komponen untuk mengambil informasi yang rinci untuk membedakan antara pesanan jika beberapa nomor pesanan memiliki lima digit terakhir yang sama.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter Deskripsi Format Input
$flow.duplicate_order_id Daftar yang berisi lima digit terakhir nomor pesanan yang dibagikan antara satu atau beberapa pesanan untuk pengguna. Daftar (string)

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
all_order_date Daftar tanggal pesanan untuk pesanan duplikat dengan lima digit terakhir yang ditentukan dalam format YYYY-MM-DD. Setiap elemen dalam array ini sesuai dengan elemen yang sama dalam array all_order_time. Daftar (string)
all_order_time Daftar waktu pemesanan untuk pesanan duplikat dengan lima digit terakhir yang ditentukan dalam format HH:MM. Setiap elemen dalam array ini sesuai dengan elemen yang sama dalam array all_order_date. Daftar (string)

Untuk mengonfigurasi webhook Dapatkan detail pesanan duplikat bagi komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_retail_services:get_duplicate_order_details.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
  9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Simpan.

Detail pembatalan postingan

Webhook prebuilt_components_cancel_order:post_cancellation_details digunakan oleh komponen untuk mengirimkan permintaan pembatalan.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter Deskripsi Format Input
$session.params.phone_number Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. string
$flow.order_id ID Pesanan yang akan dikirimi tiket. string
$flow.cancel_product_id_list Daftar ID produk yang ingin dibatalkan pengguna. Daftar (string)
$flow.cancel_product_quantity_list Daftar kuantitas produk yang ingin dibatalkan pengguna, yang sesuai dengan setiap elemen di $flow.cancel_product_id_list. Daftar (string)
$flow.cancel_reason_list Daftar alasan pembatalan untuk setiap produk yang dibatalkan, yang sesuai dengan setiap elemen di $flow.cancel_product_id_list. Daftar (string)
$flow.order_refund_mode Mode pembayaran untuk pengembalian dana. Nilai yang valid ditentukan oleh entity prebuilt_components_cancel_mode_of_refund. string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
order_cancellation_ticket_id ID tiket untuk pembatalan yang diajukan. string

Untuk mengonfigurasi webhook detail pasca pembatalan untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_cancel_order:post_pembatalan_details.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
  9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Simpan.

Selesai

Agen Anda dan webhooknya kini seharusnya sudah disiapkan dan siap diuji.