14.4. Minigame: Tag 2 bạn nhận lượt quay

---

Tổng quan kịch bản

Minigame "Tag bạn — Quay Vòng Quay May Mắn" kết hợp cơ chế bắt buộc tag bạn với trò chơi Lucky Wheel để tạo chiến dịch viral mạnh mẽ. Khách phải tag đủ 2 bạn bè mới nhận được lượt quay — đảm bảo mỗi lượt chơi đều mang lại reach thực sự cho thương hiệu.

Cơ chế hoạt động:

• Bạn đăng bài mời tham gia minigame kèm điều kiện: "Tag 2 bạn bè + Comment để nhận 1 lượt quay!"
• Khi khách comment, bot đếm số lượng tag và lưu vào attribute so_tag.
• Nếu chưa đủ 2 tag → bot nhắc tag thêm + gửi Messenger kèm nút quay lại bài viết.
• Nếu đủ 2 tag → bot kiểm tra khách đã nhận lượt chưa:
  • Chưa nhận → Cộng 1 lượt quay + đánh dấu đã nhận + mở Vòng quay.
  • Đã nhận rồi → Thông báo đã nhận, mời chia sẻ cho bạn bè.
• Sau khi quay trúng → Bot thu thập SĐT + gửi mã voucher + lưu kết quả ra Google Sheets.

Lợi ích:

• Viral mạnh: Mỗi người chơi tạo ít nhất 2 notification cho bạn bè → reach nhân bội.
• Tương tác cao: Gamification (quay vòng quay) kích thích sự tò mò và hứng thú tham gia.
• Chống gian lận: Mỗi nick Facebook chỉ nhận 1 lượt quay duy nhất, không spam được.
• Thu thập data chất lượng: SĐT thu được gắn liền với kết quả trúng thưởng → tỷ lệ số thật cao.
• Quản lý dễ dàng: Toàn bộ kết quả (tên, SĐT, giải thưởng, hạn sử dụng) tự động lưu vào Google Sheets.

---

Kịch bản mẫu: Tag 2 bạn quay Vòng Quay May Mắn

🎯 Sơ đồ luồng hội thoại

BÀI VIẾT MINIGAME
"Tag 2 bạn + Comment
 để nhận 1 lượt quay!"
           │
           ▼
  Khách comment + tag bạn
  (VD: "@A @B quay thôi")
           │
           ▼
  ┌─────────────────────┐
  │  Trigger Comment    │
  │  ☑️ Like comment     │
  │  Lưu: so_tag,       │
  │  cmt_id, post_id    │
  │  Inbox → Block      │
  │  "KiemTraTag"       │
  └─────────┬───────────┘
            │
            ▼
  ┌─────────────────────┐
  │  Block: KiemTraTag  │
  │                     │
  │  Go to Block        │
  │  nếu so_tag < 2     │
  │  → "ChuaDuTag"      │
  │                     │
  │  Nếu so_tag ≥ 2:   │
  │  → Reply comment    │
  │  → Gửi Messenger    │
  │  Nút [🔓Mở khoá    │
  │   Vòng quay]        │
  └───┬─────────┬───────┘
      │         │
      ▼         ▼
(so_tag<2)  (so_tag≥2)
      │         │
      ▼         ▼
┌───────────┐ ┌──────────────────┐
│ChuaDuTag  │ │Block: VongQuay   │
│           │ │                  │
│Comment:   │ │ Go to Block      │
│"Cần tag   │ │ nếu luot_choi    │
│ đủ 2      │ │ = "Da_Nhan"      │
│ người!"   │ │ → "DaNhanLuot"   │
│           │ │                  │
│Messenger: │ │ Nếu chưa nhận:  │
│"Tag thêm  │ │ +1 lượt quay    │
│ rồi quay  │ │ Set luot_choi   │
│ lại nhé!" │ │  = "Da_Nhan"    │
│Nút:[Vào   │ │                  │
│ bài viết] │ │ Gallery:         │
└───────────┘ │ "Bạn có 1 lượt   │
              │  quay"           │
              │ Nút:[🎰QUAY NGAY]│
              │ →Webview LuckyWheel
              └────┬────────┬────┘
                   │        │
        ┌──────────┘        │
        ▼                   ▼
