Komponen bawaan pesanan pertukaran

Komponen bawaan penukaran pesanan memeriksa tingkat autentikasi pengguna. Setelah pengguna diautentikasi, komponen akan memberikan informasi tentang pesanan terbaru atau sebelumnya dari pengguna. Pengguna kemudian dapat memilih untuk menukar beberapa item dalam pesanan dan memilih opsi termasuk metode pengembalian dana dan pengiriman. Komponen ini menggunakan komponen bawaan Retail authentication untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk ringkasan pascatelepon 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 Default Welcome Intent 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 menukar 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 dilakukan pada 10-11-2023?
ya
	Kami 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 produk lainnya.
1
	Untuk mengonfirmasi, Anda tertarik untuk menukar lampu Google. Apakah ini benar?
ya
	Kita dapat melihat bahwa jumlah produk yang Anda pilih dan tersedia adalah 2. Tentukan jumlah produk yang ingin Anda tukar.
Dua
	Harap tentukan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item cacat atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau katakan lainnya.
Item rusak
	Terima kasih telah memberi tahu kami. Sebagai langkah terakhir, bagaimana Anda ingin menukarkan produk? Anda dapat mengatakan sesuatu seperti: Tukar di toko atau Jadwalkan pengambilan.
Saya ingin menukarnya di toko
	Mari kita cari toko di sekitar Anda.
	Agen mengumpulkan kode pos menggunakan komponen bawaan Zip code collection
	Berikut 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 Anda yang terdaftar. Cetak dan tempelkan label ini pada paket Anda, lalu kirimkan paket penukaran Anda dalam waktu 30 hari. Setelah kami menerima item di gudang kami, perlu waktu 3 hingga 5 hari kerja agar penukaran Anda, jika ada, muncul di akun Anda. Perhatikan: Jumlah pengembalian dana tidak termasuk biaya pengiriman dan pemrosesan. 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 item yang ditukar memiliki harga yang lebih rendah daripada item baru, dan mengonfirmasi metode pembayaran untuk pengembalian dana kepada pengguna.

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
	Bisakah 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
	Oke, kami selesai mengumpulkan ID pesanan. Kami menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. 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 Anda pilih, atau ucapkan berikutnya untuk menampilkan produk lainnya.
Dua
	Untuk memverifikasi, Anda tertarik untuk menukarkan kaus Google dengan penukaran. Apakah ini benar?
Ya
	Harap tentukan alasan penukaran. Anda dapat mengatakan sesuatu seperti: Item cacat atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau katakan lainnya.
Masalah ukuran atau kecocokan
	Terima kasih telah memberi tahu kami alasan penukaran. Dapatkah Anda memberi tahu kami ukuran yang ingin Anda tukarkan? Kami memiliki ukuran berikut: Katakan 1 untuk kecil. Katakan 2 untuk sedang. Katakan 3 untuk besar. Katakan 4 untuk XL. Katakan 5 untuk double-XL.
1
	Sebagai langkah terakhir, bagaimana Anda ingin menukarkan produk? Anda dapat mengatakan sesuatu seperti: Tukar di toko atau Jadwalkan pengambilan.
Jadwalkan pengambilan
	Sempurna. Kami telah mengirimkan label pengiriman ke nomor telepon dan email Anda yang terdaftar. Cetak dan tempelkan 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, perlu waktu 3 hingga 5 hari kerja sampai pengembalian dana penukaran Anda muncul di akun Anda. Produk yang Anda tukar memiliki nilai yang lebih rendah dan Anda memenuhi syarat untuk mendapatkan pengembalian dana sebesar $5. Harap beri tahu kami di mana 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 dikembalikan ke dompet. Apakah Anda ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Pesanan tidak memenuhi syarat

Pengguna akhir telah diautentikasi sebelumnya. Agen memeriksa pesanan terbaru dan menemukan bahwa tidak ada produk yang memenuhi syarat untuk ditukar. 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 apa pun dalam pesanan terbaru Anda yang memenuhi syarat untuk ditukar. Ingin menukar pesanan lain?
ya
	Bisakah Anda memberikan 5 digit terakhir ID pesanan yang ingin Anda tukarkan?
