Tin nhắn marketing

(Còn được gọi là Thông báo định kỳ)

Tài liệu này hướng dẫn bạn cách yêu cầu người dùng cấp quyền để gửi tin nhắn marketing (còn gọi là Thông báo định kỳ), giới thiệu về các yêu cầu và giới hạn cụ thể đối với việc gửi yêu cầu, cũng như cách tạo và gửi yêu cầu cấp quyền đối với tin nhắn marketing.

Tổng quan

Với Tin nhắn marketing, Trang Facebook hoặc Tài khoản công việc trên Instagram có thể gửi tin nhắn ngoài khoảng thời gian nhắn tin tiêu chuẩn cho những người đã cho phép bạn làm như vậy. Tin nhắn marketing sẽ hỗ trợ bạn xây dựng mối quan hệ với những người quan tâm đến bạn hoặc doanh nghiệp của bạn.

Tin nhắn marketing là tính năng cao cấp mới và không bắt buộc mà chúng tôi dự định tính phí trong tương lai. Chúng tôi hiện đang tính phí các doanh nghiệp gửi tin nhắn từ API WhatsApp Business, đồng thời lắng nghe ý kiến đóng góp của khách hàng để định hướng các quyết định về mô hình giá của mình. Chúng tôi sẽ thông báo trước sớm cho khách hàng và đối tác về bất kỳ thay đổi nào đối với bản dùng thử miễn phí.

Yêu cầu

• Bạn phải tuân thủ tất cả Chính sách dành cho nhà phát triển được áp dụng khi sử dụng Tin nhắn marketing hoặc các tính năng khác của Nền tảng Messenger

• Bạn chỉ có thể gửi yêu cầu cho người dùng để chọn nhận Tin nhắn marketing trong khoảng thời gian nhắn tin tiêu chuẩn. Khi một người dùng chọn nhận Tin nhắn marketing, hành động này sẽ không mở ra khoảng thời gian nhắn tin tiêu chuẩn

• Ứng dụng và/hoặc trải nghiệm nhắn tin của bạn không được có quá nhiều phản hồi tiêu cực từ người dùng. Tính năng nhắn tin có thể bị hạn chế hoặc bị gỡ nếu chúng tôi xác định rằng trải nghiệm nhắn tin của ứng dụng nhận được quá nhiều ý kiến đóng góp tiêu cực từ người dùng

• Bạn không được dùng Tin nhắn marketing - kể cả yêu cầu đồng ý - để spam người dùng. Trong đó có việc gửi các yêu cầu chọn nhận trùng lặp với tần suất cao cho cùng một người dùng hoặc nhiều người dùng, cũng như các loại spam khác theo định nghĩa trong Chính sách dành cho nhà phát triển của chúng tôi

• Bạn phải tuân theo những giới hạn mà chúng tôi đã đặt ra đối với chức năng của Nền tảng Messenger và Tin nhắn marketing để duy trì phạm vi dịch vụ mà chúng tôi đang cung cấp cho bạn

Giới hạn

• Mỗi tuần, bạn chỉ có thể gửi một yêu cầu chọn nhận cho một người, với cùng một tiêu đề cụ thể. Giới hạn này bao gồm cả giá trị mặc định là "Thông tin mới và khuyến mãi".
• Không gửi yêu cầu chọn nhận trùng lặp cho một người. Yêu cầu chọn nhận trùng lặp được định nghĩa là có cùng title cho thông báo từ Trang Facebook hoặc cùng title và image_url cho thông báo từ Tài khoản công việc trên Instagram
• Bạn chỉ có thể gửi yêu cầu đồng ý trong khoảng thời gian nhắn tin tiêu chuẩn
• Nếu một người chọn nhận tin nhắn marketing, hành động này sẽ không bắt đầu khoảng thời gian nhắn tin tiêu chuẩn
• Bạn chỉ có thể xem liệu một người đã chọn nhận tin nhắn marketing hay chưa, chứ không thể xem trạng thái của những yêu cầu đồng ý đang chờ
• Nếu người dùng đã chọn dừng nhận tin nhắn marketing, thông báo của bạn sẽ không còn được phân phối đến người đó nữa và bạn sẽ nhận được thông báo lỗi
• Một người có thể chặn, tắt hoặc báo cáo tin nhắn của bạn
• Đối với tin nhắn marketing được gửi từ một tài khoản Công việc trên Instagram, thông thường, bạn có thể gửi tối đa 10 yêu cầu đồng ý với tiêu đề khác nhau cho mỗi người dùng trong khoảng thời gian 7 ngày. Ngoài ra, còn có giới hạn phụ là bạn có thể gửi tối đa 5 yêu cầu chọn nhận cho một người dùng trong một ngày. Tuy nhiên, trước khi gửi, bạn nên cân nhắc xem người dùng có khả năng sẽ thấy từng yêu cầu chọn nhận là phù hợp và có giá trị hay không.

