연동 가이드 · Integration Guide

TimeOkay × Zoom

예약이 확정되면 호스트의 Zoom 계정으로 회의를 자동으로 만들고, 참가 링크를 예약 확정 안내에 넣어 줍니다.

1. 준비 사항

  • 타임오케이 계정 (가입 후 Basic 14일 체험 포함)
  • Zoom 계정 (무료 계정도 가능. 무료 계정은 Zoom 정책에 따라 회의 시간이 제한될 수 있습니다)

2. 연결하기 (앱 추가)

  1. 타임오케이에 로그인한 뒤 왼쪽 메뉴에서 서비스 연동을 엽니다.
  2. Zoom 카드를 누르고 연동하기를 클릭합니다.
  3. Zoom 로그인 화면이 열리면 사용할 Zoom 계정으로 로그인합니다.
  4. 요청 권한(사용자 정보 보기, 회의 생성)을 확인하고 Allow를 누릅니다.
  5. 타임오케이로 돌아오면 Zoom 카드에 연결된 계정 이메일이 표시됩니다.

요청하는 권한은 user:read:user(연결된 Zoom 계정 확인)와 meeting:write:meeting(예약 회의 생성) 두 가지뿐입니다.

3. 사용하기

  1. 왼쪽 메뉴 미팅에서 이벤트 유형을 만들거나 수정합니다.
  2. 미팅 방법을 Zoom으로 선택하고 저장합니다.
  3. 게스트가 예약 페이지에서 시간을 선택해 예약을 확정하면, 타임오케이가 호스트의 Zoom 계정에 그 시간의 회의(예약된 회의, 한국 시간 기준)를 만듭니다.
  4. Zoom 참가 링크는 게스트와 호스트에게 가는 예약 확정 안내 메일과, 호스트가 캘린더 연동을 켜 둔 경우 캘린더 일정(장소·설명)에 들어갑니다.

회의 제목은 이벤트 이름, 회의 길이는 이벤트의 진행 시간으로 정해집니다. 회의는 Zoom 앱에서 평소처럼 수정하거나 삭제할 수 있습니다.

4. 연결 해제 · 앱 제거

타임오케이에서 해제

  1. 서비스 연동 → Zoom 카드에서 연동 해제를 누릅니다.
  2. 타임오케이는 Zoom에 토큰 폐기(revoke)를 요청하고, 저장된 Zoom 토큰을 즉시 삭제합니다.

Zoom에서 앱 제거

  1. Zoom App Marketplace에 로그인합니다.
  2. Manage → Added Apps에서 TimeOkay를 찾습니다.
  3. Remove를 누릅니다.

Zoom에서 앱을 제거하면 Zoom이 타임오케이에 제거 알림을 보내고, 타임오케이는 해당 계정의 Zoom 토큰을 삭제합니다. 이미 만들어진 Zoom 회의는 Zoom 계정에 그대로 남습니다.

앱을 제거한 뒤에도 미팅 방법이 Zoom인 이벤트에는 회의 링크가 만들어지지 않으니, 다른 미팅 방법으로 바꾸거나 다시 연결해 주세요.

5. 데이터 처리

  • 사용하는 Zoom 데이터: 연결된 Zoom 계정의 이메일(연결 상태 표시용), 타임오케이가 만든 회의의 참가 링크
  • 저장 방식: Zoom 액세스·리프레시 토큰은 AES-256-GCM으로 암호화해 저장하고, 모든 통신은 HTTPS로 합니다.
  • 사용 범위: 예약 확정 시 회의를 만드는 데만 사용합니다. 기존 회의, 녹화, 채팅, 연락처는 조회하지 않습니다.
  • 삭제: 연동 해제, Zoom 앱 제거, 회원 탈퇴 시 Zoom 토큰을 삭제합니다.
  • 자세한 내용은 개인정보처리방침과 이용약관을 확인해 주세요.

6. 문제 해결

예약했는데 Zoom 링크가 없어요
서비스 연동에서 Zoom이 연결되어 있는지, 이벤트의 미팅 방법이 Zoom인지 확인해 주세요. Zoom에서 앱을 제거했다면 다시 연결해야 합니다.
연결 중 오류가 나요
Zoom 로그인 화면에서 Allow 대신 취소하면 연결되지 않습니다. 다시 연동하기를 눌러 진행해 주세요. 회사 Zoom 계정은 관리자가 외부 앱 설치를 막아 두었을 수 있습니다.
다른 Zoom 계정으로 바꾸고 싶어요
연동 해제 후 원하는 Zoom 계정으로 다시 연결하면 됩니다.

7. 문의

이메일 [email protected] 또는 도입문의 페이지로 연락해 주세요. 영업일 기준으로 순서대로 답변드립니다.

English

1. Prerequisites

  • A TimeOkay account (new accounts include a 14-day Basic trial)
  • A Zoom account (free accounts work; meeting length limits follow Zoom's own plan rules)

2. Adding the app

  1. Sign in to TimeOkay and open 서비스 연동 (Integrations) in the left menu.
  2. Click the Zoom card, then click 연동하기 (Connect).
  3. Sign in to the Zoom account you want to use.
  4. Review the requested permissions (view user, create meetings) and click Allow.
  5. You are returned to TimeOkay and the connected Zoom email is shown on the Zoom card.

TimeOkay requests only two scopes: user:read:user (identify the connected Zoom account) and meeting:write:meeting (create scheduled meetings).

3. Usage

  1. Open 미팅 (Meetings) and create or edit an event type.
  2. Set 미팅 방법 (Meeting method) to Zoom and save.
  3. When a guest books a time on your booking page, TimeOkay creates a scheduled meeting for that time (Asia/Seoul time zone) in your Zoom account.
  4. The Zoom join link is included in the booking confirmation sent to the guest and the host, and, if you have calendar sync turned on, in the calendar event (location and description).

The meeting topic is the event name and the duration is the event length. You can edit or delete the meeting in Zoom as usual.

4. Removing the app

Disconnect in TimeOkay

  1. Go to Integrations → Zoom and click 연동 해제 (Disconnect).
  2. TimeOkay asks Zoom to revoke the token and deletes the stored Zoom tokens immediately.

Remove from Zoom

  1. Sign in to the Zoom App Marketplace.
  2. Go to Manage → Added Apps and find TimeOkay.
  3. Click Remove.

When the app is removed in Zoom, Zoom sends a deauthorization notice and TimeOkay deletes the Zoom tokens for that account. Meetings already created stay in your Zoom account.

After removal, events whose meeting method is Zoom will no longer get a meeting link; switch them to another method or reconnect Zoom.

5. Data handling

  • Zoom data used: the connected account's email (to show connection status) and the join link of meetings TimeOkay creates.
  • Storage: Zoom access and refresh tokens are encrypted at rest with AES-256-GCM; all traffic uses HTTPS.
  • Purpose: used only to create a meeting when a booking is confirmed. TimeOkay does not read existing meetings, recordings, chats or contacts.
  • Deletion: Zoom tokens are deleted on disconnect, on app removal in Zoom, and on account deletion.
  • See our Privacy Policy and Terms of Service.

6. Troubleshooting

A booking has no Zoom link
Check that Zoom is connected under Integrations and that the event's meeting method is Zoom. If you removed the app in Zoom, connect it again.
An error appears while connecting
Clicking cancel instead of Allow on the Zoom screen leaves the account unconnected; click Connect again. Your Zoom admin may also block third-party apps on company accounts.
I want to use a different Zoom account
Disconnect, then connect again with the other Zoom account.

7. Support

Email [email protected] or use our contact page. We reply in order on business days.