Joined Event

봇이 속한 조직/그룹, 1:N 메시지방에 사용자가 초대됐을 때의 이벤트 개체이다.
Joined Event는 아래와 같은 경우에 발생하며, type 속성이 "joined" 인 이벤트 객체가 전송된다.

봇이 메시지방을 생성했을 때
메시지방 사용자가 다른 사용자를 초대했을 때

주의
1:1 메시지방에서 발생하는 'Joined Event' 기능은 폐지될 예정이다.
앞으로 'Joined Event' 대신 'Begin Event'를 이용한다.

Request {#joined-event-request}

파라미터	타입	필수 여부	설명
type	string	Y	"joined"로 고정
source	object	Y	callback 메시지를 전달한 주체
source.channelId	string	Y	봇이 초대된 메시지방 ID
source.domainId	number	Y	봇이 초대된 도메인 ID
issuedTime	string	Y	이벤트 발생 시각(형식: YYYY-MM-DDThh:mm:ss.SSSZ)
members	array	Y	조직/그룹, 1:N 메시지방에 초대된 사용자 목록

Request Example {#joined-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": "joined",  "source": {    "channelId": "12345",    "domainId": 40029600  },  "issuedTime":"2022-01-04T05:16:05.716Z",  "members":["userf7da-f82c-4284-13e7-030f3b4c756x"]}

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

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

Response {#joined-event-response-example}

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