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