줌 모듈 사용 방법

Zoom 모듈을 사용하면 Zoom API ( https://marketplace.zoom.us/docs/guides/ )로 작업할 수 있습니다.

Zoom Module 설치

1_zoom_lookNfeel

먼저 Zoom 애플리케이션의 API Key 와 Secret Key 를 검색해야 합니다( https://marketplace.zoom.us/develop/create?source=devdocs ). 링크를 따라가면 선택할 수 있는 여러 유형의 Zoom 앱이 표시됩니다.

zoom_type_of_apps

Zoom 의 앱 API Key 와 Secret Key 는 앱 종류 선택 후 보여집니다.

zoom_creds

Meeting 및 Recurrence 데이터 모델

Zoom 모듈을 설치하면 두 개의 가상 데이터 모델인 Meeting 및 Recurrence 도 프로젝트에 생성됩니다. 첫 번째는 화상 통화 객체 자체를 말하며, Recurrence 는 이 화상 회의의 규칙성(recurrence)을 담당합니다. 다음 BP는 이러한 데이터 모델의 생성 및 사용에서 보조 역할을 합니다.

Make Zoom Meeting - Meeting 데이터 모델 유형의 개체를 만듭니다.
- Join_url [ string ] - 회의 링크;
- start_time [ datetime ] - 회의 시작 시간;
- Status [ string ] - 회의 상태.
- Type [ enum ] - 회의 유형
  - Instant - 예약되지 않은 일회성 회의
  - Scheduled - 예정된 회의
  - Recurring with no fixed time 되풀이 - 시간이 없는 되풀이 모임
  - Recurring with fixed time 에 되풀이
- Meeting_id [ integer ] - 회의 식별자.
- Agenda [ string ] - 회의 의제 정보;
- Topic [ string ] - 회의 주제;
- Recurrence [ 객체의 recurrence 유형] - Recurrence 데이터 모델 유형의 객체.
- Password [ string ] - 회의 암호;

2_make_meeting

Expand Zoom Meeting 확장 - Meeting 데이터 모델 유형의 개체를 확장합니다.
- Join_url [ string ] - 회의 링크;
- start_time [ datetime ] - 회의 시작 시간;
- Status [ string ] - 회의 상태.
- Type [ enum ] - 회의 유형
  - Instant - 예약되지 않은 일회성 회의
  - Scheduled - 예정된 회의
  - Recurring with no fixed time 되풀이 - 시간이 없는 되풀이 모임
  - Recurring with fixed time 에 되풀이
- Meeting_id [ integer ] - 회의 식별자.
- Agenda [ string ] - 회의 의제 정보;
- Topic [ string ] - 회의 주제;
- Recurrence [ 객체의 recurrence 유형] - Recurrence 데이터 모델 유형의 객체.
- Password [ string ] - 회의 암호;

3_expand_meeting

Make Zoom Recurrence - Recurrence 데이터 모델 유형의 개체를 만듭니다.
- Type [ enum ] - 반복 유형
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - 취소되기 전에 되풀이 모임이 발생하는 횟수로 1에서 50 사이의 값입니다. 이 키를 end_date_time 키와 함께 사용할 수 없습니다.
- Monthly_day [ integer ] - 매월 되풀이되는 모임에만 필요합니다. 정기 모임이 있는 달의 날짜로 1에서 31 사이입니다.
- Weekly_days [ enum ] - 주간 반복 회의에만 필요합니다(1 - 월요일, 2 - 화요일, … , 7 - 일요일).
- Repeat_interval [ integer ] - 회의의 반복 간격입니다. 일일 간격의 경우 최대 90일입니다. 주간 간격의 경우 최대 12주입니다.
- End_date_time [ datetime ] - UTC 형식의 되풀이 모임의 최종 종료 날짜 및 시간입니다. 이 키를 end_times 키와 함께 사용할 수 없습니다.

4_make_recurrence

Expand Zoom Recurrence - Recurrence 데이터 모델 유형의 개체를 확장합니다.
- Type [ enum ] - 반복 유형
  - Daily
  - Weekly
  - Monthly
- Ends_time [ integer ] - 취소되기 전에 되풀이 모임이 발생하는 횟수로 1에서 50 사이의 값입니다. 이 키를 end_date_time 키와 함께 사용할 수 없습니다.
- Monthly_day [ integer ] - 매월 되풀이되는 모임에만 필요합니다. 정기 모임이 있는 달의 날짜로 1에서 31 사이입니다.
- Weekly_days [ enum ] - 주간 반복 회의에만 필요합니다(1 - 월요일, 2 - 화요일, … , 7 - 일요일).
- Repeat_interval [ integer ] - 회의의 반복 간격입니다. 일일 간격의 경우 최대 90일입니다. 주간 간격의 경우 최대 12주입니다.
- End_date_time [ datetime ] - UTC 형식의 되풀이 모임의 최종 종료 날짜 및 시간입니다. 이 키를 end_times 키와 함께 사용할 수 없습니다.

5_expand_recurrence

Zoom Module 과 함께 작동하는 비즈니스 프로세스

사전 설치된 Zoom 모듈 비즈니스 프로세스는 애플리케이션 백엔드에만 사용할 수 있습니다.

Zoom: Get meeting 가져오기 - 지정된 식별자로 회의 개체를 가져옵니다.
- Meeting_id [ integer ] - 회의 식별자.

6_getMeeting

Zoom: Delete meeting - 지정된 식별자로 DB 에서 회의 기록을 삭제합니다.
- Meeting_id [ integer ] (필수) - 회의 식별자.

7_deleteMeeting

Zoom: Update meeting - 지정된 식별자로 DB 의 회의 개체를 업데이트합니다.
- Meeting_id [ integer ] (필수) - 회의 식별자.
- Topic [ string ] - 회의 주제;
- Type [ enum ] - 회의 유형
  - Instant - 예약되지 않은 일회성 회의
  - Scheduled - 예정된 회의
  - Recurring with no fixed time 되풀이 - 시간이 없는 되풀이 모임
  - Recurring with fixed time 에 되풀이
- start_time [ datetime ] - 회의 시작 시간;
- Join_url [ string ] - 회의 링크;
- Password [ string ] - 회의 암호;
- Agenda [ string ] - 회의 의제 정보;
- Recurrence [ 객체의 recurrence 유형] - Recurrence 데이터 모델 유형의 객체.

8_updateMeeting

Zoom: Create Meeting - Meeting 데이터 모델 유형의 개체를 만듭니다.
- Type [ enum ] - 회의 유형
  - Instant - 예약되지 않은 일회성 회의
  - Scheduled - 예정된 회의
  - Recurring with no fixed time 되풀이 - 시간이 없는 되풀이 모임
  - Recurring with fixed time 에 되풀이
- Password [ string ] - 회의 암호;
- Agenda [ string ] - 회의 의제 정보;
- Recurrence [ 객체의 recurrence 유형] - Recurrence 데이터 모델 유형의 객체.
- User_id [ string ] (필수) - 사용자의 ID 또는 이메일 주소.

9_createMeeting

Zoom: List meetings - 이 API 를 사용하여 사용자(회의 주최자)의 예약된 회의를 나열합니다. 사용자는 API_KEY 로 정의됩니다.
- Page_size [ integer ] - 단일 API 호출 내에서 반환된 레코드 수입니다. 기본적으로 30으로 설정됩니다.
- Page_number [ integer ] - 반환된 레코드에서 현재 페이지의 페이지 번호입니다. 기본적으로 1로 설정됩니다.

10_listMeetings

사용 예

버튼 클릭 시 Zoom 회의 링크를 생성하는 예를 살펴보겠습니다. 애플리케이션 프론트엔드에서 모듈의 비즈니스 프로세스를 사용하기 위해서는 먼저 Endpoint 를 설정하여 링크 생성( Zoom: Create meeting 생성)을 생성해야 합니다.

Endpoints 섹션에서 새 그룹을 만듭니다.
그룹이 생성되면 새 Endpoint 를 만들어야 합니다. Zoom: Create meeting 비즈니스 프로세스는 POST 유형의 요청으로 간주되어야 합니다.
웹 애플리케이션 비즈니스 프로세스에서 새로 생성된 엔드포인트는 아래 예시와 같이 사용할 수 있습니다. 여기에서 버튼을 클릭 ( onClick ) 하면 Label 컴포넌트의 Label 속성으로 링크가 생성되어 제공됩니다.