Tin nhắn marketing

Tài liệu này hướng dẫn bạn cách yêu cầu quyền từ người dùng để gửi tin nhắn marketing, cung cấp 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 để gử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. Hành động người dùng chọn nhận Tin nhắn marketing sẽ không bắt đầu 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ỡ bỏ nếu chúng tôi xác định rằng trải nghiệm nhắn tin của ứng dụng có quá nhiều phản hồi 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 đồng ý trùng lặp ở tần suất cao đến cùng người dùng và các loại spam khác như được xác định 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 đồng ý cho một người với cùng một tiêu đề cụ thể. Yêu cầu đồng ý này có giá trị mặc định là "Updates and promotions" (Thông tin mới và khuyến mãi).
• Không gửi yêu cầu đồng ý trùng lặp cho một người. Yêu cầu đồng ý trùng lặp được định nghĩa là có cùng title cho những thông báo từ một Trang Facebook hoặc có cùng title và image_url cho những thông báo từ mộ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à gửi tối đa 5 yêu cầu đồng ý 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 việc 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 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 đồng ý của bạn - bao gồm 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ư cập nhật đơ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 đồng ý cho người dùng, mỗi yêu cầu đồng ý cần nêu rõ 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ó thể 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ả 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 đồng ý và Tin nhắn marketing để xem có đáp ứng những cách làm tốt nhất ở trên hay không.

Tần suất nhắn tin

Á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 thông báo, bạn có thể gửi tin nhắn cho người đó hàng ngày, hàng tuần hoặc hàng tháng tùy theo tần suất mà họ đã chọ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 nhiều cách để bạn yêu cầu sự đồng ý của mọi người. Bạn có thể tạo yêu cầu đồng ý trong các trải nghiệm nhắn tin sau:

• 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 đồng ý nhận tin nhắn marketing, hãy gửi yêu cầu POST đến điểm cuối /PAGE-ID/messages với loại mẫu tin nhắn được đặt 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 có chứa thẻ quay vòng từ Trang Facebook hoặc tài khoản Công việc trên Instagram của bạn.

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 đến người đó.

Thông báo webhook chọn nhận tin 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. Người dùng có thể bỏ chọn nhận thông báo bất cứ lúc nào.

Chọn nhận tin nhắn trao đổi thêm

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ự. Những tin nhắn trao đổi thêm này có thể được gửi ngoài khoảng thời gian nhắn tin tiêu chuẩn 24 giờ.

Để 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. Cú pháp của yêu cầu API cho cả 3 tin nhắn trao đổi thêm đều như 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. Bạn có thể thêm thông số limit để đọc thêm. 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 gồm có 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 sau đây. Phản hồi nà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ẽ 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
}

Các 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ạn 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 gửi các tin nhắn cách nhau 24 giờ. Nếu không, bạn sẽ gặp 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ạn bắt đầu

Bạn sẽ cần:

• Một người - người dùng thử - để 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 thông báo - chẳng hạn như Nhận thông báo 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 thông báo đầ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 sẽ 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 sau đây chứa success được đặt là true.

{ "success": true }

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

Bước tiếp theo

• Thông báo webhooks chọn nhận tin nhắn
• Truy cập Tổng quan về các 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