Справка по событию Webhooks messages

Этот обратный вызов выполняется, когда вашей Странице отправляют сообщение. Сообщения всегда отправляются по очереди. Можно получать текстовые сообщения и сообщения с вложениями.

Основные поддерживаемые типы вложений: image, audio, video, file, reel и ig_reel. Также можно получать вложения типа fallback. Обычно такие вложения отправляются, когда пользователь делится со страницей URL-адресом: при этом создается вложение по принципам отправки ссылок. Если отправлено вложение неподдерживаемого типа, вы можете получить fallback с пустым значением.

Чтобы подписаться на этот обратный вызов, выберите поле message при настройке Webhooks.

Примеры

Текстовое сообщение

{
  "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, для него должно быть одобрено разрешение catalog_management.

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

Сообщение с вложением fallback

Пример подходит для messages в Graph API начиная с версии 6.0.

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

Сообщение со страницы сведений о товаре в Магазине

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

Сообщение с информацией о реферале рекламы

Этот Webhooks относится к сценарию, когда пользователь нажимает рекламу с переходом в 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 добавляется, только когда пользователь отправляет сообщение со страницы сведений о товаре в Магазине.

message.referral.product

message.referral.ads_context_data

message.commands