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

Lệnh gọi lại này sẽ diễn ra khi ai đó gửi tin nhắn đến Trang của bạn. Tin nhắn luôn được gửi theo thứ tự. Bạn có thể nhận được tin nhắn văn bản hoặc tin nhắn có file đính kèm.

Các loại file đính kèm chính được hỗ trợ bao gồm image, audio, video, file, reel và ig_reel. Bạn cũng có thể nhận được file đính kèm fallback. Ví dụ thường gặp về file đính kèm "fallback'' là khi người dùng chia sẻ URL với một Trang, file đính kèm sẽ được tạo dựa trên tính năng chia sẻ liên kết. Đối với những nội dung không được hỗ trợ mà người dùng chia sẻ lên Trang của bạn, hệ thống có thể gửi file đính kèm fallback không có phần tải dữ liệu.

Bạn có thể đăng ký nhận lệnh gọi lại này bằng cách chọn message khi thiết lập webhook của mình.

Ví dụ

Tin nhắn văn bản

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

Tin nhắn trả lời

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

Tin nhắn có file đính kèm

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

Tin nhắn có mẫu sản phẩm

Webhook này áp dụng cho trường hợp khi người dùng chia sẻ sản phẩm lên trang từ chuỗi trò chuyện khác hoặc qua quy trình chia sẻ. Webhook này chỉ dành cho những sản phẩm thuộc sở hữu của trang đó. Ứng dụng sẽ cần được phê duyệt quyền catalog_management thì mới nhận được chi tiết sản phẩm trong webhook.

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

Tin nhắn có file đính kèm dự phòng

Ví dụ áp dụng cho messages trên phiên bản 6.0 trở lên

{
    "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"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Tin nhắn từ trang chi tiết sản phẩm trong Cửa hàng

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

Tin nhắn có thông tin giới thiệu quảng cáo

Webhook này áp dụng cho trường hợp người dùng nhấp vào quảng cáo CTM (Click đến Messenger) và gửi tin nhắn đến trang Facebook. Ngoài chi tiết tin nhắn đi kèm, ứng dụng sẽ nhận được thông tin giới thiệu quảng cáo.

{
  "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>"
      }
    }
  }
}

Tin nhắn có chứa lệnh

{
  "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"
              }
            ]
          }
        }
      ]
    }
  ]
}

Thuộc tính

sender

recipient

message

message.quick_reply

Phần tải dữ liệu quick_reply chỉ được cung cấp cùng tin nhắn văn bản khi người dùng nhấn vào nút Câu trả lời nhanh.

message.reply_to

message.attachments

message.attachments.payload

message.attachments.payload.product.elements

message.referral

Phần tải dữ liệu referral chỉ được cung cấp khi người dùng gửi tin nhắn từ trang chi tiết sản phẩm trong Cửa hàng.

message.referral.product

message.referral.ads_context_data

message.commands