Komponen bawaan pesanan pertukaran

Perintah penukaran komponen bawaan memeriksa tingkat autentikasi pengguna. Setelah pengguna diautentikasi, komponen memberikan informasi tentang pesanan pengguna yang terbaru atau sebelumnya. Pengguna kemudian dapat memilih untuk menukar beberapa item dalam pesanan dan memilih opsi termasuk metode pengembalian dana dan pengiriman. Komponen ini menggunakan komponen bawaan Autentikasi retail untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk meringkas percakapan pasca-panggilan dan FAQ.

Batasan

Selain batasan komponen bawaan 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 komponen bawaan ini. Dialog contoh menunjukkan perilaku saat komponen dipanggil menggunakan telepon, yang memicu Maksud Sambutan Default dan respons agen pertama di awal percakapan.

Penukaran di toko untuk item yang rusak

Pengguna akhir telah diautentikasi sebelumnya. Agen mengonfirmasi item mana dari pesanan terbaru yang harus ditukar dan mengumpulkan alasan penukaran. Pengguna memilih untuk menukarkan item di toko, dan agen memberikan daftar toko terdekat. Pengguna memilih toko, dan agen membuat label pengiriman yang dikirim ke saluran terdaftar pengguna.

Input pengguna	Respons agen
	Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang berakhiran 12375 yang berisi 2 lampu, 2 Pixel, dan 10 produk lainnya yang dipesan pada 10-11-2023?
ya
	Kami telah menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Beri tahu kami produk mana yang ingin Anda tukarkan. Produk 1: Lampu Google, Produk 2: Google Pixel, Produk 3: Lampu LED Google. Ucapkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan berikutnya untuk menampilkan lebih banyak produk.
1
	Untuk mengonfirmasi, Anda tertarik untuk menukarkan lampu Google. Apakah ini benar?
ya
	Kita dapat melihat bahwa jumlah produk yang tersedia yang telah Anda pilih adalah 2. Tentukan jumlah produk yang ingin Anda tukar.
Dua
	Harap sebutkan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau mengatakan lainnya.
Item rusak
	Terima kasih telah memberi tahu kami. Sebagai langkah terakhir, bagaimana Anda ingin menukar produknya? Anda dapat mengatakan sesuatu seperti: Tukarkan di toko atau Jadwalkan pengambilan.
Saya ingin menukarkan di toko
	Mari temukan toko di dekat Anda.
	Agen mengumpulkan kode pos menggunakan komponen bawaan Pengumpulan kode pos
	Berikut adalah daftar lokasi di dekat kode pos yang Anda masukkan. Alamat 1: Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. Alamat 2: Google California, 19510 Jamboree Road, Irvine, California 92612, US. Ucapkan atau masukkan nomor alamat yang ingin Anda pilih, atau ucapkan "berikutnya" untuk menampilkan alamat toko lainnya.
Toko pertama
	Untuk mengonfirmasi, Anda telah memilih Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, US. Apakah itu benar?
ya
	Sempurna. Kami telah mengirimkan label pengiriman dan nomor tiket ke nomor telepon dan email terdaftar Anda. Cetak dan lampirkan pada paket Anda, lalu kirimkan penukaran dalam waktu 30 hari. Setelah kami menerima item di gudang, perlu waktu 3 hingga 5 hari kerja agar penukaran, jika ada, muncul di akun Anda. Perhatikan: Jumlah pengembalian dana tidak termasuk biaya pengiriman dan penanganan. Produk penukaran Anda memiliki nilai yang lebih tinggi. Selisih harganya adalah 20$. Anda akan segera menerima link pembayaran di nomor ponsel terdaftar Anda. Lakukan pembayaran dalam waktu 24 jam untuk melakukan penukaran. Ingin menukar pesanan lain?
tidak, itu saja
	Terima kasih telah menghubungi kami.

Pengembalian dana untuk selisih harga

Pengguna akhir telah diautentikasi sebelumnya. Agen mengumpulkan nomor pesanan, produk yang akan ditukar, dan mengumpulkan alasan penukaran. Pengguna memilih untuk menukar item dengan ukuran yang berbeda, dan menjadwalkan pengambilan. Agen mengidentifikasi bahwa harga item yang ditukar lebih rendah daripada harga item baru, dan mengonfirmasi kepada pengguna metode pembayaran untuk pengembalian dana.

Input pengguna	Respons agen
	Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang berakhiran 12345 berisi 2 lampu yang dilakukan pada 10-11-2023?
Tidak
	Ingin menukar pesanan lain?
Ya
	Dapatkah Anda memberikan 5 digit terakhir ID pesanan yang ingin Anda tukar?
