줌 모듈 사용 방법

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

Zoom Module 설치

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

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

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 ] - 회의 암호;

• 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 ] - 회의 암호;

• 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 키와 함께 사용할 수 없습니다.

• 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 키와 함께 사용할 수 없습니다.

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

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

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

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

• 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 데이터 모델 유형의 객체.

• 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 또는 이메일 주소.

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

사용 예

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

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

결과는 아래와 같습니다.