Beberapa produk dan fitur sedang dalam proses penggantian nama. Fitur playbook dan alur generatif juga dimigrasikan ke satu konsol gabungan. Lihat detailnya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Komponen bawaan pesanan pertukaran

Komponen bawaan pesanan exchange memeriksa level autentikasi pengguna. Setelah pengguna diautentikasi, komponen ini 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 Autentikasi retail untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk ringkasan pasca-panggilan dan FAQ.

Batasan

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

Komponen ini tidak mengenkripsi data apa pun.

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Dialog contoh menunjukkan perilaku saat komponen dipanggil menggunakan telephony, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.

Penukaran di toko untuk item yang rusak

Pengguna akhir telah diautentikasi sebelumnya. Agen mengonfirmasi item mana dari pesanan terbaru yang harus ditukar dan mengumpulkan alasan pertukaran. 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 diakhiri dengan 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 tersedia yang telah Anda pilih adalah 2. Tentukan jumlah produk yang ingin Anda tukar.
Dua
	Harap sebutkan alasan pertukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau yang lainnya.
Item rusak
	Terima kasih telah memberi tahu kami. Sebagai langkah terakhir, bagaimana Anda ingin menukar produk tersebut? Anda dapat mengucapkan sesuatu seperti: Tukar di toko atau Jadwalkan pengambilan.
Saya ingin menukar di toko
	Mari kita 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, 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, AS. Apakah itu benar?
ya
	Sempurna. Kami telah mengirimkan label pengiriman dan nomor tiket ke nomor telepon dan email yang terdaftar. Cetak dan tempelkan ke paket Anda, lalu kirimkan dalam waktu 30 hari. Setelah kami menerima item di gudang, perlu waktu 3 hingga 5 hari kerja agar item pengganti, jika ada, muncul di akun Anda. Harap diperhatikan: Jumlah pengembalian dana tidak akan mencakup biaya pengiriman dan penanganan. Nilai produk pengganti Anda lebih tinggi. Selisih harganya adalah $20. Anda akan segera menerima link pembayaran di nomor ponsel yang terdaftar. Harap 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 pertukaran. Pengguna memilih untuk menukar item dengan ukuran yang berbeda, dan menjadwalkan pengambilan. Agen mengidentifikasi bahwa harga item yang ditukar lebih rendah daripada item baru, dan mengonfirmasi metode pembayaran pengembalian dana kepada pengguna.

Input pengguna	Respons agen
	Apakah Anda menelepon terkait nomor pesanan terbaru Anda yang berakhiran 12345 yang berisi 2 lampu yang dipesan pada 10-11-2023?
Tidak
	Ingin menukar pesanan lain?
Ya
	Bisakah Anda memberikan 5 digit terakhir ID pesanan yang ingin ditukar?
12346
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 12346, apakah benar?
Ya
	Bagus, kami telah selesai mengumpulkan ID pesanan. Kami telah menemukan beberapa produk yang memenuhi syarat dalam pesanan Anda. Beri tahu kami produk mana yang ingin Anda tukarkan. Produk 1: botol minum google, Produk 2: 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. Apakah ini benar?
Ya
	Harap sebutkan alasan pertukaran. Anda dapat mengatakan sesuatu seperti: Item rusak atau tidak berfungsi, masalah ukuran atau kecocokan, masalah pesanan tidak lengkap, masalah gaya, warna salah, atau yang lainnya.
Masalah ukuran atau kecocokan
	Terima kasih telah memberi tahu kami alasan penukaran. Dapatkah Anda memberi tahu kami ukuran yang ingin Anda tukar? Kami menyediakan ukuran berikut: Ucapkan 1 untuk ukuran kecil. Ucapkan 2 untuk ukuran sedang. Ucapkan 3 untuk ukuran besar. Ucapkan 4 untuk ukuran XL. Ucapkan 5 untuk ukuran XXL.
1
	Sebagai langkah terakhir, bagaimana Anda ingin menukar produk? Anda dapat mengucapkan sesuatu seperti: Tukar di toko atau Jadwalkan pengambilan.
