Komponen bawaan status pesanan memeriksa level autentikasi pelanggan, lalu memberikan informasi tentang pesanan terbaru atau sebelumnya milik pengguna kepada pelanggan yang diautentikasi. Komponen ini menggunakan komponen bawaan Autentikasi retail untuk mengautentikasi pengguna. Komponen ini juga menggunakan Generator untuk ringkasan pascapanggilan.
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.
Pesanan terbaru
Pengguna akhir menelepon dari nomor yang tidak terdaftar; agen mengautentikasi pengguna, lalu memberikan informasi mendetail tentang pengiriman dalam urutan tersebut. Pengguna mengonfirmasi bahwa ia ingin SMS berisi detail tambahan ke nomor teleponnya yang terdaftar.
Input pengguna | Respons agen |
---|---|
Agen mengautentikasi pengguna menggunakan komponen bawaan Autentikasi retail | |
Oke, Joni. Apa Anda menelepon untuk menanyakan pesanan terbaru John Doe yang berisi bohlam, kemeja, dan 10 item lainnya pada 10-11-2023 pukul 18.00? | |
Ya | |
Pesanan Anda memiliki 2 pengiriman, yang akan dikirimkan pada 15-01-2024. Ingin mengetahui pengiriman ini lebih lanjut? |
|
Ya | |
Pengiriman 1 yang berisi jeans, ikat pinggang, dan 2 item lainnya sedang dalam perjalanan dan akan tiba paling lambat 12-01-2024. Pengiriman 2 yang berisi lampu, kemeja, dan 6 item lainnya dikirim pada 12-11-2023. 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 tersebut. Agen mengidentifikasi bahwa beberapa pesanan yang dilakukan oleh pengguna ini memiliki lima digit terakhir yang sama, sehingga mengonfirmasi pesanan mana yang ingin didengar statusnya dan memberikan status pesanan kepada pengguna.
Input pengguna | Respons agen |
---|---|
Oke, Amber. Apakah Anda menelepon untuk mengetahui pesanan terbaru Amber Doe yang berisi lamp, kemeja, dan 2 item lainnya pada 10-11-2023 pukul 18.00? | |
Tidak | |
Dapatkah Anda memberikan 5 digit terakhir ID pesanan yang ingin Anda lacak? | |
12355 | |
Lima digit terakhir ID pesanan yang kita dapatkan adalah 12355, apa itu benar? | |
Ya benar | |
Bagus, kita selesai mengumpulkan ID pesanan. | |
Sesuai catatan kami, kami telah menemukan 2 pesanan yang diakhiri dengan 5 digit yang sama 12355. Pesanan mana yang Anda cari? Pesanan nomor 1 yang dilakukan pada 10-11-2023 pukul 18.00 atau Nomor pesanan 2 yang dilakukan pada 09-11-2023 pukul 20.00? Untuk memilih pesanan nomor satu, ucapkan 1, untuk memilih pesanan nomor dua, ucapkan 2. Atau, ucapkan Tidak. |
|
Pesan satu | |
Pesanan Anda memiliki 2 pengiriman, yang akan dikirimkan pada 15-01-2024. Ingin mengetahui pengiriman ini lebih lanjut? |
|
Ya | |
Pengiriman 1 yang berisi jeans masih dalam perjalanan dan akan tiba paling lambat 15-01-2024. Pengiriman 2 yang berisi lampu, kemeja, dan 1 item lainnya dibatalkan. Ingin menerima SMS dengan 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] | Status Pesanan |
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 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 |
$flow.max_shipment | Menentukan jumlah pengiriman yang ditampilkan kepada pengguna pada satu waktu. Nilai defaultnya adalah 2 . |
bilangan bulat |
$flow.tracking_status_optimizationed | Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang 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 ditampilkan. Nilai defaultnya adalah "returned" . |
string |
$flow.tracking_status_partially_returned | Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang ditampilkan 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 atau profil alternatif yang tidak terdaftar. Nilai defaultnya adalah 3 . |
bilangan bulat |
$flow.max_retry_order_number | Menentukan jumlah percobaan ulang yang diizinkan saat memberikan nomor pesanan. Nilai defaultnya adalah 3 . |
bilangan bulat |
$flow.max_retry_another_order_id | Menentukan jumlah percobaan ulang yang diizinkan setelah memberikan nomor pesanan yang tidak valid. Nilai defaultnya adalah 3 . |
bilangan bulat |
Guna 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 Flows.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute true di Halaman Awal.
- Di jendela Rute, edit nilai Parameter Presets 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 penempatan pesanan dalam urutan menurun. Elemen pertama array mewakili urutan terbaru. Jika pengguna tidak memiliki pesanan, nilai parameter ini adalah null . |
Daftar (string) |
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 |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
- Impor komponen bawaan.
- 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_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 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_time | Waktu pesanan dilakukan, 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 | Total jumlah produk yang dipesan untuk setiap produk dalam suatu pesanan. | bilangan bulat |
order_product_count | Jumlah produk unik dalam pesanan. | bilangan bulat |
order_status_notification | Menunjukkan apakah notifikasi diaktifkan untuk pesanan ini. | boolean |
return_eligibility_date | Daftar tanggal saat setiap produk dalam pesanan memenuhi syarat untuk dikembalikan, dalam format YYYY-MM-DD . |
Daftar (string) |
order_customer_billing_name | Nama depan nama penagihan pelanggan untuk pesanan. | string |
order_latest_delivery_date | Tanggal pengiriman terakhir untuk 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. | bilangan bulat |
order_shipment_product_count | Total jumlah 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) |
Guna mengonfigurasi webhook Dapatkan detail pesanan 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_order_status:get_order_details.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- 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.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Mendapatkan pesanan duplikat
Webhook prebuilt_components_retail_services:get_duplicate_order
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 . |
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 |
Guna mengonfigurasi webhook Dapatkan pesanan duplikat 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_retail_services:get_duplicate_order.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- 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.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- 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 yang akan dikirimi detail pesanan. | string |
Guna mengonfigurasi webhook Kirim SMS 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_order_status:send_sms.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- 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.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- 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 atau tidak. | boolean |
Guna mengonfigurasi webhook Notifikasi 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_order_status:enable_notification.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk webhook Anda.
- 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.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen Anda dan webhook-nya sekarang telah disiapkan dan siap diuji.