messaging_optins
Webhook 事件參考資料當用戶選擇接收營銷訊息或點按「傳送至 Messenger」附加程式時,就會觸發選擇接收訊息的 Webhook 事件。
使用「傳送至 Messenger」附加程式時,會由「傳送至 Messenger」附加程式的 data-ref
欄位設定 optin.ref
參數。開發人員可以使用這個欄位,以回呼關連附加程式上的點擊事件。
應用程式會在以下情況收到有關選擇接收訊息的 Webhook 通知:
{ "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
屬性 | 說明 |
---|---|
| 您想在 Webhooks 通知加入的其他資訊 |
| 範本中顯示的標題 |
| 用作傳送營銷訊息、代表選擇接收訊息的用戶之憑證,其中包括特定主題和訊息頻率 |
DAILY, WEEKLY, MONTHLY } | 值可以是下列其中一項:
(已在 API v16 中移除) |
| 接收訊息的用戶之時區 |
STOP NOTIFICATIONS, RESUME NOTIFICATIONS } | 只有當用戶停止或重新選擇接收營銷訊息時,才會展示此欄位。 值可以是下列其中一項:
|
| 通知訊息憑證的過期日期 |
| 值必須為 |
REFRESHED, NOT_REFRESHED } | 值可以是下列其中一項:
|