Jadwalkan pengambilan
	Sempurna. Kami telah mengirimkan label pengiriman ke nomor telepon dan email yang terdaftar. Cetak dan tempelkan label tersebut ke 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 agar 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 tempat Anda ingin menerima pengembalian dana. Anda dapat mengucapkan sesuatu seperti voucher toko atau akun sumber.
Saldo Store
	Terima kasih telah memverifikasi bahwa Anda ingin pengembalian dana dikembalikan ke dompet. Apakah Anda ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Pesanan tidak memenuhi syarat

Pengguna akhir telah diautentikasi sebelumnya. Agen memeriksa pesanan terbaru dan mendapati bahwa tidak ada produk yang memenuhi syarat untuk ditukar. Agen mengumpulkan nomor pesanan dari pengguna dan mendapati 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. Apakah Anda ingin menukar pesanan lain?
ya
	Bisakah Anda memberikan 5 digit terakhir ID pesanan yang ingin ditukar?
23487
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 23487, apakah 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. Ingin menukar pesanan lain?
tidak
	Terima kasih telah menghubungi kami.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Component Name]	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 alur untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman 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 urutan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah `null`.	Daftar (string)
$session.params.email	(opsional) Email yang terdaftar dengan akun.	string
$session.params.user_first_name	(opsional) Nama depan pengguna, digunakan untuk menyapa dan mengonfirmasi kepemilikan akun.	string

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

Nama Parameter	Deskripsi	Format
$flow.max_retry_another_account	Menentukan jumlah percobaan ulang yang diizinkan saat memilih apakah akan melanjutkan dengan akun alternatif. Nilai defaultnya adalah `3`.	bilangan bulat
$flow.max_retry_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan lima digit terakhir nomor pesanan. Nilai defaultnya adalah `3`.	bilangan bulat
$flow.max_retry_another_order	Menentukan jumlah percobaan ulang yang diizinkan saat memilih pesanan lain untuk pengembalian jika ID pesanan tidak ditemukan atau pesanan tidak memenuhi syarat untuk penukaran. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.max_retry_select_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan lengkap jika ada lebih dari satu pesanan yang 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 pertukaran. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.order_product_exchange_reason_others	Menentukan nilai entitas `prebuilt_components_exchange_order_reason` yang menunjukkan bahwa pengguna telah memilih alasan 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 maksimum produk yang akan ditampilkan selama percakapan. Nilai defaultnya adalah `9`.	bilangan bulat
$flow.max_product_exchange_confirm	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat mengonfirmasi produk yang dipilih. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.max_retry_product_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih produk untuk ditukar. Nilai defaultnya adalah `3`.	bilangan bulat
$flow.max_retry_select_quantity	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih jumlah produk yang akan ditukar. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.max_retry_size_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih ukuran 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 selama percakapan. Nilai defaultnya adalah `10`.	bilangan bulat
$flow.max_retry_store_number_counter	Menentukan jumlah maksimum percobaan ulang yang diizinkan saat memilih toko. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.max_retry_store_selection	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi pemilihan toko. Nilai defaultnya adalah `3`.	bilangan bulat
$flow.max_available_address_reselection_counter	Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi apakah pengguna ingin memilih alamat toko lain. Nilai defaultnya adalah `2`.	bilangan bulat
$flow.order_payment_mode_COD	Menentukan nilai kolom `order_payment_mode` yang ditampilkan oleh webhook `get_order_details` yang menunjukkan metode pembayaran cash on delivery (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 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 entitas `prebuilt_components_exchange_order_location` yang menunjukkan bahwa pengguna memilih untuk menjadwalkan pengambilan untuk pertukaran. Nilai defaultnya adalah `scheduled_for_pickup`.	string

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

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Build.
Klik komponen yang diimpor di bagian Alur.
Klik Halaman Awal di bagian Halaman.
Klik Rute true di Halaman Mulai.
Di jendela Rute, edit nilai Preset Parameter sesuai kebutuhan.
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 pemesanan 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, 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 saat 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 yang tidak cocok. 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 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 menukar 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.

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

Impor komponen bawaan.
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 belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, Anda harus mengonfigurasinya untuk mengaktifkan autentikasi pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi retail untuk petunjuk mendetail.

Dapatkan detail pesanan

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

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

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
order_date	Tanggal pesanan dilakukan, dalam format `YYYY-MM-DD`.	string
order_product_count	Jumlah produk unik dalam pesanan.	bilangan bulat
order_payment_mode	Menunjukkan mode pembayaran yang digunakan saat melakukan pemesanan.	string
exchangeable_product_id	Daftar ID produk untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_name	Daftar nama produk untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_brand_name	Daftar nama merek untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_quantity	Daftar jumlah untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)
exchangeable_product_price	Daftar harga untuk produk yang dapat ditukar dalam pesanan.	Daftar (string)

