Справка по событиям Webhooks

Платформа Messenger отправляет события Webhooks, чтобы уведомить вашего бота о различных взаимодействиях или событиях, в том числе о том, когда человек отправляет сообщение. Платформа Messenger передает события Webhooks как запросы POST к вашему Webhooks.

Примечание. На Webhooks сообщений необходимо подписать все приложения компании для обмена сообщениями.

Список событий Webhooks

Ниже перечислены события, которые можно отправлять в Webhooks с платформы Messenger.

Примечание. Рекомендуется использовать самую новую версию API, чтобы получать всю доступную информацию о каждом вызове Webhooks.

Событие Webhook	Описание
`messages`	Выполняет подписку на события получения сообщения
`messaging_account_linking`	Выполняет подписку на события привязки аккаунта
`messaging_checkout_updates` (бета-версия)	Выполняет подписку на события обновления информации об оформлении заказа
`message_deliveries`	Выполняет подписку на события доставки сообщения
`message_echoes`	Выполняет подписку на события зеркалирования сообщения
`messaging_game_plays`	Выполняет подписку на события моментальной игры
`messaging_handovers` (бета-версия)	Выполняет подписку на события протокола передачи
`messaging_optins`	Выполняет подписку на события включения плагина
`messaging_payments` (бета-версия)	Выполняет подписку на события платежа
`messaging_policy_enforcement`	Выполняет подписку на события применения политики
`messaging_postbacks`	Выполняет подписку на события получения обратной передачи
`messaging_pre_checkouts` (бета-версия)	Выполняет подписку на события до оформления заказа для платежей
`message_reads`	Выполняет подписку на события прочтения сообщения
`messaging_referrals`	Выполняет подписку на события перехода
`standby` (бета-версия)	Выполняет подписку на события резервного канала протокола передачи

Формат события

Все обратные вызовы для платформы Messenger имеют общий набор свойств. Он предоставляет информацию, необходимую для обработки действий людей, пользующихся вашим ботом, и реагирования на них. Помимо перечисленных ниже свойств, у каждого события есть набор индивидуальных.

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

Свойства

Свойство	Тип	Описание
`object`	Строка	Будет иметь значение `page`.
`entry`	Массив `entry`	Массив, содержащий данные события.

`entry`

Свойство	Тип	Описание
`id`	Строка	ID Страницы.
`time`	Число	Время обновления (время периода в миллисекундах).
`messaging`	Массив `messaging`>	Массив, содержащий один объект `messaging`. Внимание: этот массив будет содержать только один объект `messaging`.

`entry.messaging`

Свойство	Тип	Описание
`sender.id`	Строка	ID отправителя.
`recipient.id`	Строка	ID получателя.

Дополнительная информация

При использовании нескольких приложений, работающих с сообщениями, например когда одно приложение обрабатывает автоматические ответы, а другое — обращения к оператору, вам необходимо будет реализовать протокол передачи для передачи переписки из одного приложения в другое. Протокол передачи