LUDIBOOK ドキュメント
Zoom 連携ガイド
予約が確定すると Zoom の会議を自動で作成し、参加 URL を予約完了画面・確認メール・カレンダーの予定に記載します。 追加(接続)・使い方・削除(解除)の手順をまとめています。
English version: Zoom integration guide (English)
この連携でできること
- 予約が確定したときに、接続した Zoom アカウントで会議(日時指定・待機室あり・登録不要)を作成します。
- 参加 URL を、予約完了画面、ゲスト宛の確認メール、担当者宛の通知メールに記載します。Google カレンダーや iCloud と連携している場合は、作成された予定にも記載します。
- 予約がキャンセルされると、対応する Zoom の会議を削除します。
- 会議を自動発行するかどうかは、予約カレンダー(予約ページ)ごとに設定できます。来店・訪問など対面の予約では発行しません。
Zoom から LUDIBOOK が受け取る権限は、会議の作成(meeting:write:meeting)・会議の削除(meeting:delete:meeting)・接続したアカウントの表示(user:read:user)の3つだけです。録画・チャット・参加者情報は取得しません。
必要なもの
- LUDIBOOK の組織アカウント(オーナーまたは管理者の権限)
- 会議の主催者になる Zoom アカウント
- 会社の Zoom を使っていて管理者がアプリの利用を制限している場合は、Zoom 管理者による許可
追加する(Zoom アカウントを接続する)
- LUDIBOOK にログインし、左メニューの「カレンダー接続」を開きます。
- ページ下部の「オンライン会議(Zoom)」にある「Zoom を接続」を押します。
- Zoom のサインイン画面が開くので、会議の主催者にしたいアカウントでサインインし、表示された権限を確認して「許可」を押します。
- LUDIBOOK に戻り、接続したアカウント(メールアドレス)が一覧に表示されれば完了です。
担当者ごとに別の Zoom アカウントで会議を作りたい場合は、それぞれのアカウントで接続を追加してください。接続には分かりやすい名前を付けられます。
使う(予約ページごとに有効にする)
- 「予約カレンダー」から、Zoom を使いたい予約ページを開きます。
- 「基本設定」の「開催方法」で「Zoom(URL を自動発行)」を選びます。
- 使用する Zoom の接続を選び、保存します。
設定したあとの動きは次のとおりです。
- 予約が入ると、その日時・所要時間で Zoom の会議が作成されます。会議名は予約ページの名前です。
- 参加 URL は、予約完了画面とゲスト宛の確認メール、担当者宛の通知メールに記載されます。
- 予約がキャンセルされると、その会議は削除されます。
- 会議の発行に失敗した場合でも予約は成立します。自動で再試行し、続けて失敗したときは担当者にメールでお知らせします。
削除する(連携を解除する)
どちらの方法でも解除できます。解除すると、保存している認証情報(リフレッシュトークン)は直ちに削除されます。
方法A: LUDIBOOK から解除する
- 「カレンダー接続」を開きます。
- 「オンライン会議(Zoom)」の該当する接続で「削除」を押します。
方法B: Zoom から解除する
- Zoom にサインインし、「設定」→「アプリ」(Zoom Marketplace の Manage → Added Apps)を開きます。
- LUDIBOOK を探し、「削除(Remove)」を押します。
- LUDIBOOK は Zoom からの通知を受け取り、その Zoom ユーザーの接続を削除します。
解除しても、すでに作成済みの Zoom 会議は自動では削除されません。不要な場合は Zoom 側で削除してください。 また、解除後にその接続を使っていた予約ページでは会議 URL が発行されなくなります(予約の受付自体は続きます)。再開するには、あらためて接続して予約ページで選び直してください。
保存する情報と取り扱い
- 接続時に保存するもの: リフレッシュトークン(AES-256-GCM で暗号化)、接続したアカウントのメールアドレス・表示名・Zoom ユーザー ID
- 予約ごとに保存するもの: 会議 ID と参加 URL
- アクセストークンは暗号化して1時間未満の有効期限でキャッシュします。トークンや参加 URL をログに出力することはありません。
- 取得した情報は、会議の作成・削除と接続アカウントの表示にのみ使用します。広告や第三者提供には使用しません。
詳しくはプライバシーポリシーをご覧ください。
うまくいかないとき
- 「再接続が必要」と表示される: Zoom 側で連携が解除されたか、認証の有効期限が切れています。「カレンダー接続」から接続し直してください。
- 接続時に「権限が設定されていません」と表示される: 運営側のアプリ設定の問題です。お問い合わせください。
- 会議 URL が発行されない: 予約ページの「基本設定」で開催方法が Zoom になっているか、接続が有効かをご確認ください。予約詳細の画面に失敗した理由が表示されます。
- 会社の Zoom でインストールできない: Zoom 管理者がアプリの利用を制限している可能性があります。管理者に LUDIBOOK の許可を依頼してください。
お問い合わせ
ご不明な点は support@ludicrous.co.jp までご連絡ください。
LUDIBOOK documentation
Zoom integration guide
How to add, use and remove the Zoom integration in LUDIBOOK. When it is enabled, a confirmed booking creates a Zoom meeting automatically and the join link is shown on the confirmation screen, in the confirmation emails and in the connected calendar event.
What the integration does
- Creates a scheduled Zoom meeting in the connected account when a booking is confirmed (waiting room enabled, no registration required).
- Puts the join link on the confirmation screen, in the guest confirmation email, in the host notification email, and in the connected Google or iCloud calendar event.
- Deletes the Zoom meeting when the booking is cancelled.
- Is configured per booking page, so in-person appointments never create meetings.
The integration requests only three scopes: meeting:write:meeting (create), meeting:delete:meeting (delete) and user:read:user (display the connected account). Recordings, chat and participant data are never accessed.
Requirements
- A LUDIBOOK organization account with owner or admin permission
- A Zoom account that will host the meetings
- If your Zoom account restricts third-party apps, approval from your Zoom administrator
Add the app (connect your Zoom account)
- Sign in to LUDIBOOK and open "カレンダー接続" (Calendar connections) from the left menu.
- In the "オンライン会議(Zoom)" (Online meetings) section, click "Zoom を接続" (Connect Zoom).
- Sign in with the Zoom account that should host the meetings, review the requested permissions and click Allow.
- You are returned to LUDIBOOK. The connected account appears in the list — the integration is now installed.
To host meetings from several Zoom accounts, connect each of them; every connection can be given its own name.
Use it (enable per booking page)
- Open the booking page you want to use with Zoom from "予約カレンダー" (Booking pages).
- Under "基本設定" (Settings), set "開催方法" (Meeting method) to Zoom.
- Select which Zoom connection to use and save.
- Every confirmed booking creates a meeting for the booked date, time and duration; the meeting topic is the name of the booking page.
- The join link is included on the confirmation screen and in both confirmation emails.
- Cancelling a booking deletes the meeting.
- If meeting creation fails, the booking is still confirmed. LUDIBOOK retries automatically and notifies the host by email if it keeps failing.
Remove the app (disconnect)
Either method removes the stored credentials immediately.
Option A — from LUDIBOOK
- Open "カレンダー接続" (Calendar connections).
- Click "削除" (Delete) on the Zoom connection.
Option B — from Zoom
- Sign in to the Zoom web portal and open Settings → Apps (Zoom Marketplace → Manage → Added Apps).
- Find LUDIBOOK and click Remove.
- LUDIBOOK receives the deauthorization notification from Zoom and deletes the stored credentials for that Zoom user.
Meetings that were already created are not deleted automatically; delete them in Zoom if they are no longer needed. Booking pages that used the connection stop issuing meeting URLs, but continue to accept bookings. To resume, connect again and select the connection on the booking page.
What is stored
- On connect: the OAuth refresh token (encrypted with AES-256-GCM), and the connected account's email address, display name and Zoom user ID.
- Per booking: the meeting ID and the join URL.
- Access tokens are cached encrypted with a time-to-live under one hour. Tokens and join URLs are never written to logs.
- This data is used only to create and delete meetings and to display the connected account. It is never used for advertising and is not shared with third parties.
See our privacy policy for details.
Troubleshooting
- "Reconnection required": access was revoked in Zoom or has expired. Reconnect from Calendar connections.
- Missing permissions when connecting: this is an app configuration issue on our side — please contact support.
- No meeting URL was issued: check that the booking page uses Zoom as the meeting method and that the connection is active. The booking detail screen shows the reason for a failure.
- Cannot install on a managed Zoom account: your Zoom administrator may restrict third-party apps. Ask them to approve LUDIBOOK.
Support
Contact support@ludicrous.co.jp. See also our terms of service.