12346
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 12346, apakah itu benar?
Ya
	Bagus, kita sudah selesai mengumpulkan ID pesanan. Kami telah menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Beri tahu kami produk mana yang ingin Anda tukarkan. Produk 1: botol minum google, Produk 2: kaos google. Ucapkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan berikutnya untuk menampilkan lebih banyak produk.
Dua
	Untuk memverifikasi, Anda tertarik untuk menukar kaos Google dengan penukaran. Apakah ini benar?
Ya
	Harap sebutkan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau mengatakan lainnya.
Masalah ukuran atau kecocokan
	Terima kasih telah memberi tahu kami alasan penukaran. Dapatkah Anda memberi tahu kami ukuran yang ingin Anda tukar? Kami memiliki ukuran berikut: Ucapkan 1 untuk ukuran kecil. Ucapkan 2 untuk ukuran sedang. Ucapkan 3 untuk ukuran besar. Ucapkan 4 untuk ukuran XL. Ucapkan 5 untuk ukuran double-XL.
1
	Sebagai langkah terakhir, bagaimana Anda ingin menukarkan produk? Anda dapat mengatakan sesuatu seperti: Tukarkan di toko atau Jadwalkan pengambilan.
Jadwalkan pengambilan
	Sempurna. Kami telah mengirimkan label pengiriman ke nomor telepon dan email terdaftar Anda. Cetak dan lampirkan pada paket Anda. Tim kami akan menghubungi Anda dalam waktu 24 hingga 48 jam ke depan untuk menjadwalkan pengambilan. Setelah kami menerima item di gudang kami, pengembalian dana penukaran akan muncul di akun Anda dalam waktu 3 hingga 5 hari kerja. Produk yang Anda tukarkan memiliki nilai yang lebih rendah dan Anda berhak mendapatkan pengembalian dana sebesar 5$. Harap beri tahu kami tempat yang Anda inginkan untuk menerima pengembalian dana. Anda dapat mengucapkan sesuatu seperti kredit toko atau akun sumber.
Saldo Store
	Terima kasih telah memverifikasi bahwa Anda ingin pengembalian dana dikembalikan ke dompet. Apakah Anda ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Pesanan yang tidak memenuhi syarat

Pengguna akhir telah diautentikasi sebelumnya. Agen memeriksa pesanan terbaru dan menemukan bahwa tidak ada produk yang memenuhi syarat untuk penukaran. Agen mengumpulkan nomor pesanan dari pengguna dan menemukan bahwa pesanan yang diberikan tidak memiliki produk yang memenuhi syarat.

Input pengguna	Respons agen
	Kami tidak menemukan produk dalam pesanan terbaru Anda yang memenuhi syarat untuk penukaran. Apakah Anda ingin menukarkan pesanan lain?
ya
	Dapatkah Anda memberikan 5 digit terakhir ID pesanan yang ingin Anda tukar?
23487
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 23487, apakah sudah benar?
ya
	Bagus, kita sudah selesai mengumpulkan ID pesanan.
	Maaf, tidak ada produk dalam pesanan Anda yang memenuhi syarat untuk ditukar berdasarkan kebijakan kami. Anda dapat menemukan informasi selengkapnya tentang kebijakan penukaran kami di situs kami. Apakah Anda ingin menukarkan pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Order Status
Jenis Entitas	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_exchange_order_location
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_exchange_order:get_product_exchange_availability

Parameter input

Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku tertentu komponen. Parameter akan digunakan oleh satu atau beberapa kondisi dalam alur untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman mulai 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 yang diautentikasi, diurutkan berdasarkan tanggal penempatan pesanan dalam urutan menurun. Elemen pertama array mewakili pesanan 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 menyapa dan mengonfirmasi kepemilikan akun.	string

Komponen bawaan ini memungkinkan parameter opsional berikut untuk mengonfigurasi perilaku komponen, termasuk percobaan ulang.

