messages Webhooks 이벤트 참고 자료

페이지로 메시지가 전송되면 이 콜백이 실행됩니다. 메시지는 항상 순서대로 전송됩니다. 문자 메시지 또는 첨부 파일이 포함된 메시지를 수신할 수 있습니다.

주로 지원되는 유형은 첨부 파일 유형 image, audio, video, file, reel 및 ig_reel입니다. fallback 첨부 파일을 수신할 수도 있습니다. '폴백'의 일반적인 예로는 사용자가 페이지에 URL을 공유할 때 링크 공유를 기반으로 첨부 파일이 생성되는 것입니다. 지원되지 않는 공유를 페이지에 수행하는 경우 페이로드가 없는 fallback이 전송될 수 있습니다.

Webhooks를 설정할 때 message를 선택하여 이 콜백을 구독할 수 있습니다.

예시

문자 메시지

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "quick_reply": {
      "payload": "<DEVELOPER_DEFINED_PAYLOAD>"
    }
  }
}    

답장 메시지

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"m_1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "reply_to": {
      "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU"
    }
  }
}    

첨부 파일이 포함된 메시지

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

제품 템플릿이 포함된 메시지

이 Webhooks는 사용자가 다른 스레드의 제품을 공유하거나 페이지에 플로를 공유할 경우에 적용됩니다. 이 Webhooks는 페이지에서 소유한 제품으로만 제한됩니다. Webhooks에서 제품 상세 정보를 수신하려면 앱이 catalog_management 권한을 승인받아야 합니다.

{
  "id": "682498302938465",
  "time": 1518479195594,
  "messaging": [
    {
      "sender": {
        "id": "

폴백 첨부 파일이 포함된 메시지

v6.0 이상에서 messages에 적용되는 예

{
    "object": "page",
    "entry": [
        {
            "id": "<PAGE_ID>",
            "time": 1583173667623,
            "messaging": [
                {
                    "sender": {
                        "id": "<PSID>"
                    },
                    "recipient": {
                        "id": "<PAGE_ID>"
                    },
                    "timestamp": 1583173666767,
                    "message": {
                        "mid": "m_toDnmD...",
                        "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg",
                        "attachments": [
                            {
                                "type": "fallback",
                                "payload": {
                                    "url": "<ATTACHMENT_URL >",
                                    "title": "TAHITI - Heaven on Earth"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Shops 제품 상세 정보 페이지의 메시지

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "product": {
        "id":"<PRODUCT_ID>"
      }
    }
  }
}    

광고 리퍼럴 정보가 포함된 메시지

이 Webhooks는 사용자가 CTM(Messenger 연결) 광고를 클릭하고 Facebook 페이지에 메시지를 보내는 시나리오에 적용됩니다. 앱은 포함된 메시지 상세 정보 외에도 광고 리퍼럴 정보를 받게 됩니다.

{
  "sender":{
    "id":"<PSID>"
  },
  "recipient":{
    "id":"<PAGE_ID>"
  },
  "timestamp":1458692752478,
  "message":{
    "mid":"mid.1457764197618:41d102a3e1ae206a38",
    "text":"hello, world!",
    "referral": {
      "ref": "<REF_DATA_IF_SPECIFIED_IN_THE_AD>",
      "ad_id": "<ID_OF_THE_AD>",
      "source": "ADS",
      "type": "OPEN_THREAD",
      "ads_context_data": {
        "ad_title": "<TITLE_OF_THE_AD>",
        "photo_url": "<URL_OF_THE_IMAGE_FROM_AD_THE_USER_IS_INTERESTED_IN>",
        "video_url": "<THUMBNAIL_URL_OF_THE_VIDEO_FROM_THE_AD>",
        "post_id": "<ID_OF_THE_POST>",
        "product_id": "<PRODUCT_ID>"
      }
    }
  }
}

명령이 포함된 메시지

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1697643211842,
      "messaging": [
        {
          "sender": {
            "id": "<PSID>"
          },
          "recipient": {
            "id": "<PAGE_ID>"
          },
          "timestamp": 1697643027400,
          "message": {
            "mid": "m_3vs...",
            "text": "find flights from SFO to LAX next Thursday",
            "commands": [
              {
                "name": "flights"
              }
            ]
          }
        }
      ]
    }
  ]
}

속성

sender

recipient

message

message.quick_reply

quick_reply 페이로드는 사용자가 빠른 답장 버튼을 탭할 때 문자 메시지에만 제공됩니다.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

referral 페이로드는 사용자가 Shops 제품 상세 정보 페이지에서 메시지를 전송하는 경우에만 제공됩니다.

message.referral.product

message.referral.ads_context_data

message.commands