Những yêu cầu và giới hạn này có thể thay đổi vì chúng tôi luôn cố gắng mang lại trải nghiệm tốt nhất cho người dùng và doanh nghiệp.

Cách làm tốt nhất

Để tạo ra trải nghiệm người dùng chất lượng cao, bạn nên gửi cho mọi người Tin nhắn marketing phù hợp, có giá trị bằng cách thực hiện những việc sau:

• Yêu cầu chọn nhận của bạn (bao gồm cả tiêu đề và hình ảnh) chứa các loại Tin nhắn marketing mà người dùng có thể sẽ nhận được, chẳng hạn như thông tin mới về đơn đặt hàng, đề xuất sản phẩm hoặc các ưu đãi nhất định

• Khi gửi nhiều yêu cầu chọn nhận cho người dùng, mỗi yêu cầu chọn nhận cần nêu rõ các loại Tin nhắn marketing cụ thể, khác nhau mà người dùng có thể sẽ nhận được

Tin nhắn marketing nên phù hợp và được điều chỉnh cho các trường hợp sử dụng mà người dùng có khả năng sẽ thấy có giá trị.

Người dùng có thể đóng góp ý kiến về trải nghiệm nhắn tin, kể cả việc chặn tin nhắn của bạn. Điều này có thể dẫn đến việc bạn bị hạn chế sử dụng Tin nhắn marketing. Bạn nên thường xuyên xem lại các yêu cầu chọn nhận và Tin nhắn marketing để xem có đáp ứng những cách làm tốt nhất ở trên hay không.

Thời gian tạm dừng gửi tin nhắn

Chúng tôi áp dụng thời gian tạm dừng gửi tin nhắn bằng subscription_token là 24 giờ. Nghĩa là tin nhắn marketing được gửi bằng cùng một subscription_token sẽ yêu cầu khoảng thời gian 24 giờ giữa các lần gửi.

Kể từ ngày 01/09/2025, thời gian tạm dừng gửi tin nhắn bằng subscription_token sẽ thay đổi từ cho phép gửi một lần trong mỗi 24 giờ thành gửi một lần trong mỗi 48 giờ cho mỗi người đăng ký.

Áp dụng cho mã tin nhắn thông báo được tạo trước ngày 02/02/2023.

• Sau khi một người chọn nhận, bạn có thể gửi tin nhắn cho người đó theo tần suất hàng ngày, hàng tuần hoặc hàng tháng, tùy thuộc vào tần suất mà người đó đã chọn khi chọn nhận tin nhắn.

Yêu cầu cấp quyền để gửi tin nhắn marketing

Một người phải cấp quyền chọn nhận để nhận tin nhắn marketing từ Trang Facebook hoặc tài khoản Công việc trên Instagram của bạn. Nền tảng Messenger cung cấp cho bạn nhiều cách để yêu cầu chọn nhận. Bạn có thể tích hợp yêu cầu chọn nhận vào các trải nghiệm nhắn tin sau đây:

