Tài liệu tham khảo về sự kiện webhook messaging_optins

Sự kiện webhook chọn nhận tin nhắn được kích hoạt khi một người chọn nhận Tin nhắn marketing hoặc nhấn vào plugin Gửi đến Messenger.

Khi sử dụng plugin Gửi đến Messenger, thông số optin.ref sẽ được đặt theo trường data-ref trên plugin "Gửi đến Messenger". Nhà phát triển có thể dùng trường này để liên kết một sự kiện nhấp chuột trên plugin với một lệnh gọi lại.

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

Ứng dụng của bạn sẽ nhận được thông báo webhook chọn nhận tin nhắn khi các trường hợp sau đây xảy ra:

  • Một người chọn nhận tin nhắn
  • Một người chọn nhận lại tin nhắn bằng cách nhấp vào nút Tiếp tục nhận tin nhắn hiển thị trước khi mã tin nhắn thông báo hết hạn
  • Một người thay đổi trạng thái chọn nhận tin nhắn là dừng nhận thông báo hoặc tiếp tục nhận thông báo
{
  "sender": {
    "id": "PSID",
  },
  "recipient": {
    "id": "PAGE-ID",
  },
  "timestamp": "TIMESTAMP",
  "optin": {
    "type": "notification_messages", 
    "payload": "ADDITIONAL-INFORMATION",
    "notification_messages_token": "NOTIFICATION-MESSAGES-TOKEN", 
    "notification_messages_frequency": "FREQUENCY",  
    "notification_messages_timezone": "TIMEZONE-ID",
    "token_expiry_timestamp": "TIMESTAMP",
    "user_token_status": "TOKEN-STATUS",  
    "notification_messages_status": "NOTIFICATION-STATUS",
    "title": "TITLE" 
    }
}

optin

Thuộc tínhMô tả

payload

chuỗi

Thông tin khác mà bạn muốn thêm vào thông báo webhooks

title

chuỗi

Tên hiển thị trong mẫu

notification_messages_token

chuỗi

Mã biểu thị người đã chọn nhận tin nhắn theo chủ đề và tần suất nhắn tin cụ thể. Mã này được dùng để gửi Tin nhắn marketing

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

Giá trị có thể là một trong những mục sau đây:

  • DAILY - gửi 1 thông báo mỗi 24 giờ trong 6 tháng kể từ ngày chọn nhận thông báo
  • WEEKLY - gửi 1 thông báo mỗi tuần trong 9 tháng kể từ ngày chọn nhận thông báo
  • MONTHLY - gửi 1 thông báo mỗi tháng trong 12 tháng kể từ ngày chọn nhận thông báo

(Đã gỡ trong API v16)

notification_messages_timezone

chuỗi

Múi giờ của người nhận tin nhắn

notification_messages_status

enum { STOP NOTIFICATIONS, RESUME NOTIFICATIONS }
Trường này chỉ hiển thị khi người dùng dừng hoặc tiếp tục nhận Tin nhắn marketing.

Giá trị có thể là một trong những mục sau đây:

  • STOP NOTIFICATIONS - Người dùng đã nhấp vào nút "Dừng nhận những tin nhắn này"
  • RESUME NOTIFICATIONS - Người dùng đã nhấp vào nút "Tiếp tục nhận những tin nhắn này"

token_expiry_timestamp

nhãn thời gian unix

Ngày hết hạn của mã tin nhắn thông báo

type

chuỗi

Giá trị phải là notification_messages

user_token_status

enum { REFRESHED, NOT_REFRESHED }

Giá trị có thể là một trong những mục sau đây:

  • REFRESHED - Giá trị này được đặt khi người dùng chọn nhận lại Tin nhắn marketing sau khi mã hết hạn
  • NOT_REFRESHED - Giá trị mặc định và được đặt khi người dùng không chọn nhận lại Tin nhắn marketing sau khi mã hết hạn