┌──────────────┐  ┌──────────────────┐
│ DaNhanLuot   │  │ Block: NhanQua   │
│              │  │                  │
│ "Bạn đã     │  │ Chúc mừng trúng  │
│  nhận lượt   │  │ {{qua_tang}}!    │
│  quay rồi!" │  │                  │
│              │  │ Thu thập SĐT     │
│ "Chia sẻ    │  │ Xác nhận SĐT     │
│  cho bạn    │  │                  │
│  bè nhé!"   │  │ Tính ngày hết hạn│
└──────────────┘  │ (+30 ngày)       │
                  │                  │
                  │ Gửi mã voucher   │
                  │ {{pid}}          │
                  │                  │
                  │ Gửi thông tin    │
                  │ quà tặng đầy đủ │
                  │                  │
                  │ Lưu Google Sheets│
                  └──────────────────┘

📝 Nội dung chi tiết

Bài viết mẫu trên Fanpage:

🎰 MINIGAME VÒNG QUAY MAY MẮN — TRÚNG LỚN! 🎰

[Tên thương hiệu] dành tặng bạn cơ hội quay thưởng với giải thưởng hấp dẫn:
🎟️ Mã giảm giá 10% - 20% - 30%
💰 Phiếu mua hàng 100K - 200K - 300K

🎯 Cách tham gia:
1️⃣ Like bài viết này
2️⃣ Tag 2 người bạn vào comment
3️⃣ Comment bất kỳ nội dung

📩 Bot sẽ gửi lượt quay vào Messenger cho bạn!

⚠️ Mỗi tài khoản chỉ nhận 1 lượt quay.
⚠️ Phải tag đủ 2 người mới hợp lệ!

#spin #vongquay #[tên_thương_hiệu]

---

Phần 1 — Block "KiemTraTag" (rẽ nhánh theo số tag):

Block này quyết định luồng xử lý. Trigger Comment gửi khách tới đây ngay khi comment.

Thẻ 1 — Note (ghi chú nội bộ, không hiển thị cho khách):

Thẻ bên dưới giúp kiểm tra nếu khách hàng tag chưa đủ 2 bạn trở lên thì phản hồi cần tag lại.

Thẻ 2 — Go to Block (có điều kiện):

• Block đích: "ChuaDuTag"
• Điều kiện: so_tag nhỏ hơn (lt) 2
• Nếu đúng → chuyển tới ChuaDuTag, không chạy tiếp các thẻ bên dưới.

Thẻ 3 — Note:

Nếu khách hàng tag đủ 2 bạn trở lên thì đi tiếp kịch bản bên dưới.

Thẻ 4 — Facebook Comment (trả lời comment công khai, spintax):

{Cảm ơn|Thank} [=GENDER("anh","chị","bạn")] {{name}} {nha|nhé}! {Mình|Shop} đã ghi nhận {1 lượt quay|lượt quay} cho [=GENDER("anh","chị","bạn")] rồi {🎁|🎊|✅} {Kiểm tra Inbox |Hãy xem tin nhắn} để {quay ngay|quay và nhận quà} {nha|nhé} [=GENDER("anh","chị","bạn")]!

• Comment ID: {{cmt_id}}

Thẻ 5 — Messenger Text (DUY NHẤT 1 tin nhắn — quy định Facebook):

Chào {{name}}! 🎉🎉🎉

Cảm ơn bạn đã tham gia minigame VÒNG QUAY MAY MẮN của {{page_name}}!

Bạn có 1 lượt quay với cơ hội nhận:
🎟️ Mã giảm giá 10% - 20% - 30%
💰 Phiếu mua hàng 100K - 200K - 300K

Bấm nút bên dưới để mở khoá vòng quay ngay nhé! 👇

