Postback Event

Action Object의 postback action에 대한 응답으로 받는 이벤트 객체이다.
Postback Event는 아래와 같은 메시지 전송시 사용할 수 있으며, type 속성이 "postback" 인 이벤트 객체가 전송된다.

  • 메시지 전송(Carousel)
  • 메시지 전송(Image Carousel)
  • 메시지 Rich Menu

Request {#postback-event-request}

파라미터타입필수 여부설명
typestringY"postback"으로 고정
sourceobjectYcallback 메시지를 전달한 주체
source.userIdstringY대화한 사용자의 대표 계정
source.channelIdstringY대화한 사용자가 속한 메시지방 ID
source.domainIdnumberY대화한 사용자가 속한 도메인 ID
issuedTimestringY이벤트 발생 시각(형식: YYYY-MM-DDThh:mm:ss.SSSZ).
datastringYpostback 데이터

Request Example {#postback-event-request-example}

POST /callback HTTP/1.1Host: YOUR_SERVER_HOST_NAMEContent-type: application/json; charset=UTF-8X-WORKS-Signature: 9crxWhZ9aQO/9ruUM4MH3dF/WRGYRhj0vSR4cRyJfHQ=X-WORKS-BotId: 123{  "type": "postback",  "source": {    "userId": "c72af563-0f21-4736-11e4-045237113344",    "channelId": "12345",    "domainId": 40029600  },  "issuedTime":"2022-01-04T05:16:05.716Z",  "data": "action=buy"}

Response(고객사의 메시지 수신 서버 -> 메시지 서버) {#postback-event-response}

호출에 성공하면 HTTP 상태 코드 200을 반환해야 한다.
callback에 의해 전송된 HTTP 요청은 실패해도 다시 전송하지 않는다.

Response {#postback-event-response-example}

HTTP/1.1 200 OKContent-Type: application/jsonServer: YOUR_SERVER_HOST_NAMEContent-Length: 0