Penawaran dan promo komponen bawaan

Penawaran dan transaksi komponen bawaan memeriksa apakah pemanggil adalah pengguna terdaftar. Jika pengguna memiliki akun terdaftar, komponen dapat memberikan informasi tentang penawaran dan transaksi khusus pengguna. Pengguna juga dapat memperoleh detail tentang penawaran dan promo umum atau melaporkan masalah terkait kode kupon tertentu. Komponen ini menggunakan komponen bawaan Pengumpulan alfanumerik untuk mengumpulkan kode kupon. Komponen ini juga menggunakan Generator untuk ringkasan pascapanggilan, FAQ, dan detail penawaran.

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.

Penawaran dan transaksi khusus pengguna dan umum

Pengguna akhir telah diautentikasi sebelumnya. Pengguna meminta penawaran terbaru 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 tersebut. Agen menawarkan untuk mengirim detail penawaran kepada pengguna dan pengguna menolak.

Input pengguna Respons agen
Selamat datang. Apakah Anda ingin mempelajari penawaran terbaru kami atau mengalami masalah dengan kode kupon tertentu?
Saya ingin melihat penawaran terbaru
Untuk mengonfirmasi, Anda 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 belanjaan, gunakan kode GROCERY500, berlaku hingga 28-03-2024.

Semoga penawaran ini menarik Apa ada pertanyaan tentang penawaran atau promo yang dapat kami jawab untuk Anda?
Apakah ada nilai minimum pembelian 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, yang berlaku hingga 28-03-2024.

Kami harap dapat memberikan detail yang Anda butuhkan. Apa ada pertanyaan tentang penawaran atau promo yang dapat kami jawab untuk Anda?
Ada penawaran elektronik?
Tentu saja! Berikut detail penawarannya:
Penawaran 1: Nikmati diskon 5% untuk elektronik, gunakan kode ELECTRIC5, yang berlaku hingga 28-03-2024.
Penawaran 2: Dapatkan diskon 15% untuk elektronik, gunakan kode ELECTRIC15, berlaku hingga 28-03-2024.

Kami berharap dapat memberikan detail yang Anda butuhkan. Apa ada pertanyaan tentang penawaran atau promo yang dapat kami jawab untuk Anda?
Tidak, saya sudah selesai
Ingin detail penawaran dibagikan di ponsel atau email yang terdaftar?
Tidak
Terima kasih sudah menelepon.

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 kepada pengguna tentang penukaran kode kupon. 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 mempelajari 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 Anda. Bisakah Anda membagikan kode kupon yang Anda gunakan?
Agen mengumpulkan kode kupon menggunakan komponen bawaan Pengumpulan alfanumerik
Kode penawaran APPARELS5 yang terkait dengan pakaian memerlukan nilai pembelian minimum sebesar 100$ dan berlaku hingga 28-03-2024. Pastikan ketentuan seperti persyaratan pembelian minimum terpenuhi.

Apakah informasi ini bermanfaat bagi Anda?
tidak ada
Sebutkan masalah yang Anda alami. Anda mungkin mengatakan sesuatu seperti kode kupon saya tidak berfungsi, kode tidak berfungsi di wilayah saya.
kode kupon tidak berfungsi
Untuk mengonfirmasi, masalah kode kupon yang diberikan adalah kode kupon tidak berfungsi. Apakah ini benar?
ya
Kami telah mengirimkan tiket untuk melaporkan masalah Anda. Terima kasih sudah menelepon.

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 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

Komponen bawaan ini memungkinkan parameter opsional berikut 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 menyediakan 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 sudah tidak berlaku. Nilai defaultnya adalah "expired". string

Guna mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan 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 Halaman Awal di bagian Halaman.
  7. Klik Rute true di Halaman Awal.
  8. Di jendela Rute, edit nilai Parameter Presets sesuai kebutuhan.
  9. Klik Save.

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 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

Generator

Komponen ini menggunakan Generator untuk mengaktifkan bagian percakapan tertentu.

Perangkuman

Generator Summarization digunakan untuk membuat ringkasan pasca-panggilan yang mendeskripsikan percakapan yang ditangani oleh komponen.