• Button: 🔓 Mở khoá Vòng quay → Dẫn tới Block "VongQuay"

⚠️ Nhắc lại: Facebook chỉ cho phép gửi DUY NHẤT 1 tin nhắn khi kéo khách từ comment sang Messenger. Vì vậy block "KiemTraTag" chỉ chứa 1 thẻ Messenger Text. Phần quay vòng quay được kích hoạt khi khách bấm nút.

---

Phần 2 — Block "ChuaDuTag" (chưa tag đủ 2 người):

Thẻ 1 — Facebook Comment (trả lời comment công khai):

{Cảm ơn|Thank} [=GENDER("anh","chị","bạn")] {{name}} đã {tham gia|ghé chơi} {nè|nha}! {Nhưng mà|Tuy nhiên} [=GENDER("anh","chị","bạn")] cần tag {thêm bạn bè cho đủ|đủ} 2 người {nhé|nha}, lượt quay đang {chờ|đợi} [=GENDER("anh","chị","bạn")] {kìa|đó} {😊|😍|🔥|💪}

Thẻ 2 — Messenger Text:

Chào {{name}}! 😊

Để nhận lượt quay Vòng quay may mắn, bạn cần:
✅ Vào bài viết minigame trên Fanpage
✅ Bình luận và tag đủ 2 bạn bè trở lên

Sau khi tag đủ, quay lại đây để nhận lượt quay nhé! 🎰🎁

• Button: 📝 Vào bài viết → URL: https://facebook.com/{{post_id}}

---

Phần 3 — Block "VongQuay" (cộng lượt + chống trùng + mở game):

Đây là block phức tạp nhất, xử lý 3 việc: kiểm tra trùng lượt → cộng lượt quay → mở game.

Thẻ 1 — Note:

Do luật chơi là mỗi nick Facebook chỉ được nhận 1 lượt chơi nên thẻ bên dưới sẽ kiểm tra KH đã từng chơi rồi thì không cộng lượt quay nữa.

Thẻ 2 — Go to Block (có điều kiện — chống trùng lượt):

• Block đích: "DaNhanLuot"
• Điều kiện: luot_choi bằng (is) Da_Nhan
• Nếu đúng → khách đã nhận lượt trước đó → chuyển tới "DaNhanLuot", không cộng lượt nữa.

Thẻ 3 — Note:

Thẻ bên dưới để thêm 1 lượt quay.

Thẻ 4 — Lucky Wheel / Add Turn Number:

• Chọn Vòng quay đã tạo sẵn.
• Số lượt cộng: 1

Thẻ 5 — Note:

Thẻ bên dưới để ghi nhận KH đã nhận lượt chơi. Nếu họ có bấm nút Mở khoá vòng quay lần nữa thì thẻ trên cùng của block này sẽ từ chối cộng lượt quay.

Thẻ 6 — Set Attributes:

• Attribute: luot_choi = Da_Nhan

💡 Cách chống gian lận: Lần đầu khách vào block này, attribute luot_choi chưa có giá trị → điều kiện luot_choi = Da_Nhan sai → Go to Block bị bỏ qua → cộng lượt + set luot_choi = Da_Nhan. Lần sau nếu khách bấm lại nút "Mở khoá Vòng quay" → luot_choi = Da_Nhan đúng → chuyển tới "DaNhanLuot" mà không cộng lượt.

Thẻ 7 — Messenger Gallery:

• Tỷ lệ ảnh: Vuông (square)
• Ảnh: Hình banner minigame / hình vòng quay
• Tiêu đề: Bạn có 1 lượt quay
• Phụ đề: Bấm nút bên dưới để quay ngay nhé! 👇
• Button: 🎰 QUAY NGAY! → Webview: Lucky Wheel
  • Loại: LUCKY_WHEEL
  • Chọn Vòng quay đã tạo
  • Block nhận quà (Receiving): "NhanQua"

---

Phần 4 — Block "DaNhanLuot" (đã nhận lượt quay rồi):

