# Zoom 트랜스크립트 통합 특정 Zoom 사용자가 주최한 회의에 대해 Botpress Zoom 회의 기록을 쉽게 수신하고 자동화할 수 있습니다. ## 작동 방식 1. **Zoom 미팅 종료** → 녹취록이 준비되면 Zoom에서 webhook 보냅니다. 2. **통합 필터 '호스트_ID'** → 지정된 Zoom 사용자의 이벤트만 허용합니다. 3. **대본 가져오기 및 정리** → Zoom에서 다운로드하여 일반 텍스트로 변환합니다. 4. **이벤트 전송됨** → 플로우에서 '미팅UUID'와 '트랜스크립트'가 포함된 `transcriptReceived` 이벤트를 사용할 수 있습니다. --- ## 사용법 - 워크플로우 트리거** → '트랜스크립트 수신'에 대한 '이벤트 듣기' 카드를 추가합니다. - 데이터에 액세스** → 플로우에서 `event.payload.meetingUUID` 및 `event.payload.transcript`를 사용합니다. - 기록 저장** → 나중에 분석 또는 보고를 위해 테이블에 저장합니다. --- ## 전제 조건 반드시 필요합니다: - Zoom **계정 소유자**, **관리자**이거나 **"개발자용 Zoom" 역할**을 보유해야 Zoom OAuth 앱을 만들 수 있습니다. - Zoom 프리미엄 요금제** 사용 중(무료 티어는 클라우드 녹화를 지원하지 않음) --- 단계별 설정 ## 단계별 설정 ### 1. Zoom OAuth 앱 만들기 - 방문: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - 개발 > 앱 빌드**로 이동 → **서버 간 OAuth** 선택 → 앱 이름을 지정합니다. - 앱 자격증명** 페이지에서 복사합니다: - **계정 ID** - **클라이언트 ID** - **클라이언트 비밀** 나중에 Botpress 연동 구성에서 이 정보를 사용하게 됩니다. - 정보**에서 본인 및 앱에 대한 필수 정보를 입력합니다. - 기능**에서 **비밀 토큰**을 복사합니다. - 범위**에 추가합니다: cloud_recording:읽기:목록_사용자_기록:관리자 cloud_recording:읽기:목록_녹음_파일:관리자 cloud_recording:읽기:녹음:관리자 - 활성화** 탭에서 앱을 활성화합니다. ### 2. Zoom `host_id` 가져오기 Zoom 웹 포털에서 직접 Zoom `host_id`를 찾을 수 있습니다. #### 단계: 1. Zoom 계정에 로그인하고 다음으로 이동합니다: **Zoom 관리자 패널 > 사용자 관리 > 사용자**로 이동합니다. 2. '호스트 ID'를 얻으려는 사용자의 이름을 클릭합니다. 3. 브라우저의 주소창에서 URL을 확인합니다. 다음과 같은 형식일 것입니다: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile 호스트 아이디인 xxxxxxxxxxx를 복사하려고 합니다. --- ### 3. Botpress 연동 구성 - 봇에 이 연동 기능을 설치하세요. - 붙여넣기: - `Zoom 클라이언트 ID` - `Zoom 클라이언트 비밀` - `Zoom 계정 ID` - `시크릿 토큰` - 허용된 Zoom 사용자 ID` → `host_id` 붙여넣기(여러 개 포함 가능) 구성 저장**을 클릭합니다. --- ### 4. Zoom에서 Webhook 설정 Zoom OAuth 앱으로 돌아갑니다: - **기능** → **이벤트 구독 활성화**로 이동합니다. - 이름: '성적표 수신'(다른 이름도 선택 가능) - 방법: Webhook - 엔드포인트 URL: Botpress 연동 URL** 사용 - 이벤트 추가: - **녹음** 아래 - `모든 녹음이 완료되었습니다` - 녹취록 파일 녹음이 완료되었습니다`. - 완료**를 클릭합니다. - 엔드포인트 URL 옆의 **검증**을 클릭합니다(유효성 검사됨이 표시되어야 합니다). - 저장**을 클릭합니다. --- ## 완료! 이제 클라우드 녹화가 완료되면 Botpress 봇이 허용된 Zoom 사용자의 녹취록을 수신합니다. 확인하세요: - 클라우드에 **녹화하고 있습니다**. - 유료 Zoom 요금제를 **사용 중**입니다. - 의도한 모든 '호스트 ID'를 올바르게 추가했습니다.