Tombol dinamis dan data pilihan
Tampilkan produk sebagai tombol, ingat pilihan pelanggan, dan kirim pilihan itu ke reaksi berikutnya.
Di halaman ini
Bot menampilkan beberapa produk dengan tombol Beli yang sama. Pelanggan memilih gaun. Reaksi berikutnya harus mengetahui bahwa yang dipilih adalah gaun, meskipun bot telah menampilkan produk lain setelahnya.
Gunakan dua pengaturan: tombol dinamis membuat tombol dari daftar produk, sedangkan Carry mengingat produk milik setiap tombol. Keduanya tersedia dalam blok pesan pada tindakan Kirim pesan.
| Yang dilihat pelanggan | Data yang diingat tombol |
|---|---|
| Mantel, Rp1.200.000 · Beli | product_id=101, price=1200000 |
| Gaun, Rp800.000 · Beli | product_id=102, price=800000 |
| Sepatu, Rp600.000 · Beli | product_id=103, price=600000 |
Ketika pelanggan menekan tombol kedua, reaksi menerima product_id=102. Bot tidak perlu menebak produk dari tulisan Beli.
Membuat tombol dari daftar
Anda tidak perlu menambahkan tombol untuk setiap produk satu per satu. Ambil daftar dari koleksi atau layanan lain, lalu gunakan blok Tombol dinamis dari daftar. Blok ini membuat satu tombol untuk setiap produk. Daftarnya disimpan sementara dalam konteks (ctx) reaksi. Isi empat pengaturan berikut:
| Pengaturan | Contoh | Hasil |
|---|---|---|
Daftar (over) | ctx.products | Bot mengambil produk dari data sementara. Daftar dapat disiapkan melalui Permintaan ke sumber, Permintaan web, atau Perhitungan. |
Nama satu produk (as) | item, nilai bawaan | {{item.name}} mengambil nama produk yang sedang dibuatkan tombol. |
Tombol per baris (columns) | 1, nilai bawaan | Setiap produk berada pada baris tersendiri. |
| Teks tombol | {{item.name}} · {{item.price}} | Nama dan harga produk dimasukkan ke tombol. |
Saat pesan dikirim, bot mengisi tombol dengan data masing-masing produk. Daftar tiga produk menghasilkan tiga tombol. Cara yang sama dapat dipakai untuk jadwal, pesanan, atau menu.
Contoh
Misalkan ctx.products berisi produk dengan kolom id, name, dan price.
- Pilih daftar
ctx.products, beri nama satu produkitem, dan pilih satu tombol per baris. - Isi teks tombol dengan
{{item.name}} · {{item.price}}. - Pilih jenis tombol Panggil reaksi dan reaksi untuk memproses pesanan.
- Pada Carry, tambahkan kunci
product_iddengan nilai{{item.id}}. - Di reaksi pemesanan, gunakan
{{ctx.product_id}}untuk membaca produk yang dipilih.
Coba tekan tombol kedua lalu tombol pertama. Setiap kali, reaksi harus menerima ID dari produk yang tombolnya ditekan.
Mengirim data saat tombol ditekan (Carry)
Carry adalah data yang dibawa tombol ketika ditekan. Bayangkan setiap tombol memiliki label produknya sendiri, meskipun semua tombol bertuliskan Beli dan membuka reaksi yang sama.
Di editor, pengaturan ini bernama Data saat ditekan. Nilainya disimpan ketika pesan dikirim. Saat tombol ditekan, bot menyalinnya ke ctx, yaitu data sementara untuk reaksi yang baru dijalankan.
- Kunci: nama data yang disimpan. Untuk
product_id, baca hasilnya sebagai{{ctx.product_id}}. - Nilai: data yang akan diingat. Anda dapat menulis angka atau mengambilnya dari
{{item.id}},{{param.order_id}}, atau{{ctx.x}}. Nilai diisi saat pesan dikirim. - Sekali pakai (
single_use): setelah pertama kali ditekan, data yang disimpan dihapus dan tidak dapat dipakai lagi. Pengaturan ini tidak menghilangkan tombol dari pesan. - Masa berlaku data tombol (
ttl_seconds): berapa detik data disimpan.3600berarti satu jam.0memakai masa berlaku bawaan, saat ini 30 hari, bukan tanpa batas.
Setelah masa berlaku habis, data lama tidak tersedia. Beri pelanggan cara untuk membuka katalog lagi. Setiap tombol yang dikirim memiliki data sendiri, meskipun tulisan dan reaksi tujuannya sama dengan tombol lain. Dalam dokumentasi teknis, sifat ini disebut per-invocation.
Menyimpan parameter pelanggan saat tombol ditekan (set_params)
Kadang pilihan perlu diingat setelah reaksi selesai. Misalnya, pelanggan memilih kota pengiriman dan bot perlu menggunakannya pada pesanan berikutnya. Isi kolom Parameter (set_params) pada tombol. Saat tombol ditekan, kota disimpan pada profil pelanggan dan dapat dibaca sebagai {{param.city}}.
Carry mengirim data sementara ke reaksi yang sedang berjalan ({{ctx.kunci}}). set_params menyimpan data untuk penggunaan berikutnya ({{param.kunci}}). Blok pesan juga memiliki set_params, tetapi nilainya disimpan saat pesan dikirim, meskipun pelanggan tidak menekan tombol.
Tombol juga dapat menambah atau menghapus label ketika ditekan, dengan pengaturan yang sama seperti pada blok pesan.
Memilih cara menyimpan data
| Tujuan | Gunakan | Baca hasil di |
|---|---|---|
| Kirim produk yang dipilih ke reaksi berikutnya | Carry | {{ctx.product_id}} |
| Ingat kota setelah pelanggan memilihnya | set_params pada tombol | {{param.city}} |
| Simpan nilai segera setelah pesan dikirim | set_params pada blok pesan | {{param.kunci}} |
Langkah berikutnya
- Pesan dan tombol: jenis tombol dan tindakan saat tombol ditekan.
- Variabel dan rumus: penggunaan
{{item.*}},{{ctx.*}}, dan{{param.*}}. - Hubungan antarreaksi: lihat reaksi tujuan setiap tombol.
- Koleksi dan data: sumber daftar untuk tombol dinamis.