Nút động và tham số
Hiển thị sản phẩm bằng nút, ghi nhớ lựa chọn và chuyển dữ liệu cho phản ứng tiếp theo. Ví dụ về Carry, thời hạn và tham số lâu dài.
Trên trang này
Bot hiển thị ba sản phẩm, mỗi sản phẩm có nút “Mua” giống nhau. Khách chọn chiếc váy. Phản ứng tiếp theo phải nhận đúng chiếc váy, kể cả khi bot đã hiển thị các sản phẩm khác sau đó.
Bạn cần hai thiết lập: nút động tạo nút từ danh sách sản phẩm, còn Carry ghi nhớ sản phẩm gắn với từng nút. Cả hai nằm trong khối tin nhắn của hành động Gửi tin nhắn.
| Khách nhìn thấy | Dữ liệu nút ghi nhớ |
|---|---|
| Áo khoác, 12.000 ₽ · Mua | product_id=101, price=12000 |
| Váy, 8.000 ₽ · Mua | product_id=102, price=8000 |
| Giày, 6.000 ₽ · Mua | product_id=103, price=6000 |
Nhấn nút thứ hai sẽ chuyển product_id=102 cho phản ứng. Bot không cần đoán sản phẩm từ chữ “Mua”.
Nút động từ danh sách
Thay vì thêm từng sản phẩm bằng tay, hãy lấy danh sách từ bộ sưu tập hoặc dịch vụ ngoài. Khối Nút động từ danh sách tạo một nút cho mỗi phần tử. Danh sách nằm trong dữ liệu tạm của phản ứng, gọi là ngữ cảnh (ctx). Thiết lập bốn trường:
| Trường | Ví dụ | Kết quả |
|---|---|---|
Danh sách (over) | ctx.products | Bot lấy sản phẩm từ dữ liệu tạm đã được Truy vấn nguồn dữ liệu, Yêu cầu web hoặc Tính toán chuẩn bị. |
Tên tạm của phần tử (as) | item, giá trị mặc định | {{item.name}} là tên của một sản phẩm trong danh sách. |
Số nút mỗi hàng (columns) | 1, giá trị mặc định | Mỗi sản phẩm ở một hàng riêng. |
| Mẫu nút | {{item.name}} · {{item.price}} ₽ | Bot chèn tên và giá vào chữ cùng các trường khác của từng nút. |
Khi gửi, bot điền dữ liệu của từng sản phẩm vào mẫu. Danh sách ba sản phẩm tạo ba nút. Bạn cũng có thể dùng cách này cho lớp học còn chỗ, đơn hàng hoặc menu.
Ví dụ
Giả sử ctx.products chứa danh sách có các trường id, name, price:
- Chọn danh sách
ctx.products, tên tạmitemvà một nút mỗi hàng. - Trong chữ của nút, viết
{{item.name}} · {{item.price}} ₽. - Chọn loại nút Gọi phản ứng và phản ứng xử lý đơn hàng.
- Trong Carry, thêm khóa
product_idvới giá trị{{item.id}}. - Trong phản ứng xử lý đơn hàng, đọc
{{ctx.product_id}}để biết sản phẩm đã chọn.
Hãy nhấn nút thứ hai rồi nút thứ nhất để kiểm tra: mỗi lần phải nhận ID của đúng sản phẩm được nhấn.
Tham số khi nhấn (Carry)
Carry là dữ liệu nút chuyển khi được nhấn. Hãy hình dung mỗi nút có một thẻ thông tin riêng, dù tất cả đều ghi “Mua” và chạy cùng phản ứng.
Trong trình chỉnh sửa, thiết lập này có tên Dữ liệu gửi khi nhấn. Giá trị được ghi lại khi gửi tin nhắn. Khi khách nhấn, bot đưa giá trị vào ctx của lần chạy phản ứng mới.
- Khóa: tên giá trị; với
product_id, đọc kết quả qua{{ctx.product_id}}. - Giá trị: số hoặc biến thay thế như
{{item.id}},{{param.order_id}},{{ctx.x}}. Biến được tính khi gửi tin. - Dùng một lần (
single_use): xóa dữ liệu sau lần nhấn đầu, không thể dùng lại. - Thời hạn dữ liệu nút (
ttl_seconds): số giây lưu dữ liệu;3600là một giờ,0dùng thời hạn mặc định hiện là 30 ngày, không phải lưu vĩnh viễn.
Sau khi hết hạn, dữ liệu cũ không dùng được; hãy cho khách mở lại danh mục. Mỗi nút đã gửi có bộ giá trị riêng, kể cả khi chữ và phản ứng đích giống nhau. Tài liệu kỹ thuật gọi tính chất này là per-invocation.
Đặt tham số bằng nút (set_params)
Đôi khi cần nhớ lựa chọn cả sau khi phản ứng kết thúc. Chẳng hạn, khách chọn thành phố giao hàng và bot cần dùng cho đơn sau. Trường Tham số (set_params) trên nút sẽ lưu giá trị vào hồ sơ người đăng ký khi nhấn. Sau đó thành phố có trong {{param.city}}.
Carry chuyển dữ liệu tạm cho lần chạy hiện tại ({{ctx.key}}), còn set_params lưu giữa các lần chạy ({{param.key}}). Khối tin nhắn cũng có set_params, nhưng nó lưu ngay khi gửi, dù khách chưa nhấn nút.
Nút khi nhấn cũng có thể thêm và xóa nhãn — bằng các trường tương tự như khối tin nhắn.
Sự khác biệt giữa ba cơ chế
| Việc cần làm | Chọn gì | Đọc kết quả ở đâu |
|---|---|---|
| Chuyển sản phẩm đã chọn cho phản ứng sau | Carry | {{ctx.product_id}} |
| Nhớ thành phố sau khi khách chọn | set_params trên nút | {{param.city}} |
| Lưu giá trị ngay lúc gửi tin | set_params trên khối | {{param.key}} |
Tiếp theo
- Tin nhắn và nút — khối tin nhắn, loại nút và hành vi khi nhấn.
- Thay thế và công thức — biến
{{item.*}},{{ctx.*}},{{param.*}}trong template. - Liên kết phản ứng — nút dẫn đến đâu và cách xem đồ thị chuyển đổi.
- Bộ sưu tập và dữ liệu — nơi lấy danh sách cho nút động.