FAQ Umum

Generator General FAQ digunakan untuk menangani pertanyaan umum (FAQ) terkait diskon, promo, pembelian, dan program loyalitas.

  • Dapatkah saya mengembalikan produk promo jika saya berubah pikiran?
  • Apakah saya bisa mendapatkan sampel atau hadiah gratis untuk pembelian produk tertentu?
  • Apakah Anda menawarkan penyesuaian harga jika item yang saya beli dijual kemudian?
  • Apakah ada batas waktu untuk menukarkan reward program loyalitas?

Detail penawaran khusus pengguna

Generator User-specific offer details digunakan untuk memberikan detail 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 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 pemberitahuan tentang promo mendatang?
  • Apakah ada promo yang tersedia secara eksklusif di toko atau secara online?
  • Seberapa sering promo baru ditambahkan ke platform Anda?

FAQ tentang 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:

  1. Impor komponen bawaan.
  2. 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.

Dapatkan detail penawaran

Webhook prebuilt_components_offers_and_deals:get_offers_details digunakan oleh komponen untuk mengambil detail tentang penawaran khusus pengguna dan umum.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk 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 yang akan digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
active_category Daftar kategori penawaran yang tersedia untuk 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 spesifik per pengguna. Setiap elemen daftar merepresentasikan satu penawaran, dengan key-value pair 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, dengan mengikuti format yang sama dengan kolom user_offer. Daftar (objek)

Guna mengonfigurasi webhook Dapatkan detail penawaran untuk komponen ini, luaskan untuk mendapatkan 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_offers_and_deals:get_offers_details.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna 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 parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Save.

Dapatkan detail kode kupon

Webhook prebuilt_components_offers_and_deals:get_coupon_code_details digunakan oleh komponen untuk mengambil detail tentang kode kupon tertentu yang telah dilaporkan bermasalah oleh pengguna.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input untuk permintaan API.

Nama Parameter Deskripsi Format Input
$flow.coupon_code Kode kupon untuk diambil detailnya. string
$session.params.phone_number Nomor telepon yang dikaitkan dengan akun pengguna. string

Parameter respons API

Parameter berikut diambil dari respons API yang akan 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 berdasarkan parameter input $flow.valid_coupon_code_status, $flow.invalid_coupon_code_status, dan $flow.valid_coupon_code_status. string
valid_until Tanggal saat kode kupon valid hingga, dalam format YYYY-MM-DD. string
minimum_order_value Nilai pesanan minimum untuk kode kupon. string

Guna mengonfigurasi webhook Dapatkan detail kode kupon untuk komponen ini, luaskan untuk mendapatkan 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_offers_and_deals:get_coupon_code_details.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna 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 parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Save.

Kirim pesan

Webhook prebuilt_components_offers_and_deals:send_message digunakan oleh komponen untuk mengirim pesan yang berisi detail penawaran ke saluran yang dipilih pengguna.

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.confirmation_channel Saluran yang dipilih pengguna untuk menerima detail penawaran. Nilai yang valid ditentukan oleh entity prebuilt_components_channel_email_phone. string

Guna mengonfigurasi webhook Kirim pesan untuk komponen ini, luaskan untuk mendapatkan 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_offers_and_deals:send_message.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna 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 parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Save.

Naikkan tiket

Webhook prebuilt_components_offers_and_deals:raise_ticket digunakan oleh komponen untuk mengirim tiket yang melaporkan masalah pengguna dengan kode kupon.

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.coupon_code Kode kupon yang masalahnya telah dilaporkan oleh pengguna. string
$flow.offer_id ID penawaran untuk kode kupon yang diberikan. string
$flow.coupon_code_issue Masalah kode kupon yang diberikan pengguna. string

Guna mengonfigurasi webhook Naikkan tiket untuk komponen ini, luaskan untuk mendapatkan 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 rebuilt_components_offers_and_deals:merge_ticket.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin diintegrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna 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 parameter ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
  10. Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
  11. Klik Save.

Selesai

Agen Anda dan webhook-nya sekarang telah disiapkan dan siap diuji.