Zoom App 연동
Zoom용 ScribX 앱은 Zoom 계정을 ScribX에 연결해 회의 캡처·전사·요약을 더 매끄럽게 만듭니다. ScribX 노트테이커가 녹화 권한을 자동으로 받고, 사용자를 대신해 참가할 수 있습니다.
이 페이지에 필요한 내용이 모두 있습니다: 앱 추가, 기능별 사용법, 앱 제거, 문제 해결.
그렇다면 이 연동은 필요 없습니다 — 봇 보내기는 계정 연결 없이 바로 작동합니다. 녹화 권한 자동 획득이나 대리 참가가 필요할 때 Zoom 앱을 연결하세요.
앱 추가
사전 요건
- 최소 한 개 팀에 소속된 ScribX 계정(없다면 가입).
- Zoom 계정(플랜 무관). Zoom 관리자가 앱 설치를 제한한다면 Zoom Marketplace에서 ScribX를 사전 승인해야 할 수 있습니다.
단계
- ScribX에 로그인하고 팀 설정 → 통합을 엽니다.
- Zoom 섹션에서 Zoom 연결하기를 클릭합니다.
- zoom.us로 이동해 (로그인이 안 되어 있다면) 로그인하고, ScribX가 요청하는 권한이 표시됩니다.
- 권한을 확인한 뒤 Allow를 클릭합니다.
- ScribX로 돌아옵니다. 통합 탭의 연결된 계정에 Zoom 계정이 표시되면 설정 완료입니다.
자신의 Zoom 계정으로 ScribX를 사용하려는 팀원은 각자 자기 Zoom 로그인으로 같은 단계를 반복합니다. 연결은 사용자 단위이며 그 사용자의 모든 팀에서 보입니다.
설정 중 문제가 있나요? 아래 문제 해결을 참고하세요.
조직 관리자용
조직이 어떤 Zoom Marketplace 앱으로 연결할지는 조직 관리자가 조직 설정 → 회의 플랫폼 → Zoom에서 선택합니다:
- ScribX 앱(기본) — Zoom Marketplace에 게시된 공유 ScribX 앱입니다. 설정할 것이 없으며, 멤버는 위 안내대로 연결하기만 하면 됩니다.
- 자체 Zoom 앱 — 조직 소유의 Zoom OAuth 앱을 사용합니다. Client ID, Client secret, (선택) webhook secret을 입력한 뒤 계정 연결을 클릭합니다. 팀은 팀 설정 → 통합에서 팀 단위 앱으로 재정의할 수도 있습니다.
연동 사용하기
녹화 권한 자동 획득
사용 사례: 보통은 봇이 Zoom 회의에 참가하면 호스트가 회의 중에 녹화 권한을 부여해야 합니다. Zoom 계정이 연결되어 있으면 ScribX가 Zoom에서 local recording token을 받아오므로, 노트테이커가 호스트에게 묻지 않고 녹화를 시작하고 대기실도 건너뛸 수 있습니다.
사전 요건: 회의 호스트(또는 봇 생성자)가 Zoom 계정을 연결한 사용자이고, 그 계정의 플랜이 local recording token을 지원해야 합니다.
기대 결과: ScribX 노트테이커가 참가해 대기실을 통과하고 즉시 녹화를 시작합니다 — 호스트에게 권한 요청 창이 뜨지 않습니다.
대리 참가(on-behalf)
사용 사례: ScribX는 연결된 Zoom 계정에 묶인 on-behalf 토큰으로 참가할 수 있어, 사용자가 참석하는 회의에서 노트테이커의 식별과 입장이 더 원활해집니다.
사전 요건: 연결된 Zoom 계정이 on-behalf 토큰을 지원하고(통합 탭에 OBF 배지 표시), 본인이 회의 참가자여야 합니다. 여러 팀원이 연결되어 있으면 ScribX는 노트테이커를 예약한 사람의 계정, 다음으로 회의 호스트, 마지막으로 팀 기본값 순으로 선택합니다.
기대 결과: 노트테이커가 완전한 익명 참가자가 아니라 사용자 계정과 연결된 상태로 참가합니다.
회의 자동 인식
사용 사례: 연결하면 ScribX가 사용자가 만든 회의를 파악합니다(Zoom의 meeting.created 이벤트와 예정된 회의의 주기적 동기화). 회의가 자동으로 사용자 계정과 매칭되어 위 두 기능이 올바른 사람을 선택할 수 있게 됩니다.
사전 요건: 연결된 계정 외에는 없습니다. 백그라운드에서 동작합니다.
기대 결과: 사용자가 호스트하는 회의가 사용자의 연결에 귀속됩니다. 다른 기능이 올바르게 동작하는 것 외에 별도의 UI는 없습니다.
앱 제거
언제든 Zoom 쪽에서 연결을 해제할 수 있습니다:
- Zoom App Marketplace에 로그인합니다.
- Manage → Added Apps를 클릭합니다(또는 설치된 앱을 엽니다).
- ScribX를 찾아 Remove를 클릭합니다.
앱을 제거하면 일어나는 일 — 권한을 해제하는 즉시 Zoom이 ScribX에 알리고, ScribX는 곧바로 다음을 수행합니다:
- Zoom OAuth 토큰을 삭제합니다. ScribX는 더 이상 어떤 방식으로도 Zoom 계정에 접근할 수 없습니다.
- Zoom 계정에서 학습한 회의-계정 매핑을 삭제합니다.
- 데이터 삭제를 Zoom에 확인 통보합니다(Zoom 데이터 컴플라이언스 알림) — 24시간 이내.
이후 ScribX의 연결은 연결 해제됨으로 표시됩니다. 이미 캡처된 녹화·전사·요약은 Zoom 앱을 제거해도 삭제되지 않습니다 — ScribX 워크스페이스에 속하며 팀의 데이터 보존 설정을 따르고, 언제든 직접 삭제할 수 있습니다. 회의는 위 기능들의 혜택만 사라질 뿐, 봇 보내기는 연동 없이도 계속 작동합니다.
자체 Zoom 앱 모드를 쓰는 조직 관리자는 조직 설정 → 회의 플랫폼 → Zoom → 앱 제거에서 조직 수준 앱도 제거할 수 있습니다. 그러면 팀은 관리형 ScribX 앱으로 되돌아갑니다.
나중에 다시 연결하려면 앱 추가를 반복하면 됩니다.
문제 해결
- Allow 화면에서 오류가 나거나 잘못된 페이지로 이동 — 조직이 자체 Zoom 앱 모드인데 자격 증명이 불완전할 수 있습니다. 조직 관리자에게 조직 설정 → 회의 플랫폼 → Zoom 확인을 요청하거나 ScribX 앱 모드로 되돌리세요.
- "Zoom 연결하기"가 보이지 않음 — 팀의 통합 탭에 접근 권한이 없을 수 있습니다. 팀 관리자에게 문의하세요.
- 노트테이커가 여전히 호스트에게 녹화 권한을 요청 — 회의 호스트가 연결된 계정이 아니거나, 호스트의 Zoom 플랜이 local recording token을 발급하지 않습니다. 호스트의 Zoom 계정을 연결하거나 평소처럼 회의 중에 권한을 부여하세요.
- 그 밖의 문제 — 일반 문제 해결 가이드를 보거나 support@scribx.app으로 메일 주세요.