Untuk mengonfigurasi webhook Get order details untuk komponen ini, luaskan untuk melihat petunjuknya.

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:get_order_details.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
Klik Simpan.

Mendapatkan detail pesanan duplikat

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

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

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
all_order_date	Daftar tanggal pesanan untuk pesanan duplikat dengan lima digit terakhir yang ditentukan dalam format `YYYY-MM-DD`. Setiap elemen dalam array ini sesuai dengan elemen yang sama dalam array `all_order_time`.	Daftar (string)
all_order_time	Daftar waktu 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 petunjuknya.

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_retail_services:get_duplicate_order_details.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
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 pertukaran jika pengguna ingin menukar item karena masalah ukuran atau kecocokan.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukarkan pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

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

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

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:get_available_exchange_size.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
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 ke 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 pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan 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 penukaran untuk satu item dari produk dan ukuran yang dipilih.	angka

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

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:get_product_exchange_availability.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
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 ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna.	string
$flow.order_id	ID pesanan untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukarkan pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan pengguna.	bilangan bulat
$flow.order_product_exchange_reason	Alasan pengguna ingin menukar produk.	string

Untuk mengonfigurasi webhook Buat tiket pesanan yang tidak lengkap untuk komponen ini, luaskan untuk mendapatkan petunjuk.

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:raise_incomplete_order_ticket.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
Klik Simpan.

Mendapatkan detail toko

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

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

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

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

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

Untuk mengonfigurasi webhook Get store details untuk komponen ini, luaskan untuk melihat petunjuknya.

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:get_store_details.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
Klik Simpan.

Detail postingan Exchange

Webhook prebuilt_components_exchange_order:post_exchange_details digunakan oleh komponen untuk mengirimkan pertukaran.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna.	string
$flow.order_id	ID pesanan untuk mengirimkan tiket.	string
$flow.selected_order_product_id	ID produk dari produk yang ingin ditukarkan pengguna.	string
$flow.order_product_quantity_exchange_count	Jumlah produk yang ingin ditukarkan pengguna.	bilangan bulat
$flow.product_selected_size	Ukuran produk yang ingin ditukarkan 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 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 tidak ada pengembalian dana yang diperlukan, nilai ini adalah `null`.	string
$flow.total_refund_amount	Jumlah yang akan dikembalikan dananya, jika harga produk yang dapat ditukar lebih tinggi daripada produk baru. Jika tidak ada pengembalian dana yang diperlukan, nilai ini adalah `null`.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

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

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

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:post_exchange_details.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
Klik Simpan.

Mengirim 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 ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$session.params.phone_number	Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna.	string
$flow.order_id	ID pesanan untuk mengirimkan tiket.	string
$flow.channel	Saluran tertentu yang akan menerima 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 petunjuknya.

Buka konsol Dialogflow CX.
Pilih project Google Cloud Anda.
Pilih agen Anda.
Pilih tab Kelola.
Klik Webhook.
Pilih webhook prebuilt_components_exchange_order:send_COD_refund_information.
Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
Klik Simpan.

Selesai

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