Integrate BigBlueButton with Foswiki: Complete Plugin Setup Guide

Introduction

Foswiki can be integrated with BigBlueButton (BBB) through the BigBlueButtonPlugin to provide wiki-native virtual meeting rooms for team collaboration, training, and online classes.

Once configured, authorized Foswiki users can join rooms with a single click, see participant presence, and use room-specific topics generated by the plugin.

This guide is adapted for practical production setup and migration-friendly documentation quality.

What the Foswiki BBB Plugin Enables

With BigBlueButtonPlugin, you can:

• Define one or more reusable meeting rooms
• Auto-create corresponding Foswiki topics for room pages
• Let users join rooms using Foswiki authentication
• Display room details and current participants through macros
• Expose room operations through REST endpoints

Prerequisites

Before you begin, ensure:

• Foswiki admin access
• BigBlueButtonPlugin installed/enabled in Foswiki
• A running BigBlueButton server (managed or self-hosted)
• Valid BBB API endpoint credentials already available
• HTTPS and network reachability from Foswiki to BBB

Official plugin page:

• Foswiki BigBlueButtonPlugin

For organizations that want fewer infrastructure operations tasks, managed BBB hosting can simplify updates, monitoring, and scaling while preserving the same plugin workflow.

Step 1: Install and Enable BigBlueButtonPlugin

Use Foswiki's extension installer:

1. Open configure
2. Go to Extensions
3. Select Find More Extensions
4. Install BigBlueButtonPlugin
5. Enable the plugin

If extension installer is unavailable, perform manual extension installation from command line using Foswiki's documented extension workflow.

Step 2: Configure Plugin Settings in Foswiki

In configure, set the following BigBlueButtonPlugin values:

1. baseUrl
   • BBB API URL, for example: https://bbb.example.com/bigbluebutton/api
2. salt
   • BBB shared secret/security salt for the configured API
3. rooms
   • List of room definitions (name, password, audio bridge)

Minimal example structure:

[
  {
    'password' => '5678',
    'name' => 'Daisy',
    'audioBridge' => '71000'
  },
  {
    'password' => '5678',
    'name' => 'Iris',
    'audioBridge' => '71001'
  }
]

Note: your telephony/audio bridge configuration must accept the configured bridge numbers, otherwise call audio may fail.

Step 3: Refresh Conference Room Topics After Room Changes

If you modify room configuration:

1. Remove old conference room category/topic artifacts created by the plugin
2. Trigger plugin regeneration

The plugin re-creates room topics with updated room definitions.

Step 4: Trigger Initial Room Creation and Validate

After enabling and configuring, trigger plugin actions using either REST or macros so Foswiki can create rooms/topics on BBB.

Quick validation methods:

• Open room list endpoint: /bin/rest/BigBlueButtonPlugin/listRooms
• Test join URL generation: /bin/rest/BigBlueButtonPlugin/getJoinRoomUrl?room=Daisy
• Test direct join: /bin/rest/BigBlueButtonPlugin/joinRoom?room=Daisy

Then verify users can join and see expected participant behavior.

Useful Foswiki Macros

Common plugin macros include:

• %BBBJOINROOM{}% to list or link rooms
• %BBBJOINROOM{Lotus}% for direct room join link
• %BBBROOMNAME{Lotus}% for room topic link
• %BBBROOMDETAILS{Lotus}% to display room details

These macros can be embedded in dashboard topics, sidebars, or collaboration spaces.

REST Endpoints for Integrations

Plugin REST interface supports automation and external integrations:

• listRooms for configured room inventory
• getJoinRoomUrl for authenticated join URL generation
• joinRoom for direct room access
• getPeopleInRoom for participant presence checks

This is useful when integrating with custom portals or service layers around Foswiki.

Troubleshooting Common Issues

If room joins fail or data is inconsistent:

1. Recheck baseUrl and salt values in Foswiki configure
2. Confirm BBB API endpoint is reachable from Foswiki host
3. Validate SSL certificate trust chain
4. Ensure room names in macros/endpoints match configured rooms exactly
5. Verify audio bridge range is valid in BBB telephony configuration
6. Regenerate conference room topics after room configuration changes

If REST endpoints respond but join flow fails, inspect Foswiki logs and BBB API logs together to isolate auth vs connectivity problems.

Security and Operations Best Practices

For stable production usage:

• Restrict admin access to plugin configuration
• Rotate BBB secret values using change-control process
• Track room naming and ownership conventions
• Keep Foswiki and plugin components updated
• Validate config changes in staging before production rollout

FAQ

Can Foswiki manage multiple meeting rooms with BBB?

Yes. Define multiple room entries in the plugin rooms configuration.

Do room topics update automatically after room config changes?

You should regenerate plugin-created conference room topics so updates reflect current room settings.

Can I automate room access from external tools?

Yes. Use the plugin REST endpoints such as listRooms, getJoinRoomUrl, and joinRoom.

Is managed BBB hosting compatible with Foswiki plugin integration?

Yes. Managed and self-hosted BBB both work as long as API endpoint and secret configuration are correct.

Conclusion

BigBlueButtonPlugin makes Foswiki collaboration more interactive by adding reusable meeting rooms, presence-aware room pages, and REST-accessible conference actions.

With correct plugin configuration and validation, teams can run reliable web conferencing directly from Foswiki while choosing either self-hosted control or managed BBB operations based on internal capacity.