• 28/06 cập nhật đăng ký đăng nhập qua Google & Facebook

Hướng dẫn chuyển từ MESSAGE_TAG sang Utility Message (sau 10/02/2026)

TenHoshi

Administrator
Staff member
Trusted Uploader
image.png

1. Bối cảnh​

Từ 10/02/2026, Meta ngừng hỗ trợ các Message Tag như:
  • CONFIRMED_EVENT_UPDATE
  • ACCOUNT_UPDATE
  • POST_PURCHASE_UPDATE
Việc gửi tin ngoài 24h bằng: messaging_type = MESSAGE_TAG sẽ lỗi outside allowed window.
Giải pháp thay thế chính thức là:
Utility Message (category = UTILITY)

2. So sánh cơ chế cũ và mới​

Cơ chế cũCơ chế mới
messaging_type = MESSAGE_TAGmessaging_type = UTILITY
Không cần templateBắt buộc dùng template
Gửi trực tiếp nội dungGửi theo mẫu đã duyệt
Dễ vi phạm policyKiểm soát nội dung qua template

3. Kiến trúc hệ thống mới​

Hệ thống được chia làm 2 phần:

A. Quản lý Template​

Chịu trách nhiệm:
  • Tìm mẫu của Meta
  • Clone mẫu
  • Tạo template riêng của Page
  • Kiểm tra template đã tồn tại chưa

B. Gửi Tin Nhắn​

Chịu trách nhiệm:
  • Gửi tin theo template UTILITY
  • Build parameters
  • Wrapper gửi theo từng loại thông báo

4. Quy trình chuyển đổi​

Bước 1 – Tạo Template (chỉ làm 1 lần)​

Trước đây: Gửi trực tiếp nội dung + tag
Bây giờ:
  1. Tạo template UTILITY
  2. Chờ status APPROVED
  3. Lưu name template vào hệ thống
Bạn có thể:
  • Clone template từ Meta
  • Hoặc tạo template riêng
Khuyến nghị:
Tạo Page-owned template để chủ động nội dung

Bước 2 – Thay đổi logic gửi tin​

Trước đây:​


if (ngoai_24h) {
send MESSAGE_TAG
}

Bây giờ:​


if (ngoai_24h && la_thong_bao_giao_dich) {
send UTILITY template
}

Không còn gửi nội dung thuần text ngoài 24h.

5. Cách sử dụng hệ thống mới​

5.1 Tạo template​

Chạy một lần khi deploy
Hoặc tạo từng template riêng.

Sau khi tạo thành công:
  • Template có status = APPROVED
  • Lưu lại template name

5.2 Gửi tin nhắn​

Thay vì gửi text + tag, gọi wrapper function:

send_utility_xxx(...)

Các wrapper này:
  • Tự build parameters
  • Tự gọi send_utility_message
  • Tự format components

6. Cấu trúc Template​

Template UTILITY gồm:
  • HEADER (tuỳ chọn)
  • BODY (bắt buộc)
  • BUTTON (tuỳ chọn)
Biến phải theo format:
{{1}}
{{2}}

Quy tắc:
  • Không được thiếu số
  • Không được nhảy số
  • Không bắt đầu hoặc kết thúc bằng biến

7. Các lỗi thường gặp khi chuyển đổi​

1. Template bị reject​

Nguyên nhân:
  • Có yếu tố marketing
  • Format biến sai
  • Quá nhiều biến so với nội dung

2. Gửi không thành công​

Kiểm tra:
  • Template đã APPROVED chưa
  • messaging_type có phải UTILITY không
  • recipient PSID đúng chưa
  • Đã có permission page_utility_messaging chưa

8. Những nội dung được phép gửi bằng Utility​

✔ Cập nhật trạng thái giao dịch
✔ Cập nhật tài khoản
✔ Nhắc lịch hẹn
✔ Thông báo thay đổi liên quan đến dịch vụ

9. Những nội dung không được phép​

✘ Khuyến mãi
✘ Giảm giá
✘ Upsell
✘ Kêu gọi mua lại

Nếu nội dung mang tính marketing → phải dùng Marketing Message (có opt-in).

10. Chiến lược migration an toàn​

  1. Tạo toàn bộ template trước
  2. Deploy song song logic mới
  3. Bật flag chuyển dần từ MESSAGE_TAG → UTILITY
  4. Log lại các lỗi gửi tin
  5. Tắt hoàn toàn MESSAGE_TAG ngoài 24h

11. Kết luận​

Sau 10/02/2026:
  • Không còn dùng MESSAGE_TAG ngoài 24h
  • Bắt buộc dùng UTILITY template cho thông báo giao dịch
  • Hệ thống phải chuyển sang model “template-based messaging”
  • Nội dung được kiểm soát chặt hơn theo policy Meta
 

Guest Post 2022

Top