messaging_optins Webhooks 이벤트 참고 자료

메시지 옵트인 Webhooks 이벤트는 사용자가 마케팅 메시지를 수신하도록 옵트인하거나 Messenger로 보내기 플러그인을 탭하면 트리거됩니다.

Messenger로 보내기 플러그인을 사용할 때는 optin.ref 매개변수가 'Messenger로 보내기' 플러그인에 있는 data-ref 필드에 의해 설정됩니다. 이 필드는 개발자가 플러그인의 클릭 이벤트와 콜백을 연결하는 데 사용할 수 있습니다.

메시지 옵트인 Webhooks 알림

앱은 다음과 같은 상황에서 옵트인 Webhooks 알림을 받습니다.

  • 사용자 옵트인
  • 사용자가 알림 메시지 토큰이 만료되기 전에 메시지 계속 받기 버튼을 클릭하여 재옵트인
  • 사용자가 옵트인 상태를 변경해 알림 수신을 중단 또는 재개
{
  "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

속성설명

payload

문자열

Webhooks 알림에 포함하고자 하는 추가적인 정보

title

문자열

템플릿에 표시되는 제목

notification_messages_token

문자열

마케팅 메시지를 보내는 데 사용한 특정 주제와 메시지 빈도를 포함하여 메시지 수신을 옵트인한 사용자를 나타내는 토큰

notification_messages_frequency

enum { DAILY, WEEKLY, MONTHLY }

값은 다음 중 하나일 수 있습니다.

  • DAILY - 옵트인 날짜로부터 6개월 동안 24시간마다 알림 1개 전송
  • WEEKLY - 옵트인 날짜로부터 9개월 동안 매주 알림 1개 전송
  • MONTHLY - 옵트인 날짜로부터 12개월 동안 매월 알림 1개 전송

(API v16에서 삭제됨)

notification_messages_timezone

문자열

메시지를 받는 사람의 시간대

notification_messages_status

enum { STOP NOTIFICATIONS, RESUME NOTIFICATIONS }
이 필드는 사용자가 마케팅 메시지 수신을 중단하거나 재개할 경우에만 표시됩니다.

값은 다음 중 하나일 수 있습니다.

  • STOP NOTIFICATIONS - 사용자가 '이 메시지 그만 받기'를 클릭했습니다.
  • RESUME NOTIFICATIONS - 사용자가 '이 메시지 다시 받기'를 클릭했습니다.

token_expiry_timestamp

UNIX 타임스탬프

알림 메시지 토큰이 만료된 시점의 날짜

type

문자열

값은 notification_messages여야 합니다.

user_token_status

enum { REFRESHED, NOT_REFRESHED }

값은 다음 중 하나일 수 있습니다.

  • REFRESHED - 토큰이 만료된 후 사용자가 마케팅 메시지를 받기로 재옵트인한 경우에 설정됩니다.
  • NOT_REFRESHED - 기본값이며, 토큰이 만료된 후 사용자가 마케팅 메시지를 받기로 재옵트인하지 않은 경우에 설정됩니다.