Basis pengetahuan GetMyBot

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 pelangganData yang diingat tombol
Mantel, Rp1.200.000 · Beliproduct_id=101, price=1200000
Gaun, Rp800.000 · Beliproduct_id=102, price=800000
Sepatu, Rp600.000 · Beliproduct_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:

PengaturanContohHasil
Daftar (over)ctx.productsBot 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 bawaanSetiap 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.

  1. Pilih daftar ctx.products, beri nama satu produk item, dan pilih satu tombol per baris.
  2. Isi teks tombol dengan {{item.name}} · {{item.price}}.
  3. Pilih jenis tombol Panggil reaksi dan reaksi untuk memproses pesanan.
  4. Pada Carry, tambahkan kunci product_id dengan nilai {{item.id}}.
  5. 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. 3600 berarti satu jam. 0 memakai 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

TujuanGunakanBaca hasil di
Kirim produk yang dipilih ke reaksi berikutnyaCarry{{ctx.product_id}}
Ingat kota setelah pelanggan memilihnyaset_params pada tombol{{param.city}}
Simpan nilai segera setelah pesan dikirimset_params pada blok pesan{{param.kunci}}

Langkah berikutnya