Komponen bawaan penawaran dan promo akan memeriksa apakah pemanggil adalah pengguna terdaftar. Jika pengguna memiliki akun terdaftar, komponen dapat memberikan informasi tentang penawaran dan promo khusus pengguna. Pengguna juga bisa mendapatkan detail tentang penawaran dan promo umum atau melaporkan masalah dengan kode kupon tertentu. Komponen ini menggunakan komponen bawaan Koleksi alfanumerik untuk mengumpulkan kode kupon. Komponen ini juga menggunakan Generator untuk ringkasan pasca-panggilan, FAQ, dan detail penawaran.
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 Sambutan Default dan respons agen pertama di awal percakapan.
Penawaran dan promo khusus pengguna dan umum
Pengguna akhir telah diautentikasi sebelumnya. Pengguna meminta penawaran terbarunya dan agen menampilkan daftar penawaran khusus untuk pengguna. Pengguna mengajukan beberapa pertanyaan tentang penawaran, lalu meminta penawaran dalam kategori tertentu. Agen menampilkan daftar penawaran dalam kategori. Agen menawarkan untuk mengirimkan detail penawaran kepada pengguna dan pengguna menolak.
| Input pengguna | Respons agen |
|---|---|
| Selamat datang. Apakah Anda ingin menjelajahi penawaran terbaru kami atau mengalami masalah dengan kode kupon tertentu? | |
| Saya ingin melihat penawaran terbaru | |
| Untuk mengonfirmasi, Anda sedang mencari penawaran. Apakah itu benar? | |
| ya | |
| Kami menemukan penawaran berikut untuk Anda, berikut detailnya: Penawaran 1: Dapatkan diskon 5% untuk pakaian, gunakan kode APPARELS5, berlaku hingga 28-03-2024. Penawaran 2: Dapatkan diskon 15% untuk bahan makanan, gunakan kode GROCERY500, berlaku hingga 28-03-2024. Semoga penawaran ini menarik bagi Anda. Apakah ada pertanyaan tentang penawaran atau promo yang dapat kami jawab? |
|
| Apakah ada pembelian minimum untuk penawaran bahan makanan? | |
| Ya, ada nilai pembelian minimum sebesar 10 untuk mendapatkan diskon 15% untuk bahan makanan. Gunakan kode GROCERY500 untuk menukarkan penawaran ini, berlaku hingga 28-03-2024. Kami harap dapat memberikan detail yang Anda perlukan. Apakah ada pertanyaan tentang penawaran atau promo yang dapat kami jawab? |
|
| Apakah Anda memiliki penawaran untuk produk elektronik? | |
| Tentu saja. Berikut detail penawarannya: Penawaran 1: Dapatkan diskon 5% untuk produk elektronik, gunakan kode ELECTRIC5, berlaku hingga 28-03-2024. Penawaran 2: Dapatkan diskon 15% untuk produk elektronik, gunakan kode ELECTRIC15, berlaku hingga 28-03-2024. Kami harap dapat memberikan detail yang Anda perlukan. Apakah ada pertanyaan tentang penawaran atau promo yang dapat kami jawab? |
|
| Tidak, saya sudah selesai | |
| Apakah Anda ingin detail penawaran dibagikan di ponsel atau email terdaftar Anda? | |
| Lain kali | |
| Terima kasih telah menghubungi kami. |
Masalah terkait kode kupon
Pengguna akhir telah diautentikasi sebelumnya. Pengguna menyebutkan bahwa mereka memiliki masalah dengan kode kupon. Agen mengumpulkan kode kupon dan memberikan detail tentang penukaran kode kupon kepada pengguna. Pengguna mengonfirmasi bahwa mereka mengalami masalah dengan kode kupon dan agen mengirimkan tiket untuk melaporkan masalah tersebut.
| Input pengguna | Respons agen |
|---|---|
| Selamat datang. Apakah Anda ingin menjelajahi penawaran terbaru kami atau mengalami masalah dengan kode kupon tertentu? | |
| Saya mengalami masalah dengan kode kupon | |
| Untuk mengonfirmasi, Anda mencari kode kupon. Apakah itu benar? | |
| ya | |
| Kami mohon maaf atas ketidaknyamanan ini. Bisakah Anda membagikan kode kupon yang Anda gunakan? | |
| Agen mengumpulkan kode kupon menggunakan komponen bawaan Koleksi alfanumerik | |
| Kode penawaran APPARELS5 yang terkait dengan pakaian memerlukan nilai pembelian minimum sebesar$ 100 dan berlaku hingga 28-03-2024. Pastikan kondisi seperti persyaratan pembelian minimum terpenuhi. Apakah informasi ini bermanfaat bagi Anda? |
|
| tidak | |
| Tentukan masalah yang Anda alami. Anda dapat mengatakan sesuatu seperti kode kupon saya tidak berfungsi, kode tidak berfungsi di area saya. | |
| kode kupon tidak berfungsi | |
| Untuk mengonfirmasi, masalah kode kupon yang diberikan adalah kode kupon tidak berfungsi. Apakah ini benar? | |
| ya | |
| Kami telah mengajukan tiket untuk melaporkan masalah Anda. Terima kasih telah menghubungi kami. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Penawaran dan Promo |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_offers_and_deals_category |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_offers_and_deals:get_offers_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 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 |
Komponen bawaan ini memungkinkan parameter opsional berikut untuk mengonfigurasi perilaku komponen, termasuk percobaan ulang.
| Nama Parameter | Deskripsi | Format |
|---|---|---|
| $flow.max_retry_concern_type | Menentukan jumlah percobaan ulang yang diizinkan saat memilih apakah pengguna ingin mendengar penawaran atau melaporkan masalah terkait kode kupon. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.max_retry_offers_category | Menentukan jumlah percobaan ulang yang diizinkan saat memberikan kategori untuk mendengar penawaran. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.max_retry_another_coupon_code | Menentukan jumlah percobaan ulang yang diizinkan saat memberikan kode kupon tertentu yang bermasalah bagi pengguna. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.max_retry_coupon_code_issue_counter | Menentukan jumlah percobaan ulang yang diizinkan saat memberikan masalah yang dialami pengguna dengan kode kupon. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.max_retry_message_confirm_channel | Menentukan jumlah percobaan ulang yang diizinkan saat memberikan saluran untuk menerima detail penawaran. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.valid_coupon_code_status | Menentukan nilai kolom coupon_code_status yang ditampilkan oleh webhook get_coupon_code_details yang menunjukkan bahwa kode kupon valid. Nilai defaultnya adalah "valid". |
string |
| $flow.invalid_coupon_code_status | Menentukan nilai kolom coupon_code_status yang ditampilkan oleh webhook get_coupon_code_details yang menunjukkan bahwa kode kupon tidak valid. Nilai defaultnya adalah "invalid". |
string |
| $flow.expired_coupon_code_status | Menentukan nilai kolom coupon_code_status yang ditampilkan oleh webhook get_coupon_code_details yang menunjukkan bahwa kode kupon telah habis masa berlakunya. Nilai defaultnya adalah "expired". |
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 |
| 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.
Perangkuman
Generator Summarization digunakan untuk membuat ringkasan pasca-panggilan yang menjelaskan
percakapan yang ditangani oleh komponen.
FAQ Umum
Generator General FAQ digunakan untuk menangani pertanyaan umum terkait
diskon, penjualan, pembelian, dan program loyalitas.
- Dapatkah saya mengembalikan produk promo jika saya berubah pikiran?
- Dapatkah saya mendapatkan sampel atau hadiah gratis dengan pembelian produk tertentu?
- Apakah Anda menawarkan penyesuaian harga jika item yang saya beli diskon nanti?
- Apakah ada batas waktu untuk menukarkan reward program loyalitas?
Detail penawaran khusus pengguna
Generator User-specific offer details digunakan untuk memberikan detail tentang
penawaran khusus pengguna berdasarkan informasi yang diberikan oleh webhook
get_offers_details.
Detail penawaran dan promo
Generator Offers and deals details digunakan untuk memberikan detail tentang
penawaran dan promo umum berdasarkan informasi yang diberikan oleh webhook
get_offers_details.
Pengguna dapat bertanya tentang penawaran dalam kategori tertentu atau meminta detail lebih lanjut tentang
penawaran tertentu.
FAQ penawaran dan promo
Generator Offers and deals FAQ digunakan untuk menangani pertanyaan umum (FAQ)
terkait penawaran dan promo.
- Apakah ada penawaran spesial untuk pelanggan baru?
- Bagaimana cara mendapatkan notifikasi tentang promo mendatang?
- Apakah ada promo yang tersedia secara eksklusif di toko atau online?
- Seberapa sering promo baru ditambahkan ke platform Anda?
FAQ diskon dan kode promo
Discount and promo code FAQ digunakan untuk menangani pertanyaan umum (FAQ)
terkait diskon dan kode promosi.
- Dapatkah saya menggunakan kode diskon lebih dari sekali?
- Dapatkah saya menggunakan beberapa diskon untuk satu pesanan?
- Bagaimana cara menukarkan kode diskon saat checkout?
- Bagaimana jika saya lupa menerapkan kode diskon saat checkout?
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.
Mendapatkan detail penawaran
Webhook prebuilt_components_offers_and_deals:get_offers_details digunakan
oleh komponen untuk mengambil detail tentang penawaran umum dan khusus 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 untuk mengambil detail penawaran. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| active_category | Daftar kategori penawaran yang tersedia bagi pengguna. Nilai yang valid ditentukan oleh entity prebuilt_components_offers_and_deals_category. |
Daftar (string) |
| user_email | Email yang terdaftar ke akun yang diberikan, digunakan untuk mengirim detail penawaran. | string |
| user_offer | Daftar detail penawaran khusus pengguna. Setiap elemen dalam daftar mewakili satu penawaran, dengan pasangan nilai kunci yang menjelaskan berbagai atribut penawaran, misalnya {"valid_from": "2024-01-29", "sale_type": "none", "valid_until": "2024-03-28", "offer_id": "G5E0M2D7A6Y4W9S", "discount_value": "5%", "coupon_code": "ELECTRIC5", "is_redeem_allowed": "true", "minimum_order_value": "1000", "maximum_discount_amount": "200", "offer_category_name": "electronics"}. |
Daftar (objek) |
| all_offers | Daftar detail penawaran umum. Setiap elemen daftar mewakili satu penawaran, mengikuti format yang sama dengan kolom user_offer. |
Daftar (objek) |
Untuk mengonfigurasi webhook Get offers 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_offers_and_deals:get_offers_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 kode kupon
Webhook prebuilt_components_offers_and_deals:get_coupon_code_details digunakan oleh komponen untuk mengambil detail tentang kode kupon tertentu yang dilaporkan pengguna.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $flow.coupon_code | Kode kupon untuk mengambil detailnya. | string |
| $session.params.phone_number | Nomor telepon yang terkait dengan akun pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| offer_id | ID penawaran untuk kode kupon. | string |
| offer_category_name | Kategori untuk kode kupon. Nilai yang valid ditentukan oleh entity prebuilt_components_offers_and_deals_category. |
string |
| coupon_code_status | Status kode kupon. Nilai yang valid ditentukan oleh parameter input $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status, dan $flow.valid_coupon_code_status. |
string |
| valid_until | Tanggal akhir masa berlaku kode kupon, dalam format YYYY-MM-DD. |
string |
| minimum_order_value | Nilai pesanan minimum untuk kode kupon. | string |
Untuk mengonfigurasi webhook Get coupon code 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_offers_and_deals:get_coupon_code_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.
Kirim pesan
Webhook prebuilt_components_offers_and_deals:send_message digunakan
oleh komponen untuk mengirim pesan yang berisi detail penawaran ke channel
yang dipilih 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.confirmation_channel | Saluran yang dipilih pengguna untuk menerima detail penawaran. Nilai yang valid ditentukan oleh entity prebuilt_components_channel_email_phone. |
string |
Untuk mengonfigurasi webhook Kirim pesan 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_offers_and_deals:send_message.
- 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
Webhook prebuilt_components_offers_and_deals:raise_ticket digunakan
oleh komponen untuk mengirimkan tiket yang melaporkan masalah pengguna dengan kode kupon.
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.coupon_code | Kode kupon yang masalahnya telah dilaporkan pengguna. | string |
| $flow.offer_id | ID penawaran untuk kode kupon yang diberikan. | string |
| $flow.coupon_code_issue | Masalah yang diberikan pengguna untuk kode kupon. | string |
Untuk mengonfigurasi webhook Buat tiket 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 rebuilt_components_offers_and_deals:raise_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.
Selesai
Agen dan webhook-nya kini telah disiapkan dan siap diuji.