Cơ sở kiến thức GetMyBot

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ấyDữ liệu nút ghi nhớ
Áo khoác, 12.000 ₽ · Muaproduct_id=101, price=12000
Váy, 8.000 ₽ · Muaproduct_id=102, price=8000
Giày, 6.000 ₽ · Muaproduct_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ườngVí dụKết quả
Danh sách (over)ctx.productsBot 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 địnhMỗ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:

  1. Chọn danh sách ctx.products, tên tạm item và một nút mỗi hàng.
  2. Trong chữ của nút, viết {{item.name}} · {{item.price}} ₽.
  3. Chọn loại nút Gọi phản ứng và phản ứng xử lý đơn hàng.
  4. Trong Carry, thêm khóa product_id với giá trị {{item.id}}.
  5. 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; 3600 là một giờ, 0 dù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àmChọn gìĐọc kết quả ở đâu
Chuyển sản phẩm đã chọn cho phản ứng sauCarry{{ctx.product_id}}
Nhớ thành phố sau khi khách chọnset_params trên nút{{param.city}}
Lưu giá trị ngay lúc gửi tinset_params trên khối{{param.key}}

Tiếp theo