Nama Parameter	Deskripsi	Format
$flow.max_retry_another_account	Menentukan jumlah percobaan ulang yang diizinkan saat memilih apakah akan melanjutkan dengan akun alternatif. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_retry_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan lima digit terakhir nomor pesanan. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_retry_another_order	Menentukan jumlah percobaan ulang yang diizinkan saat memilih pesanan lain untuk pengembalian jika ID pesanan tidak ditemukan atau pesanan tidak memenuhi syarat untuk penukaran. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_select_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan lengkap jika lebih dari satu pesanan memiliki lima digit terakhir yang sama. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_exchange_reason	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan alasan penukaran. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_retry_exchange_reason_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi alasan penukaran. Nilai defaultnya adalah 2.	bilangan bulat
$flow.order_product_exchange_reason_others	Menentukan nilai entitas prebuilt_components_exchange_order_reason yang menunjukkan bahwa pengguna telah memilih alasan penukaran "lainnya". Nilai defaultnya adalah "others".	string
$flow.max_product_display_counter	Menentukan jumlah maksimum produk yang akan ditampilkan dalam satu giliran. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_product_display	Menentukan jumlah maksimum produk yang akan ditampilkan selama percakapan. Nilai defaultnya adalah 9.	bilangan bulat
$flow.max_product_exchange_confirm	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat mengonfirmasi produk yang dipilih. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_product_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih produk untuk ditukar. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_retry_select_quantity	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih jumlah produk yang akan ditukar. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_size_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih ukuran untuk ditukar. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_another_zip_code	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memberikan kode pos. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_store_display_counter	Menentukan jumlah maksimum toko yang akan ditampilkan dalam satu giliran. Nilai defaultnya adalah 1.	bilangan bulat
$flow.max_store_display	Menentukan jumlah maksimum toko yang akan ditampilkan selama percakapan. Nilai defaultnya adalah 10.	bilangan bulat
$flow.max_retry_store_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih toko. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_store_selection	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi pilihan toko. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_available_address_reselection_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi apakah pengguna ingin memilih alamat toko lain. 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 saldo toko. Nilai defaultnya adalah "store_credit".	string
$flow.order_refund_mode_source_account	Menentukan nilai entitas prebuilt_components_exchange_order_refund_mode yang menunjukkan bahwa pengguna memilih untuk melakukan pengembalian dana ke akun sumbernya. Nilai defaultnya adalah source_account.	string
$flow.order_exchange_location_scheduled_for_pickup	Menentukan nilai entitas prebuilt_components_exchange_order_location yang menunjukkan bahwa pengguna memilih untuk menjadwalkan pengambilan untuk penukaran. Nilai defaultnya adalah scheduled_for_pickup.	string

Untuk mengonfigurasi parameter input untuk komponen ini, perluas 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 Alur.
6. Klik Halaman Awal di bagian Halaman.
7. Klik Rute true di Halaman Mulai.
8. Di jendela Rute, edit nilai Preset Parameter sesuai kebutuhan.
9. Klik Simpan.

Parameter output

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

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 yang diautentikasi, yang diurutkan berdasarkan tanggal penempatan pesanan dalam urutan menurun. Elemen pertama array mewakili pesanan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah null.	Daftar (string)
email	Email yang terdaftar di akun.	string
user_first_name	Nama depan pengguna, digunakan untuk menyapa 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 di beberapa titik selama percakapan. denial_of_information: pengguna akhir menolak untuk membagikan 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 maksimum percobaan ulang untuk peristiwa tanpa kecocokan. Lihat peristiwa bawaan tanpa kecocokan. webhook_error: terjadi error webhook. Lihat webhook.error built-in event. webhook_not_found: URL webhook tidak dapat dijangkau. Lihat webhook.error.not-found built-in event.	string

Generator

Komponen ini menggunakan Generator untuk mengaktifkan bagian tertentu dalam percakapan.

FAQ

Generator FAQ digunakan untuk menangani pertanyaan umum (FAQ) tentang pengembalian dan penukaran, termasuk:

• Apakah ada tenggat waktu untuk proses pengembalian?
• Dapatkah saya menukarkan item hadiah?
• Harga produk dan jumlah pengembalian dana berbeda. Mengapa demikian?

Ringkasan

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

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

1. Impor komponen bawaan.
2. Konfigurasi webhook fleksibel yang disediakan dengan konfigurasi yang menjelaskan layanan eksternal Anda, lihat Penyiapan webhook.

Penyiapan webhook

Untuk menggunakan komponen ini, Anda harus mengonfigurasi webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.

Autentikasi

Jika sebelumnya Anda belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, Anda harus mengonfigurasinya untuk mengaktifkan autentikasi pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi retail untuk petunjuk mendetail.

Dapatkan detail pesanan

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke 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_product_count	Jumlah produk unik dalam pesanan.	bilangan bulat
order_payment_mode	Menunjukkan mode pembayaran yang digunakan saat melakukan pemesanan.	string
exchangeable_product_id	Daftar ID produk untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_name	Daftar nama produk untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_brand_name	Daftar nama merek untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_quantity	Daftar jumlah untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_price	Daftar harga untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)

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

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_exchange_order:get_order_details.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mendapatkan detail pesanan duplikat

Webhook prebuilt_components_retail_services:get_duplicate_order_details digunakan oleh komponen untuk mengambil informasi mendetail guna membedakan pesanan saat beberapa nomor pesanan memiliki lima digit terakhir yang sama.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke 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 untuk komponen ini, luaskan petunjuknya.

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 CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mendapatkan ukuran penukaran yang tersedia

