Mẫu tin nhắn

Bạn cần dùng mẫu tin nhắn để bắt đầu cuộc trò chuyện về marketing, tiện ích và xác thực. Những cuộc trò chuyện này có thể là tin nhắn chăm sóc khách hàng hoặc lời nhắc cuộc hẹn, thông tin cập nhật về thanh toán hoặc vận chuyển, thông báo và hơn thế nữa.

Yêu cầu

• Mẫu tin nhắn phải được phê duyệt thì mới có thể dùng để bắt đầu cuộc trò chuyện. Tìm hiểu thêm.
• Khách hàng phải chọn nhận tin nhắn từ doanh nghiệp bạn thì bạn mới có thể bắt đầu cuộc trò chuyện về marketing, tiện ích và xác thực với khách hàng đó. Tìm hiểu thêm.

Hạng mục mẫu được hỗ trợ

Hãy xem phần Hạng mục.

Dịch thuật

Khi gửi mẫu tin nhắn, bạn cần chỉ định ngôn ngữ bằng trường language. Doanh nghiệp của bạn chịu trách nhiệm cung cấp mọi bản dịch mà bạn muốn sử dụng.

Ngôn ngữ được hỗ trợ

Gói ngôn ngữ

Mẫu tin nhắn được lưu trữ trong các gói ngôn ngữ. Gói ngôn ngữ là một nhóm gồm các thành phần mẫu tin nhắn của một ngôn ngữ/địa phương cụ thể. Nếu doanh nghiệp hỗ trợ ít nhất một bản dịch cho ngôn ngữ/địa phương nào đó, gói cho ngôn ngữ/địa phương đó sẽ được tạo.

Vùng tên mẫu tin nhắn là một nhóm gồm các gói ngôn ngữ của một doanh nghiệp cụ thể.

Tùy chọn chính sách ngôn ngữ

Nếu bạn gửi một mẫu tin nhắn khi trường language: policy được đặt là giá trị mặc định deterministic, WhatsApp sẽ gửi mẫu tin nhắn này bằng chính ngôn ngữ và địa phương được yêu cầu. Sau đó, thiết bị sẽ truy vấn máy chủ để biết gói ngôn ngữ của ngôn ngữ cụ thể đó.

Khi nhận được tin nhắn này, thiết bị sẽ làm như sau:

• Kiểm tra chính sách/mã - Trong "policy": "deterministic" và "code": "en", có gói en nào được lưu vào bộ nhớ đệm trên thiết bị không?

  • Nếu có, thiết bị sẽ chuyển sang Kiểm tra thành phần.
  • Nếu không, có thể tìm thấy gói en trên máy chủ không?

    • Nếu có, thiết bị sẽ cập nhật bộ nhớ đệm trên thiết bị rồi chuyển sang Kiểm tra thành phần.
    • Nếu không, thiết bị sẽ ghi lỗi structure_unavailable mà máy chủ trả về qua Webhook vào nhật ký và sẽ không có tin nhắn nào hiển thị trên thiết bị.

• Kiểm tra thành phần - Thành phần "element": "hello_world" có tồn tại không?

  • Nếu có, thiết bị sẽ giải nén các thông số và hiển thị tin nhắn trên thiết bị.
  • Nếu không:

    • Nếu gói ngôn ngữ nằm trong bộ nhớ đệm trên thiết bị, thiết bị sẽ tải gói en mới nhất xuống từ máy chủ rồi thực hiện lại bước Kiểm tra thành phần.
    • Nếu gần đây bạn đã tải gói ngôn ngữ xuống từ máy chủ, thiết bị sẽ ghi lỗi structure_unavailable mà máy chủ trả về qua Webhook vào nhật ký và sẽ không có tin nhắn nào hiển thị trên thiết bị.

Cài đặt ngôn ngữ/địa phương trên thiết bị sẽ bị bỏ qua hoàn toàn.

Nếu nội dung bạn yêu cầu không tồn tại thì có thể phát sinh sự cố khi sử dụng chính sách deterministic. Hãy đảm bảo:

• Vùng tên chính xác
• Tên thành phần chính xác
• Có bản dịch ngôn ngữ/địa phương cho thành phần đó
• Số lượng thông số được gửi khớp với số lượng mà bạn chỉ định trong mẫu tin nhắn

Bản địa hóa

Mẫu tin nhắn hỗ trợ tính năng bản địa hóa có thể dùng ngay bằng cách bản địa hóa tin nhắn theo cài đặt ngôn ngữ trên thiết bị.

Thông số có thể bản địa hóa

Mẫu có các thông số sẽ tự động được đưa vào tin nhắn. Đối với ví dụ trong tài liệu này, mẫu tin nhắn sẽ có dạng như sau:

"You made a purchase for {{1}} using a credit card ending in {{2}}."

Đối với "namespace": "cdb2df51_9816_c754_c5a4_64cdabdcad3e" có "element_name": "purchase_with_credit_card", giá trị đầu tiên mà bạn liệt kê sẽ thay thế biến {{1}} trong tin nhắn mẫu, còn giá trị thứ hai mà bạn liệt kê sẽ thay thế biến {{2}}.

Một số thông số sau đây (ví dụ: date_time hoặc currency) có thể được bản địa hóa để hiển thị phù hợp theo tùy chọn ngôn ngữ và địa phương của người dùng. Nếu không bản địa hóa được thông số, thiết bị sẽ đặt mặc định là fallback_value.

Nếu bạn cần chỉ định đơn vị tiền tệ và ngày ngoài fallback_value, hãy sử dụng các đối tượng currency và date_time. Nhờ đó, ứng dụng có thể bản địa hóa dữ liệu một cách tối ưu theo phương thức phù hợp nhất và chỉ đặt mặc định là fallback_value khi không bản địa hóa được dữ liệu.

Các tùy chọn localizable_params được trình bày trong bảng bên dưới:

Thông số

Đối tượng currency

Ứng dụng API WhatsApp Business sẽ tìm cách định dạng đơn vị tiền tệ theo cài đặt bản địa hóa đã chỉ định.

Ví dụ

{
    "type": "currency",
    "currency" : {
        "fallback_value": "$230.99",
        "code": "USD",
        "amount_1000": 230990
    }
}  

Đối tượng date_time

Ứng dụng API WhatsApp Business sẽ tìm cách định dạng ngày/giờ theo cài đặt bản địa hóa đã chỉ định. Định dạng ngày và giờ được hỗ trợ bao gồm:

• Thời gian thành phần - Thời gian được thu thập từ các thành phần (tức là ngày trong tuần, tháng, giờ, v.v.) Thời gian được chỉ định sẽ giống nhau, bất kể múi giờ của ứng dụng.
• Thời gian Unix - Thời gian sẽ hiển thị phụ thuộc vào múi giờ của ứng dụng.

DateTime

DateTimeComponent

Ví dụ

{
    "type": "date_time",
    "date_time" : {
        "fallback_value": "October 25, 2020",
        "day_of_week": "Saturday",
        "day_of_month": 25,
        "year": 2020,
        "month": 10,
        "hour": 12,
        "minute": 0
    }
}

DateTimeUnixEpoch

Bước tiếp theo

Tài liệu này cung cấp thông tin tham khảo về các mẫu tin nhắn. Để biết hướng dẫn về cách tạo và gửi mẫu, hãy xem phần Gửi mẫu tin nhắn. Để biết toàn bộ thông số mà bạn có thể dùng trong mẫu tin nhắn, hãy xem phần Tin nhắn, Mẫu tin nhắn.

https://developers.facebook.com/docs/whatsapp/message-templates/creation#step-1--create-template-using-the-whatsapp-manager