하나잉글리시 Zoom 연동 안내

하나잉글리시(HanaEnglish)는 1:1 화상 영어 수업 서비스입니다. 선생님이 본인의 Zoom 계정을 한 번 연결해 두면, 수업(체험수업 포함)이 예약될 때마다 하나잉글리시가 그 선생님의 Zoom 계정에 예약 미팅을 만들고, 수업 시간에 선생님과 학생 모두 하나잉글리시 앱 안에서 바로 입장할 수 있게 해 줍니다.

앱 추가하기 (선생님)

  1. 하나잉글리시에 선생님 계정으로 로그인합니다.
  2. 설정 → 화상 플랫폼 연결(선생님 메뉴 → 설정)을 엽니다.
  3. Zoom 연결 버튼을 누릅니다. Zoom 로그인·권한 동의 화면으로 이동합니다.
  4. 요청 권한을 확인하고 Allow(허용)를 누르면 하나잉글리시로 돌아오며, Zoom 카드가 연결됨으로 표시됩니다.

무료(Basic) Zoom 계정으로도 연결할 수 있습니다. 무료 계정은 참석자 리포트 API 를 제공하지 않으므로 출석은 선생님의 수업 리포트로 기록됩니다.

사용하기

  • 학생이 체험수업을 요청하면 선생님이 체험 요청 화면에서 이 시간으로 맡기를 누릅니다. 배정되는 순간 Zoom 미팅이 자동으로 만들어집니다.
  • 학원이 등록한 정규 수업도 같은 방식으로, 수업 전에 선생님 Zoom 계정에 미팅이 준비됩니다.
  • 수업 시작 15분 전부터 선생님은 홈 또는 수업 화면의 수업 입장, 학생은 일정 화면의 수업 입장 버튼으로 같은 Zoom 미팅에 들어갑니다.
  • 하나잉글리시는 선생님을 대신해 게시하거나 녹화·채팅을 읽지 않습니다.

요청하는 권한

권한사용 목적
meeting:write:meeting예약된 수업마다 선생님 계정에 Zoom 미팅을 생성
meeting:read:meeting생성된 미팅이 존재하는지 확인
user:read:user선생님의 Zoom 사용자 ID 와 요금제 종류를 읽어 계정을 연결

저장하는 정보

  • Zoom 사용자 ID, 계정 종류(무료/유료), 미팅 ID
  • OAuth 토큰과 미팅 참여 링크는 암호화된 상태로만 저장되며, 화면이나 로그에 평문으로 노출되지 않습니다.

앱 제거하기

  • 하나잉글리시에서: 설정 → 화상 플랫폼 연결 → Zoom 카드의 연결 해제를 누릅니다. 저장된 토큰은 삭제되어 더 이상 사용되지 않습니다.
  • Zoom 에서: Zoom App MarketplaceManageAdded Apps 에서 HanaEnglish 의 Remove 를 누릅니다.

지원