Komponen bawaan urutan penukaran

Pesanan bursa komponen bawaan memeriksa tingkat otentikasi pengguna. Setelah pengguna diotentikasi, memberikan informasi tentang pesanan terbaru atau sebelumnya dari pengguna. Tujuan pengguna kemudian dapat memilih untuk menukar beberapa item dalam pesanan dan memilih opsi termasuk metode pengembalian dana dan pengiriman. Komponen ini menggunakan atribut Autentikasi retail komponen bawaan untuk mengotentikasi pengguna. Komponen ini juga menggunakan Generator untuk pasca-panggilan ringkasan dan FAQ.

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.

Penukaran toko untuk barang yang rusak

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

Input pengguna	Respons agen
	Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang diakhiri dengan 12375 yang berisi 2 lampu, 2 Pixel, dan 10 produk lainnya yang ditempatkan pada 10-11-2023?
ya
	Kami menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Harap beri tahu kami produk mana yang ingin Anda tukarkan. Produk 1: Lampu Google, Produk 2: Google Pixel, Produk 3: Lampu LED Google. Harap ucapkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan di samping untuk menampilkan produk lainnya.
1
	Untuk mengonfirmasi, Anda berminat untuk menukar lampu Google. Apakah ini benar?
ya
	Kita dapat melihat bahwa jumlah produk yang tersedia yang Anda pilih adalah 2. Harap tentukan jumlah produk yang ingin Anda tukarkan.
Dua
	Tentukan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kesesuaian, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau lainnya.
Item rusak
	Terima kasih telah memberi tahu kami. Sebagai langkah terakhir, bagaimana Anda ingin menukar produk? Anda dapat mengucapkan misalnya: Bertukar di toko atau Jadwalkan pengambilan.
Saya ingin menukarkan di toko
	Ayo 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, AS. Alamat 2: Google California, 19510 Jamboree Road, Irvine, California 92612, AS. Ucapkan atau masukkan nomor alamat yang ingin Anda pilih untuk menampilkan lebih banyak alamat toko.
Toko pertama
	Untuk mengonfirmasi, Anda telah memilih Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, AS. Apakah itu benar?
ya
	Sempurna. Kami telah mengirimkan label pengiriman dan nomor tiket ke nomor telepon dan email Anda yang terdaftar. Silakan cetak dan lampirkan ke paket Anda dan lepas penukaran Anda dalam waktu 30 hari. Setelah kami menerima item di gudang, perlu waktu 3 hingga 5 hari kerja agar penukaran Anda, jika ada, muncul di rekening Anda. Harap diperhatikan: Jumlah pengembalian dana tidak akan mencakup biaya pengiriman dan penanganan. Produk penukaran Anda memiliki nilai yang lebih tinggi. Selisih harganya adalah Rp200.000. Anda akan segera menerima link pembayaran di nomor ponsel Anda yang terdaftar. Harap lakukan pembayaran dalam waktu 24 jam untuk melakukan penukaran. Ingin menukar pesanan lain?
tidak, itu dia
	Terima kasih telah menghubungi kami.

Pengembalian dana untuk selisih harga

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

Input pengguna	Respons agen
	Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang diakhiri dengan 12345 yang berisi 2 lampu yang ditempatkan di 10-11-2023?
Tidak
	Apakah Anda ingin menukar pesanan lain?
Ya
	Bisakah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin ditukarkan?
12346
	Lima digit terakhir dari ID pesanan yang kita dapatkan adalah 12346, apa itu benar?
Ya
	Bagus, kami sudah selesai mengumpulkan ID pesanannya. Kami menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Harap beri tahu kami produk mana yang ingin Anda tukarkan. Produk 1: botol air google, Produk 2: kaus google. Sebutkan atau masukkan nomor produk dari item yang ingin Anda pilih, atau ucapkan di samping untuk menampilkan produk lainnya.
Dua
	Untuk memverifikasi, Anda tertarik untuk menukar kaus Google untuk ditukar. Apakah ini benar?
Ya
	Tentukan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kesesuaian, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau lainnya.
Masalah ukuran atau kecocokan
	Terima kasih telah memberi tahu kami alasan penukaran. Dapatkah Anda memberi tahu kami ukuran yang ingin Anda tukarkan? Kami menyediakan ukuran berikut: Ucapkan 1 untuk ukuran kecil. Ucapkan 2 untuk ukuran sedang. Ucapkan 3 untuk ukuran besar. Ucapkan 4 untuk XL. Ucapkan 5 untuk ukuran XL.
1
	Sebagai langkah terakhir, bagaimana Anda ingin menukar produk? Anda dapat mengucapkan misalnya: Bertukar di toko atau Jadwalkan pengambilan.
Jadwalkan pengambilan
	Sempurna. Kami telah mengirimkan label paket ke nomor telepon dan email Anda yang terdaftar. Silakan cetak dan lampirkan pada paket Anda. Tim kami akan menghubungi Anda dalam 24 hingga 48 jam ke depan untuk menjadwalkan pengambilan. Setelah kami menerima item di gudang kami, perlu waktu 3 hingga 5 hari kerja agar pengembalian dana penukaran Anda muncul di akun Anda. Produk yang ditukarkan memiliki nilai lebih rendah dan Anda memenuhi syarat untuk mendapatkan pengembalian dana sebesar $5. Harap beri tahu kami di mana Anda ingin menerima pengembalian dana. Anda bisa ucapkan misalnya saldo toko atau akun sumber.