Thẻ 1 — Messenger Text:

Ôi, [=GENDER("anh","chị","bạn")] {{name}} đã nhận lượt quay rồi! 😊

Hãy chia sẻ bài viết minigame lên tường và tag thêm bạn bè để họ cũng có cơ hội nhận lượt quay! 🔥

Ghé Fanpage thường xuyên để không bỏ lỡ ưu đãi nào nhé! 🛒

---

Phần 5 — Block "NhanQua" (nhận kết quả sau khi quay):

Block này tự động chạy sau khi khách quay xong Vòng quay may mắn (được gọi qua cấu hình block_receiving trong Webview Lucky Wheel).

Thẻ 1 — Messenger Text (thông báo kết quả):

🎊 Chúc mừng {{name}}!

[=GENDER("Anh","Chị","Bạn")] thật may mắn!
[=GENDER("Anh","Chị","Bạn")] đã trúng {{qua_tang}} tại {{page_name}}! 💰🔥

Thẻ 2 — Messenger Typing: Delay 2.6 giây (tạo hiệu ứng tự nhiên).

Thẻ 3 — Messenger User Input (thu thập SĐT):

• Loại: phone-suggestion (hiển thị gợi ý SĐT có sẵn trên Messenger)
• Lưu vào attribute: phone
• Câu hỏi: [=GENDER("Anh","Chị","Bạn")] vui lòng nhập số điện thoại để mình gửi quà tặng nhé! 📱
• Số lần hỏi lại nếu sai: 5
• Thông báo lỗi tuỳ chỉnh: ⚠️ Hmm, có vẻ số điện thoại chưa đúng rồi! [=GENDER("Anh","Chị","Bạn")] vui lòng nhập lại số điện thoại (10 số, bắt đầu bằng 0) nhé! 📱
• Timeout: 1 giờ

Thẻ 4 — Messenger Text (xác nhận SĐT):

✅ Cảm ơn [=GENDER("anh","chị","bạn")]! Em đã ghi nhận số điện thoại {{phone_number}}.

Em sẽ gửi ngay mã quà tặng cho [=GENDER("anh","chị","bạn")] nhé! 🎁

Thẻ 5 — Messenger Typing: Delay 2.6 giây.

Thẻ 6 — Time Calculator (tính ngày hết hạn voucher):

• Định dạng ngày: DD/MM/YYYY
• Giá trị ngày: [=TIMENOW({{timezone}},"DD/MM/YYYY")] (ngày hiện tại)
• Hành động: Cộng thêm 30 ngày
• Lưu kết quả vào attribute: ngay_het_han

💡 Ý nghĩa: Lấy ngày khách quay trúng thưởng + 30 ngày = ngày hết hạn voucher. Bạn có thể thay 30 bằng số ngày phù hợp với chiến dịch.

Thẻ 7 — Messenger Text (gửi mã voucher):

🎁 ĐÂY LÀ MÃ {{qua_tang}} của [=GENDER("anh","chị","bạn")]
- MÃ: {{pid}}

💡 {{pid}} là mã duy nhất (unique ID) được Smax.AI tự sinh cho mỗi Subscriber — dùng làm mã voucher cá nhân hoá, đảm bảo không trùng lặp.

Thẻ 8 — Messenger Text (thông tin quà tặng đầy đủ):

📋 Thông tin quà tặng:
👤 Người nhận: {{name}}
📱 SĐT: {{phone}}
🎟️ Mã: {{pid}}
💰 Giá trị: {{qua_tang}}
⏰ Hạn sử dụng: {{ngay_het_han}}
--------------
📌 Hướng dẫn sử dụng:
1️⃣ Chọn sản phẩm yêu thích tại {{page_name}}
2️⃣ Nhắn tin cho Fanpage kèm mã giảm giá khi đặt hàng
3️⃣ Được áp dụng giảm giá trực tiếp trên đơn hàng!

💡 Mã chỉ sử dụng được 1 lần. Hãy dùng ngay trước khi hết hạn nhé!

