๐Ÿ†• Webhook - ๋ฉด์ ‘ ์ผ์ • ๋ณ€๊ฒฝ

๊ทธ๋ฆฌํŒ… ๋‚ด์—์„œ ํ™•์ •๋œ ๋ฉด์ ‘์˜ ์ผ์‹œ๊ฐ€ ๋ณ€๊ฒฝ๋˜๋ฉด ๋‹ค์Œ์˜ ๋ฐ์ดํ„ฐ๋ฅผ ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค.

MEETING_SCHEDULE_CHANGED

์‹ค์ œ ์ผ์‹œ๊ฐ€ ๋ฐ”๋€Œ์ง€ ์•Š์•„๋„ ์ˆ˜์ •ํ•  ๋•Œ๋งˆ๋‹ค ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. ๊ฐ™์€ startTimeยทendTime์ด ๋‹ค์‹œ ์˜ฌ ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ, ๊ฐ’์ด ๋‹ฌ๋ผ์กŒ๋Š”์ง€๋Š” ์ˆ˜์‹  ์ธก์—์„œ ๋น„๊ตํ•˜์„ธ์š”.

  • ํ™•์ •๋œ ๋ฉด์ ‘์˜ ์ผ์‹œ๋ฅผ ์ˆ˜์ •ํ•˜๋ฉด ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.

  • startTimeยทendTime์—๋Š” ๋ณ€๊ฒฝ ํ›„ ์ผ์‹œ๊ฐ€ ๋‹ด๊น๋‹ˆ๋‹ค. ๋ณ€๊ฒฝ ์ „ ๊ฐ’์€ ์ œ๊ณต๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

  • ๋ฉด์ ‘ ์ œ์•ˆ์„ ๊ฑฐ์ ˆํ–ˆ๊ฑฐ๋‚˜ ์‘๋‹ต ๊ธฐํ•œ์ด ๋งŒ๋ฃŒ๋œ ์ง€์›์ž์—๊ฒŒ๋Š” ๋ฐœ์ƒํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๊ทธ๋ฃน ๋ฉด์ ‘์€ ์ด๋Ÿฐ ์ง€์›์ž๊ฐ€ ์ฐธ์„์ž๋กœ ๋‚จ์€ ์ฑ„ ํ™•์ •๋  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

POST

application/json

ํ—ค๋”

๊ฐ’

์„ค๋ช…

Content-Type

application/json

โ€”

X-Greeting-Event-Id

์ด๋ฒคํŠธ ๊ณ ์œ  id

๋ณธ๋ฌธ์˜ eventId์™€ ๊ฐ™์€ ๊ฐ’์ž…๋‹ˆ๋‹ค. ์ค‘๋ณต ์ˆ˜์‹  ์ œ๊ฑฐ์— ์‚ฌ์šฉํ•˜์„ธ์š”

X-Greeting-Signature

sha256 <hex>

HMAC-SHA256 ์„œ๋ช…์ž…๋‹ˆ๋‹ค. ๊ฒ€์ฆ ๋ฐฉ๋ฒ•์€ ๊ณตํ†ต ๊ทœ๊ฒฉ์„ ์ฐธ๊ณ ํ•˜์„ธ์š”

ํ•„๋“œ

ํƒ€์ž…

ํ•„์ˆ˜ ์—ฌ๋ถ€

์„ค๋ช…

eventId

String

ํ•„์ˆ˜

์ด๋ฒคํŠธ ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค. ์žฌ์‹œ๋„ ์‹œ์—๋„ ๋™์ผํ•˜๋ฏ€๋กœ ์ค‘๋ณต ์ œ๊ฑฐ ํ‚ค๋กœ ์‚ฌ์šฉํ•˜์„ธ์š”

eventType

Enum

ํ•„์ˆ˜

์ด๋ฒคํŠธ ์ข…๋ฅ˜์ž…๋‹ˆ๋‹ค. ์ด ์ด๋ฒคํŠธ์—์„œ๋Š” ํ•ญ์ƒ MEETING_SCHEDULE_CHANGED ์ž…๋‹ˆ๋‹ค

occurredAt

String

ํ•„์ˆ˜

์ด๋ฒคํŠธ ๋ฐœ์ƒ ์‹œ๊ฐ์ž…๋‹ˆ๋‹ค. ISO-8601 UTC ํ˜•์‹์ด๋ฉฐ Z๋กœ ๋๋‚ฉ๋‹ˆ๋‹ค (์˜ˆ: 2026-10-14T06:00:00Z)

workspaceId

Integer

ํ•„์ˆ˜

์›Œํฌ์ŠคํŽ˜์ด์Šค ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค

data

Object

ํ•„์ˆ˜

