Webhooks 이벤트 참고 자료

Webhooks 이벤트는 사용자가 메시지를 보내는 등 다양한 상호 작용 또는 이벤트가 발생할 때 Messenger 플랫폼에서 봇에 알리는 방식입니다. Webhooks 이벤트는 Messenger 플랫폼에 의해 Webhooks에 POST 요청으로 전송됩니다.

참고: 비즈니스의 모든 메시지 앱이 메시지 전송 Webhooks를 구독해야 합니다.

Webhooks 이벤트 리스트

다음은 Messenger 플랫폼에서 Webhooks에 보낼 수 있는 이벤트의 리스트입니다.

참고: 최신 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`	번호	업데이트 시간(epoch 시간, 밀리초 단위)
`messaging`	배열<`messaging`>	`messaging` 개체 하나가 포함된 배열입니다. 배열이지만 `messaging` 개체 하나만 포함됩니다.

`entry.messaging`

속성	유형	설명
`sender.id`	문자열	보내는 사람 사용자 ID
`recipient.id`	문자열	받는 사람 사용자 ID

더 알아보기

메시지를 처리하는 앱이 두 개 이상일 경우(예: 한 개의 앱은 자동화된 답변을 처리하고 한 개의 앱은 인간 상담원에 대한 에스컬레이션을 처리할 경우) 핸드오버 프로토콜을 구현하여 한 앱에서 다른 앱으로 대화를 전달해야 합니다. 핸드오버 프로토콜