[Webhook] 웹훅 - ZOOM 연동 (화상회의 종료 시 콜백 받기)

ZOOM에선 화상회의 종료 시점에 콜백을 받을 수 있도록 webhook을 제공한다.

 

웹훅이 무엇인지 헷갈리신다면 아래의 글을..

Webhook (웹훅) :: 염소의 개발일기 (tistory.com)

Webhook (웹훅)

 

이번 글에선 ZOOM 연동 시 화상회의 종료 시점에 내가 만든 서비스의 API를 호출하도록 

줌에서 제공하는 webhook을 이용해 설정할 것이다.

 

※ ZOOM 화상회의 실행을 연동하는 방법은 설명하지 않습니다.

 

 

우선 ZOOM APP 관리자 페이지로 이동한다.

(create App을 통해 app을 생성한 후, 해당 app의 key를 가지고 화상회의 생성이 가능하다.)
https://marketplace.zoom.us/

App Marketplace

 

절차에 따라 간단히 APP을 생성 후,

우측 Manage 버튼을 통해 생성한 앱의 설정을 변경할 수 있다.

Freature메뉴에서 Event Subscriptions 항목을 체크한다.

 

아래의 사진처럼 새로운 Event Subscription을 생성한다.

아래의 Event notification endpoint URL에 

회의 종료 시 호출받고 싶은 API 주소를 입력한다.

 

Event types 버튼을 클릭하면 아래와 같이 ZOOM 에서 제공하는 Webhook 이벤트들의 목록을 볼 수 있다.

회의 종료 시점에 받고싶은 것이기 때문에 End Meeting을 찾아 체크한다.

Webhook 시 API를 호출하는 방법 및 파라미터는 아래 주소에서 확인이 가능하다.

Webhook Reference - API Reference - Zoom Developer - Technical Documentation and Reference

Webhook Reference - API Reference

 

우리가 원하는 Meeting End Event에선 아래의 파라미터를 가지고 API가 호출됨을 알 수 있다.

 

이로써 회의 종료 시 회의 참가 버튼 비활성화 등의 작업을 수행할 수 있게 되었다.

 

ZOOM에서 제공하는 webhook의 방식은 매우 다양하다.

모두 위와 같은 동일한 방법으로 처리가 가능하다.