๋ฉด์ ‘ ์ƒ์„ธ ์ •๋ณด์ž…๋‹ˆ๋‹ค

ํ•„๋“œ

ํƒ€์ž…

ํ•„์ˆ˜ ์—ฌ๋ถ€

์„ค๋ช…

applicantId

Integer

ํ•„์ˆ˜

๋ฉด์ ‘ ๋Œ€์ƒ ์ง€์›์ž ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค. ๊ทธ๋ฃน ๋ฉด์ ‘์ด์–ด๋„ ์ง€์›์ž 1๋ช…๋‹น 1๊ฑด์”ฉ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค

openingId

Integer

ํ•„์ˆ˜

๊ณต๊ณ  ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค

processId

Integer

์„ ํƒ

๋ฉด์ ‘์ด ์†ํ•œ ์ฑ„์šฉ๋‹จ๊ณ„ ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค. ์ฑ„์šฉ๋‹จ๊ณ„์— ์—ฐ๊ฒฐ๋˜์ง€ ์•Š์€ ๋ฉด์ ‘์ด๋ฉด ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

processName

String

์„ ํƒ

๋ฉด์ ‘์ด ์†ํ•œ ์ฑ„์šฉ๋‹จ๊ณ„ ์ด๋ฆ„์ž…๋‹ˆ๋‹ค. ๋‹จ๊ณ„๊ฐ€ ์—†๊ฑฐ๋‚˜ ์‚ญ์ œ๋œ ๊ฒฝ์šฐ ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

meetingId

Integer

ํ•„์ˆ˜

๋ฉด์ ‘ ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค. ๋ฉด์ ‘ ๊ณ„์—ด 4์ข… ์ด๋ฒคํŠธ์—์„œ ๊ฐ™์€ ๊ฐ’์ด๋ฏ€๋กœ ๋ฉด์ ‘์„ ์‹๋ณ„ํ•˜๋Š” ํ‚ค๋กœ ์‚ฌ์šฉํ•˜์„ธ์š”

title

String

ํ•„์ˆ˜

๋ฉด์ ‘ ์ œ๋ชฉ์ž…๋‹ˆ๋‹ค

status

Enum

ํ•„์ˆ˜

์ด๋ฒคํŠธ๊ฐ€ ๊ธฐ๋ก๋œ ์‹œ์ ์˜ ์ด ์ง€์›์ž ๊ธฐ์ค€ ๋ฉด์ ‘ ์ƒํƒœ์ž…๋‹ˆ๋‹ค. ์•„๋ž˜ ๊ฐ’ ํ‘œ๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”

startTime

String

์„ ํƒ

ํ™•์ •๋œ ๋ฉด์ ‘ ์‹œ์ž‘ ์‹œ๊ฐ์ž…๋‹ˆ๋‹ค. ISO-8601 UTC ํ˜•์‹์ž…๋‹ˆ๋‹ค. ํ™•์ •๋œ ์  ์—†์ด ์ทจ์†Œ๋œ ๋ฉด์ ‘์ด๋ฉด ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

endTime

String

์„ ํƒ

ํ™•์ •๋œ ๋ฉด์ ‘ ์ข…๋ฃŒ ์‹œ๊ฐ์ž…๋‹ˆ๋‹ค. ํ˜•์‹๊ณผ ์ƒ๋žต ์กฐ๊ฑด์€ startTime๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค

timeZone

String

์„ ํƒ

๋ฉด์ ‘ ์ผ์ •์˜ ํ‘œ์‹œ ํƒ€์ž„์กด์ž…๋‹ˆ๋‹ค (์˜ˆ: Asia/Seoul). ์ƒ๋žต ์กฐ๊ฑด์€ startTime๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค

location

Object

ํ•„์ˆ˜

๋ฉด์ ‘ ์žฅ์†Œ์ž…๋‹ˆ๋‹ค

organizer

Object

ํ•„์ˆ˜

๋ฉด์ ‘์„ ๋งŒ๋“  ๋‹ด๋‹น์ž์ž…๋‹ˆ๋‹ค

interviewers

Object[]

ํ•„์ˆ˜

๋ฉด์ ‘๊ด€ ๋ชฉ๋ก์ž…๋‹ˆ๋‹ค. ๋ฉด์ ‘๊ด€์ด ์—†์œผ๋ฉด ๋นˆ ๋ฐฐ์—ด์ž…๋‹ˆ๋‹ค

๊ฐ’

์„ค๋ช…

CREATE

์ผ์ • ์กฐ์œจ ์ค‘ (ํ™•์ • ์ „)

REQUEST_CHANGE

์ผ์ • ๋ณ€๊ฒฝ ์š”์ฒญ ์ค‘

CONFIRM

์ผ์ • ํ™•์ •

FINISHED