Thẻ 9 — Google Sheet (lưu kết quả ra bảng tính):

• Loại: Lưu dữ liệu lên Sheet (save_data_to_sheet)
• Các cột dữ liệu:

---

Hướng dẫn thao tác từng bước trên Smax.AI

Bước 1: Tạo Vòng quay may mắn (Lucky Wheel)

1. Vào module Game → Nhấn Tạo mới → Chọn Vòng quay may mắn.
2. Thiết lập các giải thưởng (ví dụ):

1. Tuỳ chỉnh giao diện vòng quay (màu sắc, logo thương hiệu).
2. Lưu và ghi nhớ tên Vòng quay để chọn trong các bước sau.

💡 Xem hướng dẫn chi tiết tại Kết nối Chatbot với Lucky Wheel.

Bước 2: Đăng bài viết minigame

1. Đăng bài trên Fanpage (tham khảo bài viết mẫu ở trên).
2. Thêm hashtag chiến dịch: #spin và/hoặc #vongquay.
3. Đính kèm hình ảnh bắt mắt (mockup vòng quay, banner giải thưởng).
4. Đặt bài viết ở chế độ Công khai.

Bước 3: Lấy ID bài viết

1. Dùng tài khoản Admin comment một nội dung bất kỳ vào bài viết.
2. Vào Smax.AI → Module Nhắn tin → Chọn Page → Lọc Bình luận.
3. Tìm comment vừa tạo → Nhấn mũi tên xem chi tiết → Copy #ID → Bỏ chữ fb ở đầu.

Bước 4: Tạo các Block trước

Tạo trước tất cả Block cần dùng (để có thể liên kết với nhau khi thiết lập):

💡 Tạo trước block rỗng, sau đó quay lại chỉnh sửa nội dung từng block ở các bước tiếp theo.

Bước 5: Tạo Trigger Comment

1. Vào Bot-Auto → Nhấn + Tạo mới trigger → Chọn Comment.
2. Cấu hình:

① Tên Trigger: Game - Tag 2 bạn quay Vòng quay

② Áp dụng trên kênh: Chọn Page chứa bài viết minigame.

③ Phạm vi bài viết: Chọn "Hashtag" → Nhập #spin và #vongquay.

💡 Dùng Hashtag thay vì "Bài viết cụ thể" giúp bạn tái sử dụng trigger cho nhiều bài minigame — chỉ cần thêm hashtag #spin khi đăng bài mới.

④ Điều kiện kích hoạt:

⑤ Lưu số tag (QUAN TRỌNG):

• ☑️ Bật "Lưu số tag"
• Tên attribute: so_tag

⑥ Lưu thêm các attribute:

⑦ Tương tác cơ bản:

• ☑️ Thích bình luận: Bật
• ☐ Ẩn bình luận: Tắt — comment cần hiển thị để người được tag nhìn thấy.

⑧ Thời gian delay: Không delay (= 0 giây, phản hồi ngay) hoặc tối đa 20 giây.

⑨ Số tin trả lời mỗi phút: 60 tin/phút (minigame cần phản hồi nhanh, tránh khách mất kiên nhẫn).

⑩ Hành động gửi Inbox: Chọn "Gửi Block" → Chọn Block "KiemTraTag".

⚠️ Quan trọng: KHÔNG thiết lập trả lời comment trực tiếp trong Trigger. Trigger chỉ gửi Inbox tới Block "KiemTraTag" — toàn bộ logic rẽ nhánh, trả lời comment, và gửi Messenger được xử lý trong Block.

Bước 6: Thiết lập Block "KiemTraTag"

1. Mở Block "KiemTraTag" → Nhấn Chỉnh sửa.
2. Kéo thêm các thẻ theo thứ tự:

1. Nhấn Lưu.

Bước 7: Thiết lập Block "ChuaDuTag"

1. Mở Block "ChuaDuTag" → Nhấn Chỉnh sửa.
2. Kéo thêm:

1. Nhấn Lưu.