Saldo Store
	Terima kasih telah memverifikasi bahwa Anda ingin pengembalian dana Anda dikembalikan ke Wallet. Ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Pesanan yang tidak memenuhi syarat

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

Input pengguna	Respons agen
	Kami tidak menemukan produk apa pun dalam pesanan terbaru Anda yang memenuhi syarat untuk ditukarkan. Ingin menukar pesanan lain?
ya
	Bisakah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin ditukarkan?
23487
	Lima digit terakhir dari ID pesanan yang kita dapatkan adalah 23487, apa itu benar?
ya
	Bagus, kita sudah selesai mengumpulkan ID pesanan.
	Maaf, berdasarkan kebijakan kami, tidak ada produk dalam pesanan Anda yang memenuhi syarat untuk ditukarkan. Anda dapat menemukan informasi selengkapnya tentang kebijakan penukaran di situs kami. Ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Status Pesanan
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 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	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 dikembalikan 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 beberapa 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 entity prebuilt_components_exchange_order_reason yang menunjukkan bahwa pengguna telah memilih "lainnya" alasan pertukaran data. Nilai defaultnya adalah "others".	string
$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_product_exchange_confirm	Menentukan jumlah percobaan ulang maksimum yang diizinkan saat mengonfirmasi produk yang dipilih. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_product_number_counter	Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memilih produk yang akan ditukarkan. Nilai defaultnya adalah 3.	bilangan bulat
$flow.max_retry_select_quantity	Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memilih jumlah produk yang akan ditukarkan. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_size_number_counter	Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memilih ukuran yang akan ditukarkan. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_retry_another_zip_code	Menentukan jumlah percobaan ulang maksimum yang diizinkan saat memasukkan kode pos. Nilai defaultnya adalah 2.	bilangan bulat
$flow.max_store_display_counter	Menentukan jumlah maksimum toko yang akan ditampilkan dalam satu belokan. Nilai defaultnya adalah 1.	bilangan bulat
$flow.max_store_display	Menentukan jumlah maksimum toko yang akan ditampilkan di seluruh percakapan. Nilai defaultnya adalah 10.	bilangan bulat
$flow.max_retry_store_number_counter	Menentukan jumlah percobaan ulang maksimum 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 yang berbeda. 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
$flow.order_refund_mode_source_account	Menentukan nilai entitas prebuilt_components_exchange_order_refund_mode yang menunjukkan bahwa pengguna memilih untuk mengembalikan dana ke akun sumbernya. Nilai defaultnya adalah source_account.	string
$flow.order_exchange_location_scheduled_for_pickup	Menentukan nilai entity prebuilt_components_exchange_order_location yang menunjukkan bahwa pengguna telah memilih untuk menjadwalkan pengambilan untuk bursa. Nilai defaultnya adalah scheduled_for_pickup.	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.

FAQ

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

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

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_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 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_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 ditukarkan 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 ditukarkan dalam pesanan.	Daftar (string)
exchangeable_product_price	Daftar harga untuk produk yang dapat ditukarkan 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_Exchange_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.

Mendapatkan ukuran bursa yang tersedia

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukarkan 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 ukuran bursa yang tersedia 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_Exchange_order:get_available_swap_size.
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.

Mendapatkan ketersediaan bursa produk

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

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
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan oleh pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan 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 dapat ditukarkan.	boolean
product_exchange_price	Menunjukkan harga penukaran untuk satu item dari produk dan ukuran yang dipilih.	angka

Untuk mengonfigurasi webhook ketersediaan bursa produk 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_ exchange_order:get_product_Penutup_availability.
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.

Menyampaikan tiket pesanan yang belum lengkap

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

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.selected_order_product_id	ID produk dari produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan oleh pengguna.	bilangan bulat
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string

Untuk mengonfigurasi webhook "Tingkatkan pesanan tiket belum selesai" 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_promotion_order:raise_incomplete_order_ticket.
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 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 untuk 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 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_swap_order:get_store_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 pasca-bursa

Webhook prebuilt_components_exchange_order:post_exchange_details digunakan oleh komponen untuk mengirimkan pertukaran yang ada.

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.selected_order_product_id	ID produk dari produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan oleh pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string
$flow.order_exchange_location	Mode yang dipilih untuk bursa. Nilai yang valid ditentukan oleh entity prebuilt_components_exchange_order_location.	string
$flow.order_exchange_store_id	ID toko untuk toko yang dipilih oleh pengguna untuk bursa toko.	string
$flow.order_refund_mode	Mode pembayaran untuk pengembalian dana, jika berlaku. Nilai yang valid ditentukan oleh entity prebuilt_components_exchange_order_refund_mode. Jika pengembalian dana tidak diperlukan, nilai ini adalah null.	string
$flow.total_refund_amount	Jumlah yang akan dikembalikan, jika harga produk yang dapat ditukarkan lebih tinggi daripada produk baru. Jika pengembalian dana tidak 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 bursa yang dikirimkan.	string

Untuk mengonfigurasi webhook detail Post exchange 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_Exchange_order:post_Exchange_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.

Kirim informasi pengembalian dana COD

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

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.channel	Saluran spesifik yang menjadi tujuan pengiriman informasi. Nilai yang valid ditentukan oleh entity prebuilt_components_channel_email_phone. Secara default, phone dan email didukung.	string

Untuk mengonfigurasi webhook informasi pengembalian dana Kirim COD 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_exchange_order:send_COD_refund_information.
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.