Платформа Messenger

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

В этой статье описана полезная нагрузка JSON, которую получает ваш сервер Webhooks, если инициируется событие messaging_postbacks. Событие Webhooks обратной передачи в сообщениях инициируется, когда пользователь нажимает кнопку обратной передачи, кнопку "Начать" или элемент постоянного меню.

Пример уведомления

Ниже показан пример полезной нагрузки JSON, которая отправляется на ваш сервер Webhooks.

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

Свойства JSON в уведомлении Webhooks представляют собой строки.

СвойствоОписание

postback.mid

ID сообщения.

postback.payload

Данные, определенные в параметре payload призыва к действию. Эта информация содержится только в уведомлении Webhooks, отправляемом приложению, которое отправило сообщение человеку.

postback.referral

Информация о действии, которое выполнил человек, чтобы начать переписку.

Данные свойства referral указываются в уведомлении Webhooks, только если человек нажимает кнопку призыва к действию, например кнопку "Начать", используя:

  • плагин чата;
  • ссылку m.me;
  • объявление с переходом в Messenger;
  • QR-код в Messenger;
  • экран приветствия.

postback.referral.ref

Произвольные данные, изначально переданные в параметре ref ссылки m.me. Поддерживаются только буквы и цифры, а также символы -, _ и =.

postback.referral.source

URL реферала. Для ссылок m.me значением источника является “SHORTLINK”. Для рефералов из рекламной переписки в Messenger значением источника будет "ADS".

postback.referral.type

Идентификатор для реферала. Для рефералов, взятых из ссылок m.me, это всегда будет значение "OPEN_THREAD".

postback.title

Название призыва к действию, который нажал человек.

recipient.id

ID вашей Страницы Facebook.

sender.user_ref

ID ссылки на человека, который выполнил действие, например нажал отправившую сообщение кнопку "Начать", плагин чата или элемент постоянного меню.

timestamp

Метка времени Unix с датой отправки уведомления Webhooks на ваш сервер.

Статьи по теме

Дополнительная документация для разработчиков, которая поможет вам лучше разобраться с понятиями, упомянутыми в этой статье о Webhooks обратной передачи в сообщениях.