Bước 8: Thiết lập Block "VongQuay"

1. Mở Block "VongQuay" → Nhấn Chỉnh sửa.
2. Kéo thêm:

1. Nhấn Lưu.

Bước 9: Thiết lập Block "DaNhanLuot"

1. Mở Block "DaNhanLuot" → Nhấn Chỉnh sửa.
2. Kéo thêm thẻ Messenger Text → Nhập nội dung thông báo đã nhận lượt (xem Phần 4).
3. Nhấn Lưu.

Bước 10: Thiết lập Block "NhanQua"

1. Mở Block "NhanQua" → Nhấn Chỉnh sửa.
2. Kéo thêm các thẻ theo thứ tự:

1. Nhấn Lưu.

Bước 11: Lưu và Kích hoạt

1. Quay lại màn hình Trigger → Nhấn Lưu.
2. Đảm bảo Trigger đã Bật (toggle xanh).

Bước 12: Kiểm tra hoạt động

Dùng tài khoản cá nhân khác (không phải admin) để test lần lượt:

Test 1 — Chưa đủ tag:

1. Comment vào bài viết, tag 1 người hoặc không tag ai.
2. ✅ Bot trả lời comment nhắc tag thêm?
3. ✅ Messenger gửi tin nhắn hướng dẫn + nút "Vào bài viết"?

Test 2 — Đủ tag:

1. Comment vào bài viết, tag 2 người trở lên.
2. ✅ Bot like comment?
3. ✅ Bot trả lời comment xác nhận?
4. ✅ Messenger gửi tin nhắn + nút "🔓 Mở khoá Vòng quay"?
5. Bấm nút → ✅ Vòng quay hiện đúng trong Webview?
6. Quay xong → ✅ Thông báo kết quả trúng thưởng?
7. ✅ Hỏi SĐT → Nhập → Xác nhận?
8. ✅ Gửi mã voucher + thông tin đầy đủ?
9. ✅ Kiểm tra Google Sheets — dữ liệu đã được ghi?

Test 3 — Chống trùng lượt:

1. Bấm lại nút "🔓 Mở khoá Vòng quay" lần 2.
2. ✅ Bot thông báo đã nhận lượt rồi (không cộng thêm lượt)?

---

Tổng hợp Attributes sử dụng

---

Biến thể kịch bản theo ngành

---

Phễu chuyển đổi sau minigame

Bước 1: Minigame Vòng Quay (Kịch bản này)
    │  → Thu thập SĐT + Subscriber
    ▼
Bước 2: Nhắn nhở sử dụng voucher (sau 2-3 ngày)
    "{{name}} ơi, mã {{qua_tang}} của
     [=GENDER("anh","chị","bạn")] sắp hết hạn rồi!
     Dùng ngay kẻo lỡ nhé!"
    │
    ▼
Bước 3: Gợi ý sản phẩm (sau 5-7 ngày)
    "Em có mấy sản phẩm hot đang sale mạnh,
     [=GENDER("anh","chị","bạn")] xem thử nha!"
    │
    ▼
Bước 4: Minigame tiếp theo / Ưu đãi VIP (sau 14+ ngày)
    "Minigame mới dành riêng cho khách cũ!
     Quay lại nhận thêm ưu đãi!"
    │
    ▼
Bước 5: Chốt đơn / Khách hàng trung thành

---

Tham khảo thêm

• Trigger Comment — Cấu hình chi tiết Trigger Comment.
• Go to Block — Thẻ Go to Block với bộ lọc điều kiện.
• Lucky Wheel / Add Turn Number — Cộng lượt quay cho game.
• Set Attributes — Tạo và gán giá trị attribute.
• Time Calculator — Tính toán ngày tháng.
• Messenger Gallery — Gửi Gallery với Webview.
• Google Sheet — Lưu/đọc dữ liệu Google Sheets.
• Bộ lọc nâng cao — Phân loại khách theo attribute.
• Kết nối Chatbot với Lucky Wheel — Thiết lập Vòng quay may mắn.