Webhook prebuilt_components_exchange_order:get_available_exchange_size digunakan oleh komponen untuk mengambil ukuran yang tersedia untuk penukaran jika pengguna ingin menukar item karena masalah ukuran atau kecocokan.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.selected_order_product_id	ID produk yang ingin ditukar oleh pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
product_available_sizes	Daftar ukuran yang tersedia untuk produk yang dipilih.	Daftar (string)

Untuk mengonfigurasi webhook Dapatkan ukuran bursa yang tersedia untuk komponen ini, luaskan petunjuknya.

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_exchange_order:get_available_exchange_size.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mendapatkan ketersediaan penukaran produk

Webhook prebuilt_components_exchange_order:get_product_exchange_availability digunakan oleh komponen untuk memeriksa apakah produk, jumlah, dan ukuran opsional yang dipilih pengguna tersedia untuk penukaran.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.order_id	ID pesanan untuk mengambil detailnya.	string
$flow.selected_order_product_id	ID produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Kuantitas produk yang ingin ditukar pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukar oleh pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
product_exchange_availability	Menunjukkan apakah produk, jumlah, dan ukuran yang dipilih tersedia untuk penukaran.	boolean
product_exchange_price	Menunjukkan harga penukaran untuk satu item produk dan ukuran yang dipilih.	angka

Untuk mengonfigurasi webhook Get product exchange availability untuk komponen ini, luaskan petunjuknya.

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_exchange_order:get_product_exchange_availability.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Membuat tiket pesanan tidak selesai

Webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket digunakan oleh komponen untuk membuat tiket saat pengguna ingin menukar produk dalam pesanan karena tidak lengkap.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke 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 untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Kuantitas produk yang ingin ditukar pengguna.	bilangan bulat
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string

Untuk mengonfigurasi webhook tiket pesanan tidak lengkap untuk komponen ini, perluas petunjuknya.

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_exchange_order:raise_incomplete_order_ticket.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mendapatkan detail toko

Webhook prebuilt_components_exchange_order:get_store_details digunakan oleh komponen untuk mengambil daftar toko di dekat kode pos yang diberikan pengguna.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.zip_code	Kode pos untuk menelusuri toko terdekat.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
store_id	Daftar ID toko.	Daftar (string)
store_address	Daftar alamat toko yang sesuai dengan setiap elemen store_id.	Daftar (string)

Untuk mengonfigurasi webhook Dapatkan detail toko untuk komponen ini, luaskan petunjuknya.

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_exchange_order:get_store_details.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Detail setelah penukaran

Webhook prebuilt_components_exchange_order:post_exchange_details digunakan oleh komponen untuk mengirimkan pertukaran.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke 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 untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Kuantitas produk yang ingin ditukar pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string
$flow.order_exchange_location	Mode yang dipilih untuk penukaran. Nilai yang valid ditentukan oleh entitas prebuilt_components_exchange_order_location.	string
$flow.order_exchange_store_id	ID toko untuk toko yang dipilih oleh pengguna untuk penukaran di toko.	string
$flow.order_refund_mode	Mode pembayaran untuk pengembalian dana, jika ada. Nilai yang valid ditentukan oleh entitas prebuilt_components_exchange_order_refund_mode. Jika tidak ada pengembalian dana yang diperlukan, nilai ini adalah null.	string
$flow.total_refund_amount	Jumlah yang akan dikembalikan dananya, jika harga produk yang dapat ditukar lebih tinggi daripada produk baru. Jika tidak ada pengembalian dana yang diperlukan, nilai ini adalah null.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
order_exchange_ticket_id	ID tiket untuk penukaran yang dikirimkan.	string

Untuk mengonfigurasi webhook Post exchange details untuk komponen ini, luaskan petunjuknya.

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_exchange_order:post_exchange_details.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Mengirim informasi pengembalian dana COD

Webhook prebuilt_components_exchange_order:send_COD_refund_information digunakan oleh komponen untuk mengirim informasi pembayaran terkait penukaran kepada pengguna.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke 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 untuk mengirimkan tiket.	string
$flow.channel	Saluran tertentu untuk mengirim informasi. Nilai yang valid ditentukan oleh entitas prebuilt_components_channel_email_phone. Secara default, phone dan email didukung.	string

Untuk mengonfigurasi webhook Kirim informasi pengembalian dana COD untuk komponen ini, luaskan petunjuknya.

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_exchange_order:send_COD_refund_information.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
9. Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Selesai

Agen dan webhook-nya kini telah disiapkan dan siap diuji.