๋ฉด์ ‘ ์ข…๋ฃŒ (ํ™•์ •๋œ ์ผ์ •์˜ ์ข…๋ฃŒ ์‹œ๊ฐ์ด ์ง€๋‚จ)

CANCELED

๋ฉด์ ‘ ์ทจ์†Œ. ๊ทธ๋ฃน ๋ฉด์ ‘์—์„œ ์ œ์™ธ๋œ ์ง€์›์ž๋„ ์ด ๊ฐ’์ž…๋‹ˆ๋‹ค

EXPIRED

์ผ์ • ์ œ์•ˆ์— ๋Œ€ํ•œ ์‘๋‹ต ๊ธฐํ•œ ๋งŒ๋ฃŒ (ํ™•์ • ์ „)

ํ•„๋“œ

ํƒ€์ž…

ํ•„์ˆ˜ ์—ฌ๋ถ€

์„ค๋ช…

category

Enum

ํ•„์ˆ˜

DIRECT_INPUT(์ง์ ‘ ์ž…๋ ฅ) / GOOGLE_MEET(๊ตฌ๊ธ€ ๋ฐ‹) / MICROSOFT_TEAMS(ํŒ€์ฆˆ)

address

String

์„ ํƒ

์žฅ์†Œ ์ฃผ์†Œ์ž…๋‹ˆ๋‹ค. ๋น„๋Œ€๋ฉด ๋ฉด์ ‘(๊ตฌ๊ธ€ ๋ฐ‹ยทํŒ€์ฆˆ)์ด๋ฉด ํ™”์ƒ ํšŒ์˜ ๋งํฌ๊ฐ€ ๋“ค์–ด ์žˆ์Šต๋‹ˆ๋‹ค. ์ž…๋ ฅ๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

ํ•„๋“œ

ํƒ€์ž…

ํ•„์ˆ˜ ์—ฌ๋ถ€

์„ค๋ช…

userId

Integer

ํ•„์ˆ˜

์‚ฌ์šฉ์ž ๊ณ ์œ  id ๊ฐ’์ž…๋‹ˆ๋‹ค

name

String

์„ ํƒ

์ด๋ฆ„์ž…๋‹ˆ๋‹ค. ๊ณ„์ •์ด ์‚ญ์ œ๋œ ๊ฒฝ์šฐ ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

email

String

์„ ํƒ

์ด๋ฉ”์ผ์ž…๋‹ˆ๋‹ค. ๊ณ„์ •์ด ์‚ญ์ œ๋œ ๊ฒฝ์šฐ ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค

๊ฐ’์ด ์—†๋Š” ํ•„๋“œ๋Š” ํ‚ค ์ž์ฒด๊ฐ€ ์ƒ๋žต๋ฉ๋‹ˆ๋‹ค. ํ•ญ์ƒ ์กด์žฌํ•œ๋‹ค๊ณ  ๊ฐ€์ •ํ•˜์ง€ ๋ง๊ณ  ์—†์„ ๋•Œ๋ฅผ ์ฒ˜๋ฆฌํ•˜์„ธ์š”.

JSON
  • ๋งค๋ฒˆ ๊ทธ ์‹œ์ ์˜ ๋ฉด์ ‘ ์ „์ฒด ์ •๋ณด๊ฐ€ ์ „๋‹ฌ๋ฉ๋‹ˆ๋‹ค. ์ด์ „ ์ƒํƒœ๋ฅผ ๋ณด๊ด€ํ•˜์ง€ ์•Š์•„๋„ meetingId+applicantId ๊ธฐ์ค€์œผ๋กœ ๋ฎ์–ด์“ฐ๋ฉด ๋ฉ๋‹ˆ๋‹ค.

  • ๋ฉด์ ‘ ๊ณ„์—ด ์ด๋ฒคํŠธ๋Š” ์ข…๋ฅ˜๋งˆ๋‹ค ๋„์ฐฉ ์ˆœ์„œ๊ฐ€ ์‹ค์ œ ๋ฐœ์ƒ ์ˆœ์„œ์™€ ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ตœ์ข… ์ƒํƒœ๋Š” status ๊ฐ’์œผ๋กœ ํŒ๋‹จํ•˜์„ธ์š”.

  • ๋ฉด์ ‘ ๋ฉ”๋ชจ๋Š” ํฌํ•จ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

  • ์ง€์›์ž ์ด๋ฆ„ยท์—ฐ๋ฝ์ฒ˜๋Š” ํฌํ•จ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ํ•„์š”ํ•˜๋ฉด applicantId๋กœ ์ง€์›์ž ์กฐํšŒ Open API๋ฅผ ํ˜ธ์ถœํ•ด ๊ฐ€์ ธ์˜ค์„ธ์š”.