등록된 양방향 서비스를 사용하는 챗봇의 moMsgWebhookUrl 를 RBC 가 MaaP FE 로 전달하고, MaaP FE 는 전달받은 moMsgWebhookUrl 의 마지막 부분에 각 통신사 구분자URL {SKT|KT|LGU} 을 추가하여 이벤트를 전달된다. 예> RBC 가 MaaP FE 로 전달한 moMsgWebhookUrl 이 http://clientservice/momsg 인 경우, KT MaaP FE 는 http://clientservice/momsg/KT 로 전달. 규격은 array 형태이나, 실제 통신사 Maap FE 는 단건(1건) 단위로 전송한다.
F/E 에서 제공하는 고유 id 로 이후에 중계사가 세션 메시지를 발송하려면 이 값을 /message API의 replyId로 포함해야 함. replyId는 24시간 유효함.
response 이벤트 only - 대화방메뉴내 reply 클릭 시에, 속성으로 포함된 postbackId 값을 전달
newUser, response 이벤트 only - 칩리스트/리치카드 버튼 중 reply 클릭 시에, 발송 요청시 포함되었던 postbackData 값을 그대로 전달
response - 발송 요청시 포함되었던 버튼의 텍스트를 그대로 전달, newUser 인 경우 '안녕'
message 이벤트 only
유저 번호
대화방 chatbotId
응답한 시간
POST /ag/1.2/momsg (webhook) HTTP/1.1
Host: maapdomain.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 726
[
{
"replyId": "A",
"eventType": "message",
"messageBody": {
"textMessage": "hello world"
},
"userContact": "01012341234",
"chatbotId": "bot_1",
"timestamp": "2019-08-19T04:43:55.867+09"
},
{
"replyId": "B",
"eventType": "response",
"postbackId": "pid_1",
"displayText": "대화방메뉴 버튼 텍스트",
"userContact": "01012341234",
"chatbotId": "bot_1",
"timestamp": "2019-08-19T04:43:55.867+09"
},
{
"replyId": "C",
"eventType": "response",
"postbackData": "발송 시 지정한 값",
"displayText": "칩리스트 버튼",
"userContact": "01012341234",
"chatbotId": "bot_1",
"timestamp": "2019-08-19T04:43:55.867+09"
},
{
"replyId": "D",
"eventType": "newUser",
"displayText": "안녕",
"userContact": "01012341234",
"chatbotId": "bot_1",
"timestamp": "2019-08-19T04:43:55.867+09"
}
]
No content