Add BigBlueButton conferencing app

Simultech369 · Simultech369 · commit efd7a170b2a7 · 2026-05-25T22:23:44.000-04:00
diff --git a/apps/api/v2/src/platform/bookings/2024-08-13/services/booking-video.service.ts b/apps/api/v2/src/platform/bookings/2024-08-13/services/booking-video.service.ts
@@ -93,6 +93,7 @@ export class BookingVideoService_2024_08_13 {
     const integrationToCredentialTypeMap = {
       zoom: "zoom_video",
       "whereby-video": "whereby_video",
+      "bigbluebutton-video": "bigbluebutton_video",
       "webex-video": "webex_video",
       tandem: "tandem_video",
       jitsi: "jitsi_video",
diff --git a/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/api-to-internal/locations.ts b/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/api-to-internal/locations.ts
@@ -14,6 +14,7 @@ import type {
 export const apiToInternalintegrationsMapping = {
   "cal-video": "integrations:daily",
   "google-meet": "integrations:google:meet",
+  "bigbluebutton-video": "integrations:bigbluebutton_video",
   "office365-video": "integrations:office365_video",
   zoom: "integrations:zoom",
   "whereby-video": "integrations:whereby_video",
diff --git a/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/internal-to-api/locations.ts b/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/internal-to-api/locations.ts
@@ -17,6 +17,7 @@ import type { InternalLocation } from "../internal/locations";
 const internalToApiIntegrationsMapping: Record<string, OutputIntegration_2024_06_14> = {
   "integrations:daily": "cal-video",
   "integrations:google:meet": "google-meet",
+  "integrations:bigbluebutton_video": "bigbluebutton-video",
   "integrations:zoom": "zoom",
   "integrations:whereby_video": "whereby-video",
   "integrations:whatsapp_video": "whatsapp-video",
diff --git a/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/internal/locations.ts b/apps/api/v2/src/platform/event-types/event-types_2024_06_14/transformers/internal/locations.ts
@@ -3,6 +3,7 @@ import { z } from "zod";
 const integrationsApiAvailable = {
   "cal-video": z.literal("integrations:daily"),
   "google-meet": z.literal("integrations:google:meet"),
+  "bigbluebutton-video": z.literal("integrations:bigbluebutton_video"),
   zoom: z.literal("integrations:zoom"),
   "office365-video": z.literal("integrations:office365_video"),
 };
@@ -47,6 +48,7 @@ const OrganizerIntegrationSchema = z.object({
   type: z.union([
     integrationsApiToInternalMappingSchema["cal-video"],
     integrationsApiToInternalMappingSchema["google-meet"],
+    integrationsApiToInternalMappingSchema["bigbluebutton-video"],
     integrationsApiToInternalMappingSchema["zoom"],
     integrationsApiToInternalMappingSchema["whereby-video"],
     integrationsApiToInternalMappingSchema["whatsapp-video"],
diff --git a/packages/app-store/apps.keys-schemas.generated.ts b/packages/app-store/apps.keys-schemas.generated.ts
@@ -4,6 +4,7 @@
 **/
 import { appKeysSchema as alby_zod_ts } from "./alby/zod";
 import { appKeysSchema as basecamp3_zod_ts } from "./basecamp3/zod";
+import { appKeysSchema as bigbluebutton_zod_ts } from "./bigbluebutton/zod";
 import { appKeysSchema as btcpayserver_zod_ts } from "./btcpayserver/zod";
 import { appKeysSchema as closecom_zod_ts } from "./closecom/zod";
 import { appKeysSchema as dailyvideo_zod_ts } from "./dailyvideo/zod";
@@ -55,6 +56,7 @@ import { appKeysSchema as zoomvideo_zod_ts } from "./zoomvideo/zod";
 export const appKeysSchemas = {
   alby: alby_zod_ts,
   basecamp3: basecamp3_zod_ts,
+  bigbluebutton: bigbluebutton_zod_ts,
   btcpayserver: btcpayserver_zod_ts,
   closecom: closecom_zod_ts,
   dailyvideo: dailyvideo_zod_ts,
diff --git a/packages/app-store/apps.metadata.generated.ts b/packages/app-store/apps.metadata.generated.ts
@@ -9,6 +9,7 @@ import attio_config_json from "./attio/config.json";
 import autocheckin_config_json from "./autocheckin/config.json";
 import baa_for_hipaa_config_json from "./baa-for-hipaa/config.json";
 import basecamp3_config_json from "./basecamp3/config.json";
+import { metadata as bigbluebutton__metadata_ts } from "./bigbluebutton/_metadata";
 import bolna_config_json from "./bolna/config.json";
 import btcpayserver_config_json from "./btcpayserver/config.json";
 import { metadata as caldavcalendar__metadata_ts } from "./caldavcalendar/_metadata";
@@ -121,6 +122,7 @@ export const appStoreMetadata = {
   autocheckin: autocheckin_config_json,
   "baa-for-hipaa": baa_for_hipaa_config_json,
   basecamp3: basecamp3_config_json,
+  bigbluebutton: bigbluebutton__metadata_ts,
   bolna: bolna_config_json,
   btcpayserver: btcpayserver_config_json,
   caldavcalendar: caldavcalendar__metadata_ts,
diff --git a/packages/app-store/apps.schemas.generated.ts b/packages/app-store/apps.schemas.generated.ts
@@ -4,6 +4,7 @@
 **/
 import { appDataSchema as alby_zod_ts } from "./alby/zod";
 import { appDataSchema as basecamp3_zod_ts } from "./basecamp3/zod";
+import { appDataSchema as bigbluebutton_zod_ts } from "./bigbluebutton/zod";
 import { appDataSchema as btcpayserver_zod_ts } from "./btcpayserver/zod";
 import { appDataSchema as closecom_zod_ts } from "./closecom/zod";
 import { appDataSchema as dailyvideo_zod_ts } from "./dailyvideo/zod";
@@ -55,6 +56,7 @@ import { appDataSchema as zoomvideo_zod_ts } from "./zoomvideo/zod";
 export const appDataSchemas = {
   alby: alby_zod_ts,
   basecamp3: basecamp3_zod_ts,
+  bigbluebutton: bigbluebutton_zod_ts,
   btcpayserver: btcpayserver_zod_ts,
   closecom: closecom_zod_ts,
   dailyvideo: dailyvideo_zod_ts,
diff --git a/packages/app-store/apps.server.generated.ts b/packages/app-store/apps.server.generated.ts
@@ -7,6 +7,7 @@ export const apiHandlers = {
   applecalendar: import("./applecalendar/api"),
   attio: import("./attio/api"),
   basecamp3: import("./basecamp3/api"),
+  bigbluebutton: import("./bigbluebutton/api"),
   btcpayserver: import("./btcpayserver/api"),
   caldavcalendar: import("./caldavcalendar/api"),
   campfire: import("./campfire/api"),
diff --git a/packages/app-store/bigbluebutton/DESCRIPTION.md b/packages/app-store/bigbluebutton/DESCRIPTION.md
@@ -0,0 +1 @@
+BigBlueButton is an open source web conferencing system built for online learning and collaboration.
diff --git a/packages/app-store/bigbluebutton/_metadata.ts b/packages/app-store/bigbluebutton/_metadata.ts
@@ -0,0 +1,30 @@
+import type { AppMeta } from "@calcom/types/App";
+
+export const metadata = {
+  name: "BigBlueButton",
+  description:
+    "BigBlueButton is an open source web conferencing system built for online learning and collaboration.",
+  installed: true,
+  type: "bigbluebutton_video",
+  variant: "conferencing",
+  categories: ["conferencing"],
+  logo: "icon.svg",
+  publisher: "Cal.diy",
+  url: "https://bigbluebutton.org/",
+  slug: "bigbluebutton",
+  title: "BigBlueButton",
+  isGlobal: false,
+  email: "help@cal.com",
+  appData: {
+    location: {
+      linkType: "dynamic",
+      type: "integrations:bigbluebutton_video",
+      label: "BigBlueButton",
+    },
+  },
+  dirName: "bigbluebutton",
+  concurrentMeetings: true,
+  isOAuth: false,
+} as AppMeta;
+
+export default metadata;
diff --git a/packages/app-store/bigbluebutton/api/add.ts b/packages/app-store/bigbluebutton/api/add.ts
@@ -0,0 +1,56 @@
+import type { NextApiRequest, NextApiResponse } from "next";
+
+import { throwIfNotHaveAdminAccessToTeam } from "@calcom/app-store/_utils/throwIfNotHaveAdminAccessToTeam";
+import { getServerErrorFromUnknown } from "@calcom/lib/server/getServerErrorFromUnknown";
+import prisma from "@calcom/prisma";
+
+import getInstalledAppPath from "../../_utils/getInstalledAppPath";
+
+export default async function handler(req: NextApiRequest, res: NextApiResponse) {
+  if (!req.session?.user?.id) {
+    return res.status(401).json({ message: "You must be logged in to do this" });
+  }
+
+  const { teamId, returnTo } = req.query;
+
+  await throwIfNotHaveAdminAccessToTeam({
+    teamId: teamId ? Number(teamId) : null,
+    userId: req.session.user.id,
+  });
+
+  const installForObject = teamId ? { teamId: Number(teamId) } : { userId: req.session.user.id };
+  const appType = "bigbluebutton_video";
+
+  try {
+    const alreadyInstalled = await prisma.credential.findFirst({
+      where: {
+        type: appType,
+        ...installForObject,
+      },
+    });
+
+    if (alreadyInstalled) {
+      throw new Error("Already installed");
+    }
+
+    const installation = await prisma.credential.create({
+      data: {
+        type: appType,
+        key: {},
+        ...installForObject,
+        appId: "bigbluebutton",
+      },
+    });
+
+    if (!installation) {
+      throw new Error("Unable to create user credential for BigBlueButton");
+    }
+  } catch (error: unknown) {
+    const httpError = getServerErrorFromUnknown(error);
+    return res.status(httpError.statusCode).json({ message: httpError.message });
+  }
+
+  return res.status(200).json({
+    url: returnTo ?? getInstalledAppPath({ variant: "conferencing", slug: "bigbluebutton" }),
+  });
+}
diff --git a/packages/app-store/bigbluebutton/api/index.ts b/packages/app-store/bigbluebutton/api/index.ts
@@ -0,0 +1 @@
+export { default as add } from "./add";
diff --git a/packages/app-store/bigbluebutton/index.ts b/packages/app-store/bigbluebutton/index.ts
@@ -0,0 +1,3 @@
+export * as lib from "./lib";
+export * as api from "./api";
+export { metadata } from "./_metadata";
diff --git a/packages/app-store/bigbluebutton/lib/VideoApiAdapter.ts b/packages/app-store/bigbluebutton/lib/VideoApiAdapter.ts
@@ -0,0 +1,145 @@
+import { createHash } from "node:crypto";
+import { v4 as uuidv4 } from "uuid";
+
+import type { CalendarEvent } from "@calcom/types/Calendar";
+import type { PartialReference } from "@calcom/types/EventManager";
+import type { VideoApiAdapter, VideoCallData } from "@calcom/types/VideoApiAdapter";
+
+import getParsedAppKeysFromSlug from "../../_utils/getParsedAppKeysFromSlug";
+import { metadata } from "../_metadata";
+import { appKeysSchema } from "../zod";
+
+const buildChecksum = (callName: string, query: string, sharedSecret: string) =>
+  createHash("sha1").update(`${callName}${query}${sharedSecret}`).digest("hex");
+
+const getXmlTag = (xml: string, tagName: string) => {
+  const match = xml.match(new RegExp(`<${tagName}>([\\s\\S]*?)</${tagName}>`));
+  return match?.[1] ?? "";
+};
+
+const buildApiUrl = ({
+  serverUrl,
+  callName,
+  params,
+  sharedSecret,
+}: {
+  serverUrl: string;
+  callName: string;
+  params: URLSearchParams;
+  sharedSecret: string;
+}) => {
+  const query = params.toString();
+  const checksum = buildChecksum(callName, query, sharedSecret);
+  const normalizedServerUrl = serverUrl.replace(/\/+$/, "");
+  return `${normalizedServerUrl}/bigbluebutton/api/${callName}?${query}&checksum=${checksum}`;
+};
+
+const buildMeetingId = (eventData: CalendarEvent, pattern: string) =>
+  pattern
+    .replaceAll("{uuid}", uuidv4())
+    .replaceAll("{Title}", eventData.title)
+    .replaceAll("{Event Type Title}", eventData.type)
+    .replaceAll("{Scheduler}", eventData.attendees.map((a) => a.name).join("-"))
+    .replaceAll("{Organizer}", eventData.organizer.name)
+    .replaceAll("{Location}", eventData.location || "")
+    .replaceAll("{Team}", eventData.team?.name || "")
+    .replaceAll(" ", "-");
+
+const BigBlueButtonVideoApiAdapter = (): VideoApiAdapter => ({
+  getAvailability: () => Promise.resolve([]),
+
+  createMeeting: async (eventData: CalendarEvent): Promise<VideoCallData> => {
+    const { bigBlueButtonServerUrl, bigBlueButtonSharedSecret, bigBlueButtonMeetingPattern } =
+      await getParsedAppKeysFromSlug(metadata.slug, appKeysSchema);
+
+    const meetingID = buildMeetingId(eventData, bigBlueButtonMeetingPattern || "cal-{uuid}");
+    const attendeePW = uuidv4();
+    const moderatorPW = uuidv4();
+
+    const createParams = new URLSearchParams({
+      name: eventData.title,
+      meetingID,
+      attendeePW,
+      moderatorPW,
+    });
+
+    const createUrl = buildApiUrl({
+      serverUrl: bigBlueButtonServerUrl,
+      callName: "create",
+      params: createParams,
+      sharedSecret: bigBlueButtonSharedSecret,
+    });
+
+    const createResponse = await fetch(createUrl);
+    const createXml = await createResponse.text();
+    const returnCode = getXmlTag(createXml, "returncode");
+
+    if (!createResponse.ok || returnCode !== "SUCCESS") {
+      const message = getXmlTag(createXml, "message") || "Unable to create BigBlueButton meeting";
+      throw new Error(message);
+    }
+
+    const joinParams = new URLSearchParams({
+      fullName: "Guest",
+      meetingID,
+      password: attendeePW,
+    });
+
+    const joinUrl = buildApiUrl({
+      serverUrl: bigBlueButtonServerUrl,
+      callName: "join",
+      params: joinParams,
+      sharedSecret: bigBlueButtonSharedSecret,
+    });
+
+    return {
+      type: metadata.type,
+      id: `${meetingID}:${moderatorPW}`,
+      password: moderatorPW,
+      url: joinUrl,
+    };
+  },
+
+  deleteMeeting: async (uid: string): Promise<void> => {
+    const [meetingID, moderatorPW] = uid.split(":");
+    if (!meetingID || !moderatorPW) {
+      return;
+    }
+
+    const { bigBlueButtonServerUrl, bigBlueButtonSharedSecret } = await getParsedAppKeysFromSlug(
+      metadata.slug,
+      appKeysSchema
+    );
+
+    const endParams = new URLSearchParams({
+      meetingID,
+      password: moderatorPW,
+    });
+
+    const endUrl = buildApiUrl({
+      serverUrl: bigBlueButtonServerUrl,
+      callName: "end",
+      params: endParams,
+      sharedSecret: bigBlueButtonSharedSecret,
+    });
+
+    const endResponse = await fetch(endUrl);
+    const endXml = await endResponse.text();
+    const returnCode = getXmlTag(endXml, "returncode");
+
+    if (!endResponse.ok || returnCode !== "SUCCESS") {
+      const message = getXmlTag(endXml, "message") || "Unable to end BigBlueButton meeting";
+      throw new Error(message);
+    }
+  },
+
+  updateMeeting: (bookingRef: PartialReference): Promise<VideoCallData> =>
+    Promise.resolve({
+      type: metadata.type,
+      id: bookingRef.meetingId as string,
+      password: bookingRef.meetingPassword as string,
+      url: bookingRef.meetingUrl as string,
+    }),
+});
+
+export default BigBlueButtonVideoApiAdapter;
diff --git a/packages/app-store/bigbluebutton/lib/index.ts b/packages/app-store/bigbluebutton/lib/index.ts
@@ -0,0 +1 @@
+export { default as VideoApiAdapter } from "./VideoApiAdapter";
diff --git a/packages/app-store/bigbluebutton/package.json b/packages/app-store/bigbluebutton/package.json
@@ -0,0 +1,13 @@
+{
+  "private": true,
+  "name": "@calcom/bigbluebutton",
+  "version": "0.0.0",
+  "main": "./index.ts",
+  "description": "BigBlueButton is an open source web conferencing system built for online learning and collaboration.",
+  "dependencies": {
+    "@calcom/lib": "workspace:*"
+  },
+  "devDependencies": {
+    "@calcom/types": "workspace:*"
+  }
+}
diff --git a/packages/app-store/bigbluebutton/static/icon.svg b/packages/app-store/bigbluebutton/static/icon.svg
@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="BigBlueButton">
+  <rect width="64" height="64" rx="14" fill="#1f6fff"/>
+  <circle cx="32" cy="32" r="21" fill="#fff"/>
+  <path fill="#1f6fff" d="M24 20h12c5 0 9 3 9 8 0 3-2 6-5 7 4 1 6 4 6 8 0 6-5 9-11 9H24V20Zm8 13h4c2 0 4-1 4-4s-2-4-4-4h-4v8Zm0 14h5c3 0 5-2 5-5s-2-5-5-5h-5v10Z"/>
+</svg>
diff --git a/packages/app-store/bigbluebutton/zod.ts b/packages/app-store/bigbluebutton/zod.ts
@@ -0,0 +1,9 @@
+import { z } from "zod";
+
+export const appKeysSchema = z.object({
+  bigBlueButtonServerUrl: z.string().url(),
+  bigBlueButtonSharedSecret: z.string().min(1),
+  bigBlueButtonMeetingPattern: z.string().optional(),
+});
+
+export const appDataSchema = z.object({});
diff --git a/packages/app-store/bookerApps.metadata.generated.ts b/packages/app-store/bookerApps.metadata.generated.ts
@@ -3,6 +3,7 @@
     Don't modify this file manually.
 **/
 import campfire_config_json from "./campfire/config.json";
+import { metadata as bigbluebutton__metadata_ts } from "./bigbluebutton/_metadata";
 import { metadata as dailyvideo__metadata_ts } from "./dailyvideo/_metadata";
 import databuddy_config_json from "./databuddy/config.json";
 import demodesk_config_json from "./demodesk/config.json";
@@ -48,6 +49,7 @@ import whatsapp_config_json from "./whatsapp/config.json";
 import whereby_config_json from "./whereby/config.json";
 import { metadata as zoomvideo__metadata_ts } from "./zoomvideo/_metadata";
 export const appStoreMetadata = {
+  bigbluebutton: bigbluebutton__metadata_ts,
   campfire: campfire_config_json,
   dailyvideo: dailyvideo__metadata_ts,
   databuddy: databuddy_config_json,
diff --git a/packages/app-store/video.adapters.generated.ts b/packages/app-store/video.adapters.generated.ts
@@ -6,6 +6,7 @@ export const VideoApiAdapterMap =
   process.env.NEXT_PUBLIC_IS_E2E === "1"
     ? {}
     : {
+        bigbluebutton: import("./bigbluebutton/lib/VideoApiAdapter"),
         dailyvideo: import("./dailyvideo/lib/VideoApiAdapter"),
         huddle01video: import("./huddle01video/lib/VideoApiAdapter"),
         jelly: import("./jelly/lib/VideoApiAdapter"),
diff --git a/packages/platform/types/bookings/2024-08-13/inputs/location.input.ts b/packages/platform/types/bookings/2024-08-13/inputs/location.input.ts
diff --git a/packages/platform/types/event-types/event-types_2024_06_14/inputs/locations.input.ts b/packages/platform/types/event-types/event-types_2024_06_14/inputs/locations.input.ts
diff --git a/packages/platform/types/event-types/event-types_2024_06_14/outputs/locations.output.ts b/packages/platform/types/event-types/event-types_2024_06_14/outputs/locations.output.ts

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+BigBlueButton is an open source web conferencing system built for online learning and collaboration.`