Cơ sở kiến thức GetMyBot

Phản ứng: kiến thức cơ bản

Dạy bot trả lời lệnh, lượt nhấn nút hoặc sự kiện khác. Tạo phản ứng, sắp xếp ưu tiên và chuyển giữa các phản ứng.

Trên trang này

Phản ứng là một quy tắc về cách bot xử lý sự kiện. Ví dụ: “Khi có người gửi /price, gửi bảng giá”, hoặc “Khi họ thanh toán, gắn nhãn ‘Đã thanh toán’ và cấp quyền truy cập”.

Trong mục Phản ứng, bạn chọn sự kiện, điều kiện bổ sung và các hành động. Bot xét quy tắc từ trên xuống và chạy quy tắc phù hợp đầu tiên. Vì thế, quy tắc riêng thường nên nằm trên quy tắc trả lời chung cho mọi tin nhắn.

Một phản ứng gồm những gì?

Với ví dụ bảng giá, bạn chỉ cần chọn lệnh /price và thêm tin nhắn chứa giá. Các tùy chọn khác chỉ cần thiết khi quy tắc áp dụng cho một số người hoặc cuộc trò chuyện nhất định. Trình chỉnh sửa có bốn tab:

TabTrả lời câu hỏiVí dụ
Trình kích hoạtKhi nào chạy: văn bản, lệnh, tệp, nút, sự kiện hay lịchNgười dùng gửi /price
Trong cuộc trò chuyệnChạy ở đâu: chat riêng, khi được gọi trong nhóm, hoặc các chat cụ thể; có xét trạng thái người dùngChỉ chat riêng
Điều kiệnCần kiểm tra thêm gì: nhãn, tham số, thời gian, số tin nhắnNgười dùng có nhãn “Đã thanh toán”
Hành độngBot làm gì: gửi tin, đổi nhãn, ghi dữ liệu, gọi AIGửi bảng giá

Tạo và chỉnh sửa

Nhấn Tạo phản ứng hoặc mở một phản ứng đã có. Ở đầu trình chỉnh sửa, nhập tên bắt buộc, số #N và mô tả, rồi đặt trạng thái Đang hoạt động. Bên trái là các phần Trình kích hoạt / Trong cuộc trò chuyện / Điều kiện / Hành động; biểu mẫu ở giữa. Bên phải là bản xem trước tin nhắn Telegram với các khối, nút và menu. Nhấn Lưu để hoàn tất.

Với phản ứng đã lưu, trình chỉnh sửa còn hiển thị bảng thống kê: số lần chạy, biểu đồ và các sự kiện gần đây.

Lịch sử thay đổi và khôi phục

Mở Lịch sử thay đổi của phản ứng đã lưu. Bạn sẽ thấy tối đa 20 thay đổi gần nhất, thời gian, người sửa, nguồn chỉnh sửa và phần khác nhau giữa “Trước / Sau”. Có thể khôi phục trạng thái trước một thay đổi đã chọn: xem khác biệt trước, rồi xác nhận.

Việc khôi phục thay thế những chỉnh sửa chưa lưu và cũng được ghi vào lịch sử. Nó đưa cấu hình phản ứng trở lại nhưng không thu hồi tin nhắn đã gửi hoặc hoàn tác thay đổi dữ liệu. Nếu đồng đội sửa phản ứng trong lúc bạn xem, hãy tải lại phần khác biệt. Xem hướng dẫn và bài thực hành.

Thứ tự và độ ưu tiên

Trong danh sách không có tìm kiếm, bộ lọc hoặc thư mục đang chọn, bạn có thể kéo phản ứng theo thứ tự thủ công. Thứ tự này quyết định ưu tiên: bot chạy phản ứng phù hợp đầu tiên rồi ngừng xét. Nếu muốn bot tiếp tục tìm các phản ứng phù hợp khác, thêm hành động Phản ứng tiếp theo (goto_next).

Tìm kiếm, lọc và nhóm

Phía trên danh sách có tìm kiếm theo tên hoặc số và các bộ lọc:

  • Trạng thái: tất cả, chỉ phản ứng đang hoạt động hoặc chỉ phản ứng đã tắt.
  • Ngày tạo từ / đến: ngày theo múi giờ của bạn, bao gồm cả hai ngày đầu và cuối.
  • Thứ tự: thủ công như bot xét, mới nhất trước hoặc cũ nhất trước.
  • Nhóm: theo ngày hoặc tháng tạo. Chỉ có thể nhóm khi sắp xếp theo ngày. Nếu bật nhóm từ thứ tự thủ công, danh sách sẽ chuyển sang “Mới nhất trước”; nếu đã chọn “Mới nhất trước” hoặc “Cũ nhất trước”, lựa chọn đó vẫn được giữ. Chọn thứ tự thủ công sẽ tắt nhóm.

