초대 이벤트

이용자가 봇을 자기 방에 넣어 달라고 신청하면 invite.created를, 제작자가 수락하면 invite.accepted를 웹훅으로 보내요. 두 이벤트는 연동 화면에서 따로 켜야 와요.

이벤트#

이벤트	보내는 때
`invite.created`	초대 신청이 들어왔을 때. 신청은 대기 상태예요.
`invite.accepted`	소유자나 '초대 처리' 권한을 받은 공동 제작자가 수락했을 때

요청 본문#

{
  "id": "whd_mf3k2x9a8c7d6e5f",
  "event": "invite.created",
  "botId": "bot_mf3k2x9a1b2c3d4e",
  "invite": {
    "id": "inv_mf3k2x9a0a1b2c3d",
    "roomType": "open",
    "roomName": "급식 알림방",
    "memberCount": 42,
    "status": "pending"
  },
  "createdAt": "2026-09-14T06:02:11.000Z"
}

필드#

필드	타입	설명
`id`	string	전송 id. X-Hankari-Delivery와 같고, 다시 보내도 바뀌지 않아요
`event`	string	invite.created 또는 invite.accepted
`botId`	string	신청을 받은 봇 id
`invite.id`	string	초대 신청 id. 받은 초대 신청 화면의 신청과 같아요
`invite.roomType`	string	open(오픈채팅방) 또는 direct(일반 단톡방)
`invite.roomName`	string	신청한 방 이름
`invite.memberCount`	number \| null	신청한 방의 인원 수. 모르면 null
`invite.status`	string	보낸 순간의 신청 상태. invite.created는 pending, invite.accepted는 accepted
`createdAt`	string	이벤트가 생긴 시각(ISO 8601, UTC)

신청자가 누구인지, 오픈채팅 링크와 참여코드는 보내지 않아요. 봇을 방에 넣을 때 필요한 값은 Hankari Devs의 받은 초대 신청에서 확인해 주세요.

수락 뒤에는#

수락한 뒤 봇을 방에 넣고 '입장시켰어요'를 누르면, 신청자도 '봇이 들어왔어요'를 눌러 입장이 끝나요. 입장이 끝난 방이 봇의 방 수가 돼요. 거절·취소·입장 완료는 아직 웹훅으로 보내지 않아요.