`messaging_postbacks` Webhooks 참고 자료

이 문서에서는 메시지 포스트백 Webhooks 이벤트가 트리거되었을 때 Webhooks 서버에서 수신할 JSON 페이로드에 대해 설명합니다. 사용자가 포스트백 버튼, 시작하기 버튼, 고정 메뉴 항목을 클릭하면 포스트백 Webhooks 이벤트가 트리거됩니다.

알림 예시

다음은 Webhooks 서버로 전송될 JSON 페이로드의 예시입니다.

{
  "field": "messaging_postbacks",
  "value": {
    "sender": {
      "user_ref": "USER-REF-ID"
    },
    "recipient": {
      "id": "PAGE-ID"
    },
    "timestamp": "1527459824",
    "postback": {
      "mid": "m_MESSAGE-ID",
      "title": "TITLE-FOR-THE-CTA",
      "payload": "USER-DEFINED-PAYLOAD",
      "referral": {
        "ref": "USER-DEFINED-REFERRAL-PARAM",
        "source": "SHORT-URL",
        "type": "OPEN_THREAD"
      }
    }
  }
}

JSON 속성

Webhooks 알림의 모든 JSON 속성은 문자열입니다.

속성	설명
`postback.mid`	메시지의 ID입니다.
`postback.payload`	CTA `payload` 매개변수에 정의된 정보입니다. 이는 메시지를 해당 사용자에게 보낸 앱으로 전송된 Webhooks 알림에만 포함됩니다.
`postback.referral`	사용자가 대화를 시작하기 위해 취한 행동에 대한 정보입니다. `referral` 속성 정보는 사용자가 다음 중 하나를 사용하여 대화를 시작하고 시작하기 버튼 등의 CTA를 클릭한 경우에만 Webhooks 알림에 포함됩니다. 채팅 플러그인 m.me 링크 Messenger 연결 광고 Messenger QR 코드 인사말 화면
`postback.referral.ref`	처음에 m.me 링크에 추가된 `ref` 매개변수에 전달된 임의의 데이터입니다. 영숫자, -, _, =만 지원됩니다.
`postback.referral.source`	이 리퍼럴의 URL입니다. m.me 링크의 경우 소스의 값은 `“SHORTLINK”`입니다. Messenger 대화 광고에서 비롯되는 리퍼럴의 경우 소스의 값은 `"ADS"`입니다.
`postback.referral.type`	리퍼럴의 식별자입니다. m.me 링크에서 비롯되는 리퍼럴의 경우 항상 `"OPEN_THREAD"`입니다.
`postback.title`	사용자가 클릭한 행동 유도(CTA)의 제목입니다.
`recipient.id`	Facebook 페이지의 ID입니다.
`sender.user_ref`	행동을 취하여(예: 시작하기, 채팅 플러그인 또는 고정 메뉴 항목 클릭) 메시지를 보낸 사용자를 참조하기 위한 ID입니다.
`timestamp`	Webhooks 알림을 서버로 전송한 날짜의 UNIX 타임스탬프입니다.

기타 참고 자료

이 메시지 포스트백 Webhooks 가이드에서 언급한 개념에 대한 이해를 돕기 위한 추가적인 개발자 문서입니다.

messaging_postbacks Webhooks 참고 자료

알림 예시

JSON 속성

기타 참고 자료

`messaging_postbacks` Webhooks 참고 자료