Bộ lọc áp dụng cho toàn bộ phản ứng, không chỉ trang đang mở, và có thể kết hợp với tìm kiếm, thư mục. Bộ đếm hiển thị số kết quả. Trạng thái lọc nằm trong địa chỉ trang, nên bạn có thể tải lại, gửi liên kết hoặc dùng nút Quay lại mà không mất lựa chọn. Đặt lại bộ lọc xóa từ khóa tìm kiếm, bộ lọc, thứ tự và nhóm, nhưng giữ thư mục đang chọn.

Lọc và sắp xếp chỉ thay đổi cách hiển thị danh sách; thứ tự bot thực sự xét phản ứng không đổi.

Bật và tắt

Công tắc ở hàng danh sách hoặc Đang hoạt động trong trình chỉnh sửa bật/tắt phản ứng mà không xóa nó. Bot bỏ qua các phản ứng đã tắt.

Sao chép và xóa

Mỗi hàng có nút Sao chép để tạo bản giống và Xóa. Sao chép giúp tạo nhanh một phản ứng gần giống với vài thay đổi nhỏ.

Nhập và xuất

Trong trình chỉnh sửa, nút Xuất lưu phản ứng dưới dạng JSON. Nút Nhập trong danh sách đưa JSON trở lại. Bạn có thể chuyển phản ứng giữa các bot hoặc lưu phiên bản bên ngoài nền tảng.

Gửi phản ứng hàng loạt

Nút Gửi hàng loạt (biểu tượng gửi) trên hàng phản ứng sẽ gửi phản ứng đó tới tất cả người đăng ký đang hoạt động của bot, phù hợp cho thông báo. Có thể thu hẹp người nhận theo nhãn. Xem Gửi hàng loạt.

Nối phản ứng và tạo hội thoại

Ví dụ: phản ứng đầu hiển thị danh mục, nút mở phản ứng thứ hai với thông tin sản phẩm, rồi bot hỏi địa chỉ giao hàng. Bạn có thể nối phản ứng theo nhiều cách:

  • Phản ứng chuỗi (chain): hành động gọi phản ứng khác trong lúc đang xử lý.
  • Phản ứng tiếp theo (goto_next): chuyển sang phản ứng phù hợp tiếp theo trong danh sách.
  • Các bước hội thoại: khối tin nhắn có thể chờ câu trả lời, kiểm tra định dạng và tạm dừng kịch bản. Xem Tin nhắn và nút.
  • Nhánh “nếu không”: nếu điều kiện không đạt, chạy phản ứng khác theo ô trong phần Điều kiện.
  • Chọn bước tiếp theo (branch_result): xử lý kết quả tìm kiếm rỗng, một kết quả, nhiều kết quả hoặc chưa đầy đủ.
  • Chọn bước theo giá trị (branch_value): ví dụ, updated thì xác nhận yêu cầu, conflict thì đề nghị đọc lại trạng thái.
  • Kết quả hành động: chuyển sang phản ứng khác khi thành công, xung đột, không tìm thấy bản ghi hoặc có lỗi, nếu hành động hỗ trợ kết quả đó. Xem cách chọn nhánh.
  • Gọi khối (call_block): truyền dữ liệu đầu vào cho phép tính dùng chung và nhận dữ liệu đầu ra đã khai báo trong phản ứng hiện tại. Xem thư viện khối và phiên bản.

Để xử lý dữ liệu, có thể nối Tìm kiếm trong bộ sưu tập → Chọn bước tiếp theo → nút → Tìm bản ghi liên quan. Nếu danh sách đến từ dịch vụ ngoài, dùng Xử lý danh sách → Nhóm và tổng hợp. Đặt tên cho kết quả của từng hành động, rồi chọn nó trong hành động tiếp theo.

Các bài thực hành minh họa hai chuỗi trên với lớp học và yêu cầu đặt chỗ. Khi thiết lập, dùng dữ liệu từ những bước trước để khỏi nhớ đường dẫn thủ công. Trước khi lưu, kiểm tra bản nháp trên dữ liệu mẫu để xem nhánh và tin nhắn dự kiến. Sau khi lưu, thử toàn bộ quy trình qua bot và kênh thật, nơi hành động thực sự được chạy.

Tiếp theo