DK Platform - Zoom integration: end-to-end test plan (v2, 26 Oct 2026)

0. OVERVIEW

DK Platform (https://platform.donusumokulu.com) is a community platform for teachers and studios in Turkey. A teacher connects their own Zoom account once. When the teacher adds a live lesson to a community calendar and chooses Zoom, DK Platform creates the meeting in the teacher's Zoom account, updates it when the lesson changes and deletes it when the lesson is cancelled. The teacher opens the meeting as host with "Start lesson". Members see the join link on the lesson page shortly before the lesson. After a cloud-recorded lesson, members also see the recording link.

Language: the DK Platform interface is in Turkish only. Every on-screen label below is written as "Turkish" (English).

Time zone: the field "Tarih ve saat (İstanbul)" (Date and time, Istanbul) is always read as Istanbul time (UTC+3, no daylight saving), whatever your browser's time zone. Enter all times in Istanbul time.

English documentation: https://platform.donusumokulu.com/destek/zoom

1. PREREQUISITES

1.1 DK Platform test accounts

Sign in at https://platform.donusumokulu.com/hesap/giris. Fields: "E-posta adresin" (Email) and "Parolan" (Password). Button: "Giriş yap" (Sign in).

  • TEACHER (host role): <teacher e-mail> / <password>. Owner of the test community at https://platform.donusumokulu.com/meta-inceleme (address: meta-inceleme). During our pilot, only this test account can connect Zoom.
  • MEMBER (participant role): <member e-mail> / <password>. Active member of meta-inceleme, with a verified e-mail. This account cannot connect Zoom, open the community dashboard or start meetings.

Use two browsers, or one normal and one private window, so both accounts can stay signed in at the same time.

DK Platform has no 2FA and no CAPTCHA. You do not need access to either account's mailbox. Five wrong passwords in a row lock an account for 15 minutes ("Hesap geçici olarak kilitlendi").

The Teacher account holds one Zoom connection at a time. If several reviewers share it, connecting a second Zoom account replaces the first, and lessons created with the first account can then no longer be updated from DK Platform. Please run the whole plan with one Zoom account, or disconnect (5.1) before switching.

1.2 Plans and access: both DK Platform accounts are free. The test community is published (live), on a free pilot plan with all features, and closed to new sign-ups. No payment, card or subscription is needed. Please do not change the plan or community settings.

1.3 Zoom account (yours): you authorize the app with your own Zoom account. Your Zoom sign-in may ask for Zoom's own 2FA.

  • Free Zoom (Basic) is enough for every test except cloud recording. On Basic, meetings end after 40 minutes, so keep test lessons at 40 minutes or less.
  • Test G (cloud recording) needs Zoom Pro or higher, with Settings > Recording > Cloud recording turned on. On Basic you will see what G1 describes instead.
  • Optional local recording (G5) needs Local recording turned on and the Zoom desktop client.
  • The Member does not need a Zoom account.

1.4 Seed data: the Teacher account starts with no Zoom connection and no lessons in the calendar. The Member is already a member of the published community. You do not need anything else. Ignore the "Google (Google Meet)" row and option, which belong to a separate integration.

1.5 Expected limits: if two lessons in the same Zoom account overlap, the form shows a warning with "Yine de kaydet" (Save anyway) and "Vazgeç" (Cancel). Click "Yine de kaydet" or choose another time. When you reschedule from the List (E2), the same warning comes as a confirmation with a "Yeniden planla" (Reschedule) button. Zoom allows 100 meeting create/update requests per user per day.

2. SETUP AND AUTHORIZATION (Teacher)

2.1 Sign in as TEACHER. You land on "Hesabım" (My account).

2.2 Open the "Bağlı hesaplar" (Connected accounts) section: https://platform.donusumokulu.com/hesap#bagli-hesaplar. The Zoom row says "Bağlı değil" (Not connected) and shows a notice: the title, time and duration of your lessons and online events are transferred to Zoom in the USA, and no member data is sent. The link "Ayrıntı" (Details) opens section 8 of the Privacy Policy (Turkish). Section 11 of the same policy is its English summary.

2.3 Click "Zoom’u bağla" (Connect Zoom) without ticking the box. Expected: the browser does not submit the form, because the consent box is required.

2.4 Tick "Okudum, bu aktarımı onaylıyorum." (I have read and consent to this transfer.) and click "Zoom’u bağla" (Connect Zoom). You are redirected to Zoom's authorization page.

Important: always start authorization with this button in DK Platform. A flow started on Zoom's side carries no DK Platform state, so DK Platform rejects it. That includes the Marketplace listing's Add or Visit-site preview, the app's Authorization URL and Local test. You then return to My account with "Bağlantı doğrulanamadı" (Connection could not be verified). No connection is saved, although the app may still appear in Zoom under Manage > Added Apps. If this happens, remove the app in Zoom and start again at step 2.4.

2.5 Sign in to Zoom and click Allow. Finish within 10 minutes, in the same browser, while still signed in to DK Platform as the Teacher. Otherwise the authorization state is rejected with "Bağlantı doğrulanamadı".

Expected: you return to My account with a green notice "Zoom bağlandı" (Zoom connected). The Zoom row now says "Bağlı · <your Zoom e-mail> · <date>" (Connected) and shows a "Bağlantıyı kes" (Disconnect) button.

Negative check (optional): if you click Decline on Zoom's page and Zoom sends you back to DK Platform, the notice is "Bağlama yarıda kaldı" (Connection interrupted) and the row stays "Bağlı değil" (Not connected).

3. SCOPE-BY-SCOPE TESTS (Teacher)

All six scopes are required; none is marked optional in the app. Steps marked "(Optional)" below are extra checks, not optional scopes.

Dashboard calendar: https://platform.donusumokulu.com/meta-inceleme/yonetim/takvim. It opens in the "Ay" (Month) view. The "Liste" (List) tab is https://platform.donusumokulu.com/meta-inceleme/yonetim/takvim?gorunum=liste. It has two sub-tabs: "Yaklaşan" (Upcoming) for lessons that have not started yet, and "Geçmiş" (Past) for lessons that have started or ended.

A. user:read:user (GET /v2/users/me)

A1. After step 2.5, the Zoom row shows the e-mail of the Zoom account you authorized.

A2. In the calendar, click "Yeni oturum" (New session). Under "Katılım bağlantısı" (Join link), select "Otomatik oluştur" (Create automatically). Expected preview: "Zoom: <name>@… hesabında açılır (senin hesabın)." (Will be created in <name>@…, your account). Close the drawer, or go on to B.

The Zoom user ID read here is also used to match the app_deauthorized event (test 5.2).

Without this scope the connection still works, using the user ID in the access token, but no e-mail is shown and the preview says "bağlı hesapta açılır" (created in the connected account).

B. meeting:write:meeting (POST /v2/users/me/meetings)

B1. Click "Yeni oturum" (New session).

B2. Fill in:

  • "Başlık" (Title): Zoom test 1
  • "Tarih ve saat (İstanbul)": today, about 30 minutes from now, in Istanbul time
  • "Süre (dakika)" (Duration, minutes): 30
  • "Haftalık tekrar" (Weekly repeat): "Tek oturum" (Single session)
  • "Erişim" (Access): "Üyelere özel" (Members only)
  • "Eğitmen" (Instructor): leave "— seçilmedi —" (none selected), so the meeting is hosted in your own Zoom.

B3. Under "Katılım bağlantısı" (Join link), select "Otomatik oluştur" (Create automatically). For a new lesson the default is "Kendim yapıştıracağım" (I'll paste it myself), which does not create a meeting. Keep "Zoom" in the tool dropdown. Set "Kayıt alınsın mı?" (Record this lesson?) to "Hayır" (No). Leave "Bağlantı kaç dakika önce açılsın (0–240)" (How many minutes before the start the link opens to members) at 20.

B4. Click "Kaydet" (Save).

Expected:

  • Toast: "Oturum eklendi. Bağlantı oluşturuldu: <short Zoom join link> — üyeler ders sayfasında 20 dk önce görür." (Session added. Link created; members see it on the lesson page 20 minutes before.)
  • In "Liste" (List) > "Yaklaşan" (Upcoming), the row shows "Zoom · otomatik" (Zoom · automatic) and a "Kopyala" (Copy) button for the join link.
  • In Zoom (web) > Meetings > Upcoming, a meeting named "Zoom test 1" appears with the same start time and a 30-minute duration.
  • Only the topic, start time, duration, time zone (Europe/Istanbul) and auto-recording setting are sent to Zoom. No invitees are added.

C. meeting:update:meeting (PATCH /v2/meetings/{meetingId})

C1. In "Liste" (List), on the "Zoom test 1" row, click "Düzenle" (Edit). The drawer "Oturumu düzenle" (Edit session) shows the current link under "Oluşturulan bağlantı:" (Created link).

C2. Change "Başlık" (Title) to "Zoom test 1 edited", move the start 15 minutes later and set the duration to 35. Click "Kaydet" (Save).

Expected: the toast starts with "Güncellendi. Bağlantı: …" (Updated. Link: …). In Zoom, the SAME meeting (same meeting ID and join URL) shows the new title, time and duration.

C3. (Optional) If you change only fields that Zoom does not store (for example "Açıklama" (Description)), the lesson saves and no Zoom request is made.

D. meeting:read:meeting (GET /v2/meetings/{meetingId}) - Start lesson as host

D1. Open the lesson page: in "Liste" (List), click the "/<slug>" link under the lesson title. The URL looks like https://platform.donusumokulu.com/meta-inceleme/takvim/<slug>.

D2. Click "Dersi başlat" (Start lesson). A new tab opens, and the button briefly shows "Açılıyor…" (Opening…).

Expected: Zoom (app or web) opens the meeting with you as host. DK Platform fetches the host start URL only at the moment of the click and never stores it. You can end the meeting.

Note: the button stays on the lesson page until the scheduled end. In the dashboard it appears only in "Liste" (List) > "Yaklaşan" (Upcoming), so only before the start time, and never in "Ay" (Month). Use the lesson page.

D3. DK Platform also uses this scope when you edit a Zoom lesson whose "Kayıt alınsın mı?" (Record this lesson?) is not "Hayır" (No) and you change its title, time, duration or recording option, or when you click "Yeniden dene" (Retry) on such a lesson. After the update, DK Platform reads the meeting back to check the auto-recording setting Zoom applied. If Zoom did not apply cloud recording, the List row shows "Bu Zoom hesabında bulut kaydı yok; 'bilgisayara' seçin." (This Zoom account has no cloud recording; choose 'to the computer'.) When a lesson is first created, DK Platform reads this setting from Zoom's create response, so no extra read is made.

E. meeting:delete:meeting (DELETE /v2/meetings/{meetingId})

E1. Create "Zoom test 2" as in B, for tomorrow at 12:00 Istanbul time. In "Liste" (List), on its row, click "İptal" (Cancel) and confirm with "İptal et" (Cancel it).

Expected: toast "Oturum iptal edildi." (Session cancelled.) and status badge "İptal" (Cancelled). The meeting disappears from Zoom > Upcoming. The lesson itself is kept as cancelled. Test 4.8 checks what the member sees for a cancelled lesson.

E2. (Optional, uses meeting:write:meeting) On the same row, click "Yeniden planla" (Reschedule). Expected: toast "Yeniden planlandı." (Rescheduled.) and a NEW Zoom meeting with a new join URL.

E3. (Optional) Edit a Zoom lesson (for example one of the F1 lessons), select "Kendim yapıştıracağım" (I'll paste it myself) and click "Kaydet" (Save). Expected: the meeting is deleted in Zoom. The lesson shows the badge "Bağlantı yok" (No link) unless you pasted a link.

E4. (Optional) Permanent delete: click "Sil" (Delete) in "Liste" (List), or "Dersi kalıcı sil" (Delete lesson permanently) in the edit drawer, and confirm with "Sil" (Delete). Expected: toast "Ders silindi." (Lesson deleted.) and the meeting is deleted in Zoom. Permanent delete is blocked once a member has added the lesson to their calendar; use "İptal" (Cancel) in that case.

F. Weekly repeat (meeting:write:meeting, once per lesson)

F1. Click "Yeni oturum" (New session). Set the title to "Weekly test", tomorrow at 15:00 Istanbul time, 30 minutes, "Haftalık tekrar" (Weekly repeat) = "3 hafta, aynı saat" (3 weeks, same time), and "Otomatik oluştur" (Create automatically) with Zoom. Click "Kaydet" (Save).

Expected: toast "3 haftalık oturum eklendi. Bağlantılar oluşturuldu — üyeler ders sayfasında 20 dk önce görür." (3 weekly sessions added. Links created.) Zoom > Upcoming lists 3 separate meetings, not a Zoom recurring meeting, each with its own join URL. Editing or cancelling one lesson changes only its own meeting.

G. cloud_recording:read:list_recording_files (GET /v2/meetings/{meetingId}/recordings). Required scope; observing the recording link needs a paid Zoom plan (Pro or higher) with cloud recording on.

G1. Click "Yeni oturum" (New session). Title "Recording test", start in about 10 minutes, "Süre (dakika)" (Duration) 10, "Erişim" (Access) "Üyelere özel" (Members only), "Otomatik oluştur" (Create automatically) with Zoom, "Kayıt alınsın mı?" (Record this lesson?) = "Evet, Zoom bulutuna (ücretli Zoom gerekir)" (Yes, to the Zoom cloud; paid Zoom required). Click "Kaydet" (Save).

Expected on Zoom Pro: the meeting is created with automatic cloud recording (visible in the meeting's settings in Zoom). The lesson page shows the badge "Bu ders kaydedilir" (This lesson is recorded). The List row shows "Kayıt: Zoom bulutuna" (Recording: Zoom cloud).

Expected on Zoom Basic: Zoom does not apply cloud recording. The toast should end with "Not: Bu Zoom hesabında bulut kaydı yok; 'bilgisayara' seçin." (Note: this Zoom account has no cloud recording; choose 'to the computer'.) The List row shows the same note with a "Yeniden dene" (Retry) button; retrying does not change it. No recording link will appear. After the lesson ends, the row (under "Geçmiş" (Past)) shows "Kayıt bekleniyor (Zoom işliyor)" (Waiting for recording), and from 72 hours after the end it shows "Kayıt bulunamadı" (Recording not found). You can skip G2 to G4.

G2. On the lesson page, click "Dersi başlat" (Start lesson). Zoom starts cloud recording automatically and announces it. Talk for 1 to 2 minutes, then end the meeting for all.

G3. Wait. DK Platform checks every 15 minutes. The first check is 10 minutes after the SCHEDULED end (start + duration); ending the meeting early does not make it sooner. The link appears at the first check after Zoom has finished processing. With a 10-minute lesson, expect roughly 20 to 35 minutes after the scheduled start, plus Zoom's processing time. The lesson has started, so its row is now in "Liste" (List) > "Geçmiş" (Past). The row changes from "Kayıt bekleniyor (Zoom işliyor)" (Waiting for recording; Zoom is processing) to "Kayıt hazır (ders sayfasında “Kaydı izle”)" (Recording ready). If nothing is found 72 hours after the scheduled end, the row shows "Kayıt bulunamadı" (Recording not found).

G4. On the lesson page (Teacher, or the Member as in 4.7), click "Kaydı izle (Zoom)" (Watch recording, Zoom). Expected: the recording opens in Zoom's web player with the viewing passcode included. If Zoom returns only a manual passcode, the page shows "Zoom kayıt parolası: …" (Zoom recording passcode). DK Platform never downloads the recording files.

If this scope is not granted: the Zoom row in Connected accounts shows "Kayıt bağlantısı için Zoom'u yeniden bağla…" (Reconnect Zoom for the recording link) with a "Yeniden bağla" (Reconnect) button. Everything else works.

G5. (Optional, local recording) Set "Kayıt alınsın mı?" (Record this lesson?) to "Evet, bilgisayara" (Yes, to the computer). Expected: the meeting gets auto-recording = local, the List row shows "Kayıt: bilgisayara" (Recording: computer), and the Zoom desktop client saves the recording. No link comes back to DK Platform. If recording is turned off in that Zoom account, the toast and the row show "Bu Zoom hesabında kayıt kapalı; Zoom ayarlarından kaydı açın." (Recording is off in this Zoom account; turn it on in Zoom settings.)

4. MULTI-USER FLOW (Teacher + Member)

4.1 TEACHER: create "Member join test" as in B: today, about 2 hours from now, 30 minutes, "Erişim" (Access) "Üyelere özel" (Members only), "Otomatik oluştur" (Create automatically) with Zoom, and "Bağlantı kaç dakika önce açılsın" left at 20. Click "Kaydet" (Save). Note the lesson page URL (/meta-inceleme/takvim/<slug>).

4.2 MEMBER, in the second browser: sign in and open https://platform.donusumokulu.com/meta-inceleme/takvim, click the lesson and then "Oturum sayfası" (Session page). You can also open the lesson URL directly.

Expected: there is no join button and no "Dersi başlat" (Start lesson) button. The page says "Katılım bağlantısı oturumdan 20 dakika önce bu sayfada açılır — yaklaşık … sonra." (The join link opens on this page 20 minutes before the session, in about …). The join URL is not in the page source.

4.3 TEACHER: on this lesson click "Düzenle" (Edit), set "Bağlantı kaç dakika önce açılsın (0–240)" to 240 and click "Kaydet" (Save). This change makes no Zoom request. Instead, you can also wait until 20 minutes before the start.

4.4 MEMBER: reload the lesson page. Expected: an "Oturuma katıl" (Join session) button appears and opens the Zoom join URL in a new tab.

Note: the Teacher always sees the link, with the note "Ekip görünümü: …" (Staff view), so check the gating with the Member account.

4.5 TEACHER: on the lesson page click "Dersi başlat" (Start lesson); you are the host. MEMBER: click "Oturuma katıl" (Join session). Expected: the Member joins as a participant. The host's own Zoom settings, such as the waiting room, still apply.

4.6 The Member cannot act as host or manage Zoom:

If the Member's signed-in browser calls the start endpoint directly, it returns 403 with "Dersi yalnız toplantının açıldığı Zoom hesabının sahibi başlatabilir (ev sahibi bağlantısı başka kimseye verilmez)." (Only the owner of the Zoom account the meeting was created in can start the lesson; the host link is not given to anyone else.)

Host link rule: the host start link is given ONLY to the DK Platform user who connected the Zoom account the meeting was created in. Even the community owner or the lesson's instructor does not see "Dersi başlat" (Start lesson) when the meeting lives in someone else's Zoom account; the lesson page then says "Bu dersin toplantısı başka birinin Zoom hesabında açıldı…" (This lesson's meeting was created in someone else's Zoom account…) and they join with the join link like everyone else.

4.7 After the scheduled end, the Member's lesson page says "Bu oturum tamamlandı." (This session has ended.) For the cloud-recorded lesson from test G, the Member sees "Kaydı izle (Zoom)" (Watch recording) once the recording is ready.

4.8 Cancelled lesson. TEACHER: create "Cancel test" as in B, for tomorrow at 10:00 Istanbul time. In "Liste" (List), copy its lesson URL from the "/<slug>" link, then click "İptal" (Cancel) and confirm with "İptal et" (Cancel it). MEMBER: open that URL directly; cancelled lessons are not listed in the member calendar. Expected: "Bu oturum iptal edildi." (This session was cancelled.) and no join button. The Zoom meeting is deleted, as in E1.

5. DEAUTHORIZATION

5.1 Disconnect in DK Platform: as TEACHER, open "Hesabım" (My account) > "Bağlı hesaplar" (Connected accounts) > Zoom, click "Bağlantıyı kes" (Disconnect) and confirm with "Kaldır" (Remove).

Expected:

  • The row goes back to "Bağlı değil" (Not connected).
  • DK Platform revokes the token at Zoom (POST /oauth/revoke). DK Platform should then no longer appear under Zoom App Marketplace > Manage > Added Apps.
  • The stored connection and both tokens are deleted.
  • Meetings that were already created stay in Zoom and keep working. From now on, an affected lesson's row in "Liste" (List, Bağlantı column) shows a note instead of a Zoom change:
    • after cancelling: "Bağlantı kaldırıldığı için Zoom'daki toplantı platformdan silinemedi; gerekirse kendin sil." (could not be deleted from the platform; delete it yourself if needed);
    • after changing the title, time or duration: "Bağlantı kaldırıldığı için Zoom'daki toplantı güncellenemedi; …" (could not be updated).

    "Dersi başlat" (Start lesson) shows "Zoom bağlantısı kaldırılmış; dersi Zoom uygulamasından başlat." (The Zoom connection was removed; start the lesson from the Zoom app.)

5.2 Remove the app in Zoom (app_deauthorized webhook): first reconnect with steps 2.2 to 2.5, starting from DK Platform. Then open Zoom App Marketplace > Manage > Added Apps > DK Platform and click Remove.

Expected: Zoom sends app_deauthorized to https://platform.donusumokulu.com/api/zoom/bildirim. DK Platform verifies the x-zm-signature header and deletes the connection and tokens. When you reload "Hesabım" (My account), the Zoom row says "Bağlı değil" (Not connected). Meetings stay in Zoom.

5.3 (Optional) If you reconnect the SAME Zoom user, existing lessons are attached again, and editing and cancelling update Zoom again.

6. DATA HANDLED

  • Sent to Zoom: the lesson title, start time, duration, time zone and auto-recording setting. No attendees, no invitations and no member data are sent.
  • Stored: the Zoom user ID and e-mail, the granted scopes, and the access and refresh tokens (encrypted with AES-256-GCM, refreshed automatically). For each lesson: the meeting ID, the join URL and, for cloud recordings, the share link and viewing passcode (the passcode is encrypted).
  • Never stored: the host start URL and the recording files.
  • Shown only to the community's staff and to members with access to the lesson. Members see the join link only inside its time window.
  • Deleted immediately: the connection and both tokens, when the user disconnects, removes the app in Zoom or closes their DK Platform account.
  • Not shared with third parties, not sold and not used for advertising or AI training.

7. SUPPORT

E-mail: iletisim@donusumokulu.com · Support: https://platform.donusumokulu.com/destek · Zoom guide: https://platform.donusumokulu.com/destek/zoom