• Quảng cáo click đến Messenger - khi một người nhấp vào quảng cáo của bạn
• Plugin Ô để đánh dấu - khi một người nhấp vào ô để đánh dấu trong mục người gửi và gửi mẫu
• Liên kết m.me - khi một người nhấp vào liên kết m.me trên trang web, email, bài viết trên mạng xã hội, v.v. của bạn
• Tin trả lời riêng tư - khi một người đăng bài viết của khách truy cập hoặc bình luận lên Trang Facebook của doanh nghiệp
• Mã QR - khi một người quét Mã QR trên màn hình kỹ thuật số và bản in (được Liên kết m.me hỗ trợ)
• Plugin Gửi đến Messenger - khi một người bắt đầu cuộc trò chuyện bằng cách dùng danh sách nút CTA hoặc văn bản xác định trước

Yêu cầu đồng ý mẫu

Để gửi yêu cầu chọn nhận tin nhắn marketing, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages và đặt loại mẫu tin nhắn thành notification_messages. ID Trang là ID của Trang Facebook bạn sở hữu hoặc Trang Facebook liên kết với tài khoản Công việc trên Instagram của bạn.

Lưu ý:title là thông số bắt buộc đối với tin nhắn marketing chứa thẻ quay vòng từ Trang Facebook hoặc Tài khoản công việc trên Instagram .

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"PSID-OR-IGSID"
  },
  "message":{
    "attachment":{
      "type":"template", 
      "payload":{
         "template_type":"notification_messages", 
         "notification_messages_timezone": "UTC",
         "title":"TITLE",
         "image_url":"IMAGE-URL",
         "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa ID người nhận và tin nhắn.

{ 
        "recipient": {
          "id":"PSID-OR-IGSID",
          "message_id":"MESSAGE-ID",
}

Tài liệu tham khảo về đối tượng file đính kèm của tin nhắn

Đối tượng JSON messageattachment phải được đưa vào yêu cầu POST đến điểm cuối /PAGE-ID/messages của yêu cầu đồng ý nhận tin nhắn marketing.

Mã tin nhắn thông báo

Sau khi người dùng chọn nhận thông báo, doanh nghiệp bạn sẽ nhận được thông báo webhook messaging_optin kèm theo mã tin nhắn thông báo và các thông tin như tiêu đề tin nhắn và múi giờ của người chọn nhận. Bạn có thể dùng mã tin nhắn thông báo để gửi tin nhắn marketing cho người đó.

Thông báo webhook chọn nhận

{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
      "payload": "ADDITIONAL-WEBHOOK-INFORMATION",
      "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
      "notification_messages_timezone": "TIMEZONE-ID",
      "token_expiry_timestamp": "TIMESTAMP",
      "user_token_status": "TOKEN-STATUS"  
      "notification_messages_status": "MESSAGE-STATUS", 
      "title": "TITLE-FOR-THE-NOTIFICATION"
    }
}

Ngày hết hạn của mã sẽ được gia hạn cho những người chọn tiếp tục nhận tin nhắn marketing. Bất cứ lúc nào mọi người cũng có thể chọn không nhận tin nhắn marketing.

Tin nhắn trao đổi thêm cho trường hợp chọn nhận

Sau khi một người chọn nhận tin nhắn marketing, bạn có thể gửi tối đa 3 tin nhắn trao đổi thêm. Bạn phải gửi những tin nhắn này trong vòng 2 phút kể từ tin nhắn trao đổi thêm đầu tiên. Tin nhắn trao đổi thêm thứ hai và thứ ba không được vượt quá 250 ký tự. Bạn có thể gửi những tin nhắn trao đổi thêm này ngoài khoảng thời gian nhắn tin 24 giờ tiêu chuẩn.

Để gửi tin nhắn trao đổi thêm, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với đối tượng recipient chứa mã tin nhắn thông báo và đối tượng message chứa nội dung tin nhắn trao đổi thêm. Yêu cầu API của cả 3 tin nhắn trao đổi thêm có cú pháp giống nhau.

Yêu cầu mẫu

curl -X POST -H "Content-Type: application/json" -d 
    '{ 
        "recipient":{ 
            "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN" 
        }, 
        "message":{ 
            "text":FOLLOWUP-MESSAGE-TEXT-HERE, 
        } 
    }' 
"https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=TOKEN"

Lấy danh sách mã

Để lấy danh sách tất cả mã tin nhắn thông báo hợp lệ, hãy gửi yêu cầu GET đến điểm cuối /PAGE-ID/notification_message_tokens.

Yêu cầu mẫu

curl -i -X GET "https://graph.facebook.com/API-VERSION-NUMBER/PAGE-ID/notification_message_tokens
    ?access_token=PAGE-ACCESS-TOKEN"

Hệ thống sẽ trả về danh sách có tối đa 25 mã theo mặc định. Các mã được sắp xếp theo thời gian cập nhật. Để đọc thêm, bạn có thể thêm thông số limit. Hiện tại, hệ thống có thể trả về tối đa 100 mã. Bạn có thể sử dụng thông số after để phân trang. Tuy nhiên, thông số before không dùng được.

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa mã, ID người nhận, ID trong Instagram hoặc ID trong Trang, thời gian tạo mã, tiêu đề thông báo và thời gian bạn có thể gửi tin nhắn marketing tiếp theo cho người nhận đó.

{
  "data":[
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-1",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-1",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    },
...
    {
      "notification_messages_token":"NOTIFICATION-MESSAGE-TOKEN-ID-25",
      "recipient_id":"PAGE-OR-INSTAGRAM-SCOPED-ID-25",
      "notification_messages_reoptin":"RE-OPT-IN-STATUS",
      "creation_timestamp":TIMESTAMP,
      "token_expiry_timestamp":UNIX-TIMESTAMP-EXPIRATION-DATE,
      "user_token_status":"TOKEN-STATUS",
      "topic_title":"NOTIFICATION-TITLE",
      "notification_messages_timezone":"TIMEZONE-ID",
      "next_eligible_time": TIMESTAMP
    }
  ],
  "paging":{"cursors":{"before":"QVFIU...","after":"QVFIU..."},"next":"https:\/\/graph.facebook.com\/LATEST-API-VERSION\/PAGE-ID\/notification_message_tokens?access_token=PAGE-ACCESS-TOKEN"}
}

Lấy thông tin mã

Mặc dù chúng tôi khuyên dùng webhook messaging_optin để thu thập thông tin về tin nhắn marketing, nhưng bạn có thể gửi yêu cầu GET đến điểm cuối mã. Trong đó, mã của bạn sẽ được thêm vào notification_messages_, notification_messages_NOTIFICATION-MESSAGES-TOKEN để lấy thông tin về mã.

Yêu cầu mẫu

curl -i -X GET "https://graph.facebook.com/LATEST-API-VERSION/notification_messages_NOTIFICATION-MESSAGES-TOKEN
    ?access_token=PAGE-ACCESS-TOKEN"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa mã tin nhắn thông báo, ID của người nhận tin nhắn và thông tin khác về mã. Bạn sẽ sử dụng mã tin nhắn thông báo và ID của người nhận để gửi tin nhắn marketing.

{
  "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN",
  "recipient_id": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "creation_timestamp": "TIMESTAMP",
  "token_expiry_timestamp": "TIMESTAMP",
  "user_token_status": "REFRESHED",
  "notification_messages_reoptin": "ENABLED",
  "notification_messages_timezone": "TIMEZONE-ID"
  "next_eligible_time": TIMESTAMP
}

Những lệnh gọi API này sẽ được tính vào giới hạn tốc độ của ứng dụng.

Gửi tin nhắn marketing

Trước khi bắt đầu

Bạn sẽ cần:

• Mã tin nhắn thông báo của người đã chọn nhận thông báo
• ID Trang Facebook của doanh nghiệp bạn
• Mã truy cập Trang do một người có thể thực hiện tác vụ MESSAGING trên Trang đó yêu cầu
• Quyền pages_messaging qua phương thức Đăng nhập bằng Facebook
• Bất kỳ tài sản nào cần đưa vào tin nhắn marketing
• Gói đăng ký webhook messaging_referrals cho ứng dụng của bạn

Để gửi tin nhắn marketing, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages kèm theo giá trị NOTIFICATION-MESSAGES-TOKEN của người nhận và thông tin tin nhắn trong file đính kèm của tin nhắn.

Giới hạn

• Bạn chỉ có thể gửi một tin nhắn mỗi ngày cho mỗi mã tin nhắn thông báo. Nếu bạn gửi nhiều tin nhắn, hãy đảm bảo các tin nhắn tiếp theo được gửi sau đó 24 giờ để tránh tình trạng hệ thống báo lỗi. (Không áp dụng cho Tin nhắn trao đổi thêm cho trường hợp chọn nhận.)

Đề xuất

• Khi gửi tin nhắn marketing, bạn nên tham chiếu đến múi giờ của người nhận để đảm bảo người nhận sẽ nhận được tin nhắn vào thời gian thích hợp.

Yêu cầu mẫu

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://raw.githubusercontent.com/fbsamples/original-coast-clothing/main/public/styles/male-work.jpg",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://www.originalcoastclothing.com/",
              "webview_height_ratio": "tall"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://www.originalcoastclothing.com/",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"ADDITIONAL-WEBHOOK-INFORMATION"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages?access_token=PAGE-ACCESS-TOKEN"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi sau đây:

{ 
  "recipient": "PAGE-OR-INSTAGRAM-SCOPED-ID",
  "message_id": "MESSAGE-ID"      
}

Thử nghiệm tin nhắn marketing

Bạn có thể thử nghiệm tin nhắn marketing bất cứ lúc nào.

Trước khi bắt đầu

Bạn sẽ cần:

• Một người ⁠– người dùng thử ⁠– sẽ nhận thông báo. Người này phải có vai trò trên ứng dụng.

Thử nghiệm tính năng chọn nhận thông báo

Bạn có thể thử nghiệm tin nhắn marketing bất cứ lúc nào bằng cách làm theo các bước sau.

• Bước 1. Gửi cho người dùng thử một tin nhắn có mẫu chọn nhận tin nhắn marketing.
• Bước 2. Đảm bảo rằng người dùng thử nhấp vào nút chọn nhận, chẳng hạn như Nhận tin nhắn giảm giá 50% trong cuộc trò chuyện.
• Bước 3. Gửi tin nhắn marketing đầu tiên cho người dùng thử
• Bước 4. Gửi một tin nhắn marketing khác ngay sau tin nhắn đầu tiên với thông số developer_action được đặt thành ENABLE_FOLLOWUP_MESSAGE.
• Bước 5. Gửi một tin nhắn marketing khác cho người dùng thử. Đây là tin nhắn thử nghiệm của bạn.

Yêu cầu mẫu

curl -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/notification_messages_dev_support
    ?recipient={
        "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN"
    }
    &developer_action=ENABLE_FOLLOWUP_MESSAGE
    &access_token=PAGE-ACCESS-TOKEN"

Khi thành công, ứng dụng của bạn sẽ nhận được phản hồi JSON dưới đây chứa success được đặt thành true.

{ "success": true }

Để thử nghiệm tính năng chọn nhận lại, hãy lặp lại các bước với thông số developer_action được đặt thành SEND_RE_OPTIN ở Bước 4.

Bước tiếp theo

• Thông báo webhook chọn nhận tin nhắn
• Truy cập vào phần tổng quan về Loại tin nhắn để tìm hiểu về các loại tin nhắn khác nhau mà bạn có thể gửi.

Xem thêm

• Tài liệu tham khảo về tin nhắn trên Trang để biết thêm thông tin về các trường hiện có cho tin nhắn định kỳ.
• Danh sách Múi giờ có sẵn
• Mã lỗi cho nền tảng Messenger