23487
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 23487, apakah itu 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 menukar 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 dari 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 flow 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 terkait dengan pengguna yang diautentikasi, yang diurutkan berdasarkan tanggal pemesanan 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, yang 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.	integer
$flow.max_retry_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan lima digit terakhir nomor pesanan. Nilai defaultnya adalah 3.	integer
$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.	integer
$flow.max_retry_select_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan lengkap jika ada lebih dari satu pesanan yang memiliki lima digit terakhir yang sama. Nilai defaultnya adalah 2.	integer
$flow.max_retry_exchange_reason	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan alasan penukaran. Nilai defaultnya adalah 3.	integer
$flow.max_retry_exchange_reason_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi alasan penukaran. Nilai defaultnya adalah 2.	integer
$flow.order_product_exchange_reason_others	Menentukan nilai entity 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.	integer
$flow.max_product_display	Menentukan jumlah maksimum produk yang akan ditampilkan selama seluruh percakapan. Nilai defaultnya adalah 9.	integer
$flow.max_product_exchange_confirm	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat mengonfirmasi produk yang dipilih. Nilai defaultnya adalah 2.	integer
$flow.max_retry_product_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih produk untuk ditukar. Nilai defaultnya adalah 3.	integer
$flow.max_retry_select_quantity	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih jumlah produk yang akan ditukar. Nilai defaultnya adalah 2.	integer
$flow.max_retry_size_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih ukuran yang akan ditukar. Nilai defaultnya adalah 2.	integer
$flow.max_retry_another_zip_code	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memberikan kode pos. Nilai defaultnya adalah 2.	integer
$flow.max_store_display_counter	Menentukan jumlah maksimum toko yang akan ditampilkan dalam satu giliran. Nilai defaultnya adalah 1.	integer
$flow.max_store_display	Menentukan jumlah maksimum toko yang akan ditampilkan di seluruh percakapan. Nilai defaultnya adalah 10.	integer
$flow.max_retry_store_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih toko. Nilai defaultnya adalah 2.	integer
$flow.max_retry_store_selection	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi pilihan toko. Nilai defaultnya adalah 3.	integer
$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.	integer
$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 penukaran. Nilai defaultnya adalah scheduled_for_pickup.	string

Untuk mengonfigurasi parameter input komponen ini, luaskan untuk melihat 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 Start Page di bagian Pages.
7. Klik Rute true di Start Page.
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 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 dengan akun.	string
user_first_name	Nama depan pengguna, yang 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 pada suatu waktu 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 tidak ada kecocokan. Lihat peristiwa bawaan 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 tertentu dari percakapan.

FAQ

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

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

Ringkasan

Generator Summarization digunakan untuk membuat ringkasan pascapanggilan yang menjelaskan 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 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 guna mengaktifkan autentikasi pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi retail untuk mengetahui petunjuk mendetail.

Dapatkan 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 untuk mengambil detail.	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.	integer
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 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 untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 untuk permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.duplicate_order_id	Daftar yang berisi lima digit terakhir nomor pesanan yang digunakan bersama 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 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)

Untuk mengonfigurasi webhook Get duplicate order details untuk komponen ini, luaskan untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 pertukaran yang tersedia

Webhook prebuilt_components_exchange_order:get_available_exchange_size digunakan oleh komponen untuk mengambil ukuran yang tersedia untuk ditukar 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 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 Dapatkan ukuran penukaran yang tersedia untuk komponen ini, luaskan untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 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 detail.	string
$flow.selected_order_product_id	ID produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar pengguna.	integer
$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 tersedia untuk ditukar.	boolean
product_exchange_price	Menunjukkan harga tukar untuk satu item produk dan ukuran yang dipilih.	angka

Guna mengonfigurasi webhook Dapatkan ketersediaan penukaran produk untuk komponen ini, luaskan untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Mengajukan tiket pesanan yang tidak selesai

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 untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar pengguna.	integer
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string

Untuk mengonfigurasi webhook Raise incomplete order ticket untuk komponen ini, luaskan untuk melihat 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:raise_incomplete_order_ticket.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 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 melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 pertukaran

Webhook prebuilt_components_exchange_order:post_exchange_details digunakan oleh komponen untuk mengirimkan 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 untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk yang ingin ditukarkan oleh pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukar pengguna.	integer
$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 pertukaran. 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 penukaran di toko.	string
$flow.order_refund_mode	Mode pembayaran untuk pengembalian dana, jika ada. 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 dananya, jika harga produk yang dapat ditukar lebih tinggi daripada produk baru. Jika pengembalian dana tidak diperlukan, nilai ini adalah null.	integer

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 untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Mengirimkan 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 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 untuk mengirimkan tiket.	string
$flow.channel	Saluran tertentu untuk mengirim informasi. Nilai yang valid ditentukan oleh entity prebuilt_components_channel_email_phone. Secara default, phone dan email didukung.	string

Untuk mengonfigurasi webhook Kirim informasi pengembalian dana COD untuk komponen ini, luaskan untuk melihat 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 webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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 sekarang sudah disiapkan dan siap diuji.