Komponen bawaan status pesanan

Komponen bawaan status pesanan memeriksa tingkat autentikasi pelanggan, lalu memberikan informasi tentang pesanan terbaru atau sebelumnya kepada pelanggan yang diautentikasi. Komponen ini menggunakan komponen bawaan Retail authentication untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk peringkasan pasca-panggilan.

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.

Pesanan terbaru

Pengguna akhir menelepon dari nomor yang tidak terdaftar; agen mengautentikasi pengguna, lalu memberikan informasi mendetail tentang pengiriman dalam pesanan. Pengguna mengonfirmasi bahwa mereka ingin SMS dikirim ke nomor telepon terdaftar dengan detail tambahan.

Input pengguna	Respons agen
	Agen mengautentikasi pengguna menggunakan komponen bawaan Retail authentication
	Oke, John. Apakah Anda menelepon terkait pesanan terbaru untuk John Doe yang berisi lampu, kemeja, dan 10 item lainnya yang dilakukan pada 10-11-2023 pukul 18.00?
Ya
	Pesanan Anda memiliki 2 pengiriman, yang akan dikirimkan paling lambat 15-01-2024. Ingin mengetahui informasi selengkapnya tentang pengiriman ini?
Ya
	Pengiriman 1 yang berisi celana jeans, ikat pinggang, dan 2 item lainnya sedang dalam pengiriman dan akan dikirimkan pada 12-01-2024. Pengiriman 2 yang berisi lampu, kemeja, dan 6 item lainnya telah dikirimkan pada 12-11-2023. Apakah Anda ingin menerima SMS berisi detail lebih lanjut tentang item Anda?
Ya
	Kami telah mengirimkan SMS yang berisi link untuk melacak status semua pengiriman Anda. Terima kasih telah menghubungi kami.

Pesanan duplikat

Pengguna akhir telah diautentikasi sebelumnya. Pengguna meminta informasi tentang pesanan dan memberikan lima digit terakhir pesanan. Agen mengidentifikasi bahwa beberapa pesanan yang dilakukan oleh pengguna ini memiliki lima digit terakhir yang sama, sehingga agen mengonfirmasi pesanan mana yang ingin diketahui statusnya oleh pengguna dan memberikan status pesanan kepada pengguna.

Input pengguna	Respons agen
	Oke, Amber. Apakah Anda menelepon terkait pesanan terbaru untuk Amber Doe yang berisi lampu, kemeja, dan 2 item lainnya yang dilakukan pada 10 November 2023 pukul 18.00?
Tidak
	Bisakah Anda memberikan 5 digit terakhir ID pesanan yang ingin Anda lacak?
12355
	Lima digit terakhir ID pesanan yang kami dapatkan adalah 12355, apakah itu benar?
Ya, benar
	Bagus, kita sudah selesai mengumpulkan ID pesanan.
	Berdasarkan data kami, kami menemukan 2 pesanan yang diakhiri dengan 5 digit yang sama, yaitu 12355. Pesanan mana yang Anda cari? Pesanan nomor 1 yang dilakukan pada 10-11-2023 pukul 18.00 atau Pesanan nomor 2 yang dilakukan pada 09-11-2023 pukul 20.00? Untuk memilih pesanan nomor satu, ucapkan 1, untuk memilih pesanan nomor dua, ucapkan 2. Jika tidak, katakan Tidak.
Pesan satu
	Pesanan Anda memiliki 2 pengiriman, yang akan dikirimkan paling lambat 15-01-2024. Ingin mengetahui informasi selengkapnya tentang pengiriman ini?
Ya
	Pengiriman 1 yang berisi jeans sedang dalam pengiriman dan akan dikirimkan pada 15-01-2024. Pengiriman 2 yang berisi lampu, kemeja, dan 1 item lainnya dibatalkan. Apakah Anda ingin menerima SMS berisi detail lebih lanjut tentang item Anda?
Tidak, itu saja
	Terima kasih telah menghubungi kami.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Order Status
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_order_status:get_order_details

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
$flow.max_shipment	Menentukan jumlah pengiriman yang ditampilkan kepada pengguna dalam satu waktu. Nilai defaultnya adalah 2.	integer
$flow.tracking_status_delivered	Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan terkirim. Nilai defaultnya adalah "delivered".	string
$flow.tracking_status_cancelled	Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang dibatalkan. Nilai defaultnya adalah "cancelled".	string
$flow.tracking_status_returned	Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang dikembalikan. Nilai defaultnya adalah "returned".	string
$flow.tracking_status_partially_returned	Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang dikembalikan sebagian. Nilai defaultnya adalah "partially returned".	string
$flow.max_retry_alternate_profile	Menentukan jumlah percobaan ulang yang diizinkan saat meminta status pesanan dari nomor telepon yang tidak terdaftar atau profil alternatif. Nilai defaultnya adalah 3.	integer
$flow.max_retry_order_number	Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan. Nilai defaultnya adalah 3.	integer
$flow.max_retry_another_order_id	Menentukan jumlah percobaan ulang yang diizinkan setelah memberikan nomor pesanan yang tidak valid. Nilai defaultnya adalah 3.	integer

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

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_order_status: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_time	Waktu pemesanan, dalam format HH:MM.	string
order_status	Menunjukkan status pesanan. Contoh nilai mencakup "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned".	string
order_product_name	Daftar nama produk dalam pesanan.	Daftar (string)
order_product_quantity	Jumlah total produk yang dipesan untuk setiap produk dalam pesanan.	integer
order_product_count	Jumlah produk unik dalam pesanan.	integer
order_status_notification	Menunjukkan apakah notifikasi diaktifkan untuk pesanan ini.	boolean
return_eligibility_date	Daftar tanggal hingga setiap produk dalam pesanan memenuhi syarat untuk dikembalikan, dalam format YYYY-MM-DD.	Daftar (string)
order_customer_billing_name	Nama depan pelanggan yang tercantum dalam nama penagihan untuk pesanan.	string
order_latest_delivery_date	Tanggal pengiriman terbaru di antara semua perkiraan tanggal pengiriman untuk pengiriman dalam pesanan, dalam format YYYY-MM-DD.	string
order_shipment_multiple	Menunjukkan apakah pesanan berisi beberapa pengiriman.	boolean
order_shipment_count	Jumlah pengiriman dalam pesanan.	integer
order_shipment_product_count	Jumlah total produk di setiap pengiriman dalam pesanan.	Daftar (bilangan bulat)
order_shipment_product_name	Daftar nama produk di setiap pengiriman dalam pesanan.	Daftar (string)
order_estimated_delivery_date	Daftar perkiraan tanggal pengiriman untuk setiap pengiriman dalam pesanan, dalam format YYYY-MM-DD.	Daftar (string)
order_shipment_status	Daftar yang menunjukkan status untuk setiap pengiriman dalam pesanan. Contoh nilai mencakup "pending", "processing", "in-transit", "on-hold", "cancelled", "delivered", "returned", "partially returned".	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_order_status: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 pesanan duplikat

Webhook prebuilt_components_retail_services:get_duplicate_order 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.	boolean
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.	angka

Untuk mengonfigurasi webhook Get duplicate orders 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.
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.

Kirim SMS

Webhook prebuilt_components_order_status:send_sms digunakan oleh komponen untuk mengirim detail pesanan ke nomor telepon yang ditentukan menggunakan SMS.

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 mengirim detail pesanan.	string

Untuk mengonfigurasi webhook Kirim SMS 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_order_status:send_sms.
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.

Hidupkan notifikasi

Webhook prebuilt_components_order_status:enable_notification digunakan oleh komponen untuk mengaktifkan notifikasi untuk nomor telepon pengguna yang terdaftar.

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_notification	Menunjukkan apakah notifikasi harus diaktifkan untuk pengguna.	boolean

Untuk mengonfigurasi webhook Aktifkan notifikasi 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_order_status:enable_notification.
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.