Komponen bawaan urutan penukaran

Komponen bawaan urutan bursa memeriksa level autentikasi pengguna. Setelah pengguna diautentikasi, komponen memberikan informasi tentang pesanan terbaru atau sebelumnya milik pengguna. Selanjutnya, pengguna dapat memilih untuk menukarkan beberapa item dalam suatu pesanan dan memilih opsi, termasuk pengembalian dana dan metode pengiriman. Komponen ini menggunakan komponen bawaan Autentikasi retail untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk ringkasan dan FAQ pasca-panggilan.

Batasan

Selain 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 komponen bawaan ini. Contoh dialog ini menunjukkan perilaku saat komponen dipanggil menggunakan telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.

Penukaran toko jika item yang rusak

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

Input pengguna	Respons agen
	Apakah Anda menelepon untuk menanyakan nomor pesanan terbaru Anda yang diakhiri dengan 12375 yang berisi 2 lampu, 2 Pixel, dan 10 produk lainnya yang dibuat 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. Ucapkan atau masukkan nomor produk item yang ingin Anda pilih, atau ucapkan di samping untuk menampilkan produk lainnya.
1
	Untuk mengonfirmasi, Anda tertarik untuk menukar lampu Google. Apakah ini benar?
ya
	Kami dapat melihat bahwa jumlah produk yang tersedia yang Anda pilih adalah 2. Harap cantumkan jumlah produk yang ingin ditukarkan.
Dua
	Harap sebutkan alasan penukaran. Anda dapat mengatakan: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna yang salah, atau lainnya.
Item rusak
	Terima kasih telah memberi tahu kami. Sebagai langkah terakhir, dengan cara apa Anda ingin menukarkan produk? Anda dapat mengucapkan: Bertukar di toko atau Jadwalkan pengambilan.
Saya ingin menukar di toko
	Ayo kita cari 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. Harap ucapkan atau masukkan nomor alamat yang ingin Anda masukkan ke toko berikutnya.
Toko pertama
	Untuk konfirmasi, Anda telah memilih Google Texas, 500 W 2nd St, Suite 2900 Austin, Texas 78701, AS. Apakah itu benar?
ya
	Sempurna. Kami telah mengirimkan label paket dan nomor tiket ke nomor telepon dan email Anda yang terdaftar. Harap cetak dan lampirkan ke paket dan kirimkan pengembalian dana dalam waktu 30 hari. Setelah kami menerima item di gudang kami, perlu waktu 3 hingga 5 hari kerja agar penukaran, jika ada, muncul di akun Anda. Harap diperhatikan: Jumlah pengembalian dana tidak akan mencakup biaya pengiriman dan penanganan. Produk bursa Anda bernilai lebih tinggi. Selisih harganya adalah 20$. Anda akan segera menerima link pembayaran di nomor ponsel Anda yang terdaftar. Harap lakukan pembayaran dalam waktu 24 jam untuk melakukan penukaran. Apakah Anda ingin menukar pesanan lain?
tidak, itu saja
	Terima kasih sudah menelepon.

Pengembalian dana atas 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 ditukarkan lebih rendah daripada item baru, dan mengonfirmasi metode pembayaran untuk pengembalian dana kepada pengguna.

Input pengguna	Respons agen
	Apakah Anda menelepon untuk mengetahui nomor pesanan terbaru Anda yang diakhiri dengan 12345 yang berisi 2 lampu yang ditempatkan pada 10-11-2023?
Tidak
	Apakah Anda ingin menukar pesanan lain?
Ya
	Dapatkah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin ditukarkan?
12346
	Lima digit terakhir ID pesanan yang kita dapatkan adalah 12346, apa itu benar?
Ya
	Bagus, kami sudah selesai mengumpulkan ID pesanan. Kami telah 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. Ucapkan atau masukkan nomor produk item yang ingin dipilih, atau ucapkan di samping untuk menampilkan produk lainnya.
Dua
	Untuk memverifikasi, Anda tertarik untuk menukar kaus Google untuk ditukarkan. Apakah ini benar?
Ya
	Harap sebutkan alasan penukaran. Anda dapat mengatakan: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna yang 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 XL double.
1
	Sebagai langkah terakhir, dengan cara apa Anda ingin menukar produk? Anda dapat mengucapkan: Bertukar di toko atau Jadwalkan pengambilan.
Jadwalkan pengambilan
	Sempurna. Kami telah mengirimkan label pengiriman ke nomor telepon dan email Anda yang terdaftar. Harap cetak dan lampirkan ke 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 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 tempat Anda ingin menerima pengembalian dana. Anda dapat mengucapkan sesuatu seperti saldo store atau akun sumber.
Saldo Store
	Terima kasih telah memverifikasi bahwa Anda ingin pengembalian dana Anda dikembalikan ke Wallet. Apakah Anda ingin menukar pesanan lain?
tidak ada
	Terima kasih sudah menelepon.

Pesanan yang tidak memenuhi syarat

Pengguna akhir telah diautentikasi sebelumnya. Agen memeriksa pesanan terbaru dan menemukan tidak ada produk yang memenuhi syarat untuk ditukarkan. 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 ditukarkan. Ingin menukar pesanan lain?
ya
	Dapatkah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin ditukarkan?
23487
	Lima digit terakhir ID pesanan yang kita dapatkan adalah 23487, apa itu benar?
ya
	Bagus, kita 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 di situs kami. Apakah Anda ingin menukar pesanan lain?
tidak ada
	Terima kasih sudah menelepon.

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 mengonfigurasi perilaku tertentu dari komponen. Parameter akan digunakan oleh satu atau beberapa kondisi dalam flow untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman awal 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 dikaitkan dengan pengguna yang diautentikasi, 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)
$session.params.email	(opsional) Email yang terdaftar dengan akun tersebut.	string
$session.params.user_first_name	(opsional) Nama depan pengguna, digunakan untuk memberikan salam dan mengonfirmasi kepemilikan akun.	string

Komponen bawaan ini memungkinkan parameter opsional berikut 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 atau tidak. 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 pengembalian lain jika ID pesanan tidak ditemukan atau pesanan tidak memenuhi syarat untuk pertukaran. 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 pertukaran. 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 alasan pertukaran "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 produk maksimum yang akan ditampilkan di seluruh 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 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 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 di seluruh 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 yang berbeda atau tidak. 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 Store. Nilai defaultnya adalah "store_credit".	string
$flow.order_refund_mode_source_account	Menentukan nilai entity 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 memilih untuk menjadwalkan pengambilan untuk bursa. Nilai defaultnya adalah scheduled_for_pickup.	string

Guna mengonfigurasi parameter input 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 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 Rute, edit nilai Parameter Presets 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 urutan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah null.	Daftar (string)
email	Email yang terdaftar dengan akun.	string
user_first_name	Nama depan pengguna, digunakan untuk menyapa dan mengonfirmasi kepemilikan akun.	string
transfer_reason	Parameter ini menunjukkan alasan keluarnya flow, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari: agent: pengguna akhir meminta agen manusia pada waktu tertentu selama percakapan. denial_of_information: pengguna akhir menolak untuk membagikan informasi yang diminta oleh komponen. max_no_input: percakapan telah 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 tanpa kecocokan. 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.	string

Generator

Komponen ini menggunakan Generator untuk mengaktifkan bagian percakapan tertentu.

FAQ

Generator FAQ digunakan untuk menangani pertanyaan umum (FAQ) tentang pengembalian dan penukaran, 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 mendeskripsikan percakapan yang ditangani oleh komponen.

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

1. Impor komponen bawaan.
2. Konfigurasikan Webhook fleksibel yang disediakan dengan konfigurasi yang mendeskripsikan layanan eksternal Dialogflow 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.

Authentication

Jika belum pernah 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.

Mendapatkan detail pesanan

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.order_id	ID Pesanan yang detailnya akan diambil.	string

Parameter respons API

Parameter berikut diambil dari respons API yang akan 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 produk yang dapat ditukarkan dalam pesanan.	Daftar (string)

Guna 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 menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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 mendetail untuk membedakan antarurutan 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 [id_pesanan_duplikat]	Daftar yang berisi lima digit terakhir nomor pesanan yang digunakan bersama oleh satu atau beberapa pesanan untuk pengguna.	Daftar (string)

Parameter respons API

Parameter berikut diambil dari respons API yang akan 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 pesanan 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)

Guna mengonfigurasi webhook Dapatkan detail pesanan duplikat 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_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 menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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 pertukaran jika pengguna ingin menukar item karena masalah ukuran atau masalah.

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 ditukar oleh pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.

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

Guna mengonfigurasi webhook Dapatkan ukuran pertukaran 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_Exchange_size.
7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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

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 ditukar atau tidak.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.order_id	ID Pesanan yang detailnya akan diambil.	string
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar oleh pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan dengan pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.

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

Guna mengonfigurasi webhook untuk mendapatkan ketersediaan pertukaran 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_exchange_availability.
7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
11. Klik Simpan.

Naikkan tiket pesanan yang belum 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 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 digunakan untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar oleh pengguna.	bilangan bulat
$flow.order_product_exchange_reason	Alasan mengapa pengguna ingin menukar produk.	string

Untuk mengonfigurasi webhook Naikkan tiket pesanan yang 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_Exchange_order:merge_incomplete_order_ticket.
7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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 yang akan 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)

Guna 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_Exchange_order:get_store_details.
7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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 mengirim pertukaran.

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 digunakan untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukar oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar oleh pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan dengan pengguna.	string
$flow.order_product_exchange_reason	Alasan mengapa 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 dana yang akan dikembalikan, jika harga produk yang dapat ditukarkan lebih tinggi dari produk baru. Jika pengembalian dana tidak diperlukan, nilai ini adalah null.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.

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

Guna 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 menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Authentication 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 bursa 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 digunakan untuk mengirimkan tiket.	string
$flow.channel	Saluran tertentu yang akan dikirimi informasi. Nilai yang valid ditentukan oleh entity prebuilt_components_channel_email_phone. Secara default, phone dan email didukung.	string

Guna mengonfigurasi webhook informasi pengembalian dana 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 menu 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 respons webhook Anda. Jangan ubah nama parameter, karena parameter 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 webhook-nya sekarang telah disiapkan dan siap diuji.