Status pesanan komponen bawaan memeriksa tingkat otentikasi pelanggan, lalu memberikan informasi tentang pesanan terbaru atau masa lalu pengguna ke pelanggan yang diotentikasi. Komponen ini menggunakan Autentikasi retail komponen bawaan untuk mengotentikasi pengguna. Komponen ini juga menggunakan Generator untuk pasca-panggilan perangkuman dokumen.
Batasan
Selain pasal 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 metode ini komponen bawaan asli. Contoh dialog menunjukkan perilaku saat komponen yang dipanggil menggunakan telepon, yang memicu Niat Selamat Datang Default dan respons agen di awal percakapan.
Pesanan terbaru
Panggilan pengguna akhir dari nomor yang tidak terdaftar; agen mengotentikasi pengguna, kemudian memberikan informasi rinci tentang pengiriman sesuai pesanan. Pengguna mengonfirmasi bahwa mereka ingin SMS dikirim ke nomor telepon mereka yang terdaftar dengan detail tambahan.
| Input pengguna | Respons agen |
|---|---|
| Agen mengautentikasi pengguna menggunakan komponen bawaan Autentikasi Retail | |
| Oke, Joni. Apa Anda menelepon terkait pesanan terbaru Anda untuk Joni Dwi yang berisi lampu, kemeja, dan 10 item lainnya yang dilakukan di 10-11-2023 pukul 18.00? | |
| Ya | |
| Pesanan Anda memiliki 2 pengiriman, yang akan dikirim paling lambat 15-01-2024. Ingin mengetahui detail pengiriman ini selengkapnya? |
|
| Ya | |
| Pengiriman 1 berisi jeans, sabuk, dan 2 item lainnya masih dalam pengiriman dan akan dikirimkan paling lambat 12-01-2024. Pengiriman 2 berisi lampu, kemeja, dan 6 item lainnya dikirim pada 12-11-2023. Apakah Anda ingin menerima SMS yang 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 dari pesanan. Agen mengidentifikasi bahwa beberapa pesanan yang dilakukan oleh pengguna ini memiliki lima digit terakhir yang sama, sehingga mengonfirmasi pesanan mana yang ingin didengar pengguna statusnya dan memberikan status pesanan kepada pengguna.
| Input pengguna | Respons agen |
|---|---|
| Oke, Amber. Apakah Anda menelepon untuk memberitahukan pesanan terbaru Anda untuk Amber Doe yang berisi lampu, kemeja, dan 2 item lainnya yang dilakukan di 10-11-2023 pukul 18.00? | |
| Tidak | |
| Bisakah Anda memberikan 5 digit terakhir ID pesanan Anda yang ingin Anda lacak? | |
| 12355 | |
| Lima digit terakhir dari ID pesanan yang kita dapatkan adalah 12355, apa itu benar? | |
| Ya, benar | |
| Bagus, kita sudah 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? Nomor pesanan 1 yang dilakukan pada 2023-11-10 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. Selain itu, ketik Tidak. |
|
| Pesan satu | |
| Pesanan Anda memiliki 2 pengiriman, yang akan dikirim paling lambat 15-01-2024. Ingin mengetahui detail pengiriman ini selengkapnya? |
|
| Ya | |
| Pengiriman 1 berisi jeans sedang dalam pengiriman dan akan dikirimkan paling lambat 15-01-2024. Pengiriman 2 berisi lampu, kemeja, dan 1 item lainnya dibatalkan. Ingin menerima SMS yang 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] | 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 mengkonfigurasi perilaku tertentu dari komponennya. Parameter akan digunakan oleh satu atau beberapa kondisi dalam untuk menentukan bagaimana komponen harus berperilaku. Parameter cakupan alur harus diatur pada halaman awal komponen. Cakupan sesi parameter dapat disetel oleh alur panggilan, atau di awal dari 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 terautentikasi, yang diurutkan menurut 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 di akun. | string |
| $session.params.user_first_name | (opsional) Nama depan pengguna, digunakan untuk menyambut 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_delivered | Menentukan nilai yang ditampilkan oleh webhook yang menunjukkan status pesanan yang ditayangkan. 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 yang tidak terdaftar atau profil alternatif. 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 jumlah pesanan yang tidak valid. Nilai defaultnya adalah 3. |
bilangan bulat |
Untuk mengonfigurasi parameter input bagi 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 Route, edit nilai Parameter Presets sesuai kebutuhan.
- Klik Simpan.
Parameter output
Parameter output adalah parameter sesi yang akan tetap aktif setelah keluar komponennya. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen. Komponen bawaan ini memberikan nilai untuk output berikut parameter:
| 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 terautentikasi, 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 tersebut. | string | |
| user_first_name | Nama depan pengguna, digunakan untuk menyambut 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 memberikan 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 percobaan ulang maksimum untuk peristiwa ketidakcocokan. 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 bawaan. |
string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
- Impor komponen bawaan.
- Konfigurasi alamat IP yang disediakan web webhook fleksibel dengan yang menjelaskan layanan eksternal Dialogflow Anda, lihat Webhook penyiapan.
Penyiapan webhook
Untuk menggunakan komponen ini, Anda perlu mengonfigurasi web webhook fleksibel untuk mengambil informasi yang dibutuhkan dari layanan eksternal Anda.
Autentikasi
Jika Anda belum pernah mengonfigurasi layanan eksternal yang diperlukan untuk Anda perlu mengkonfigurasi mereka untuk mengaktifkan otentikasi dari pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi retail untuk petunjuk terperinci.
Dapatkan detail pesanan
Webhook prebuilt_components_order_status:get_order_details digunakan
oleh komponen untuk mengambil
detail pesanan untuk pesanan tertentu.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $flow.order_id | ID Pesanan yang akan diambil 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_time | Waktu pemesanan 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 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 kapan 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 terbaru di seluruh estimasi 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 | 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 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 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 kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Dapatkan pesanan duplikat
Webhook prebuilt_components_retail_services:get_duplicate_order digunakan
oleh komponen untuk mengambil
informasi yang rinci untuk membedakan antara
pesanan 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 | Daftar 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 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 pemesanan 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 Dapatkan pesanan duplikat bagi 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 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 kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama 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 |
Untuk 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 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 kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama 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. | boolean |
Untuk mengonfigurasi webhook Aktifkan 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 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 kunci webhook Anda yang dihasilkan. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen Anda dan webhooknya kini seharusnya sudah disiapkan dan siap diuji.