redlight/outlook-addin/README.md

Redlight Outlook Add-in

An Outlook Add-in (compatible with Outlook on the Web and Outlook 365 / New Outlook) that lets you create a Redlight meeting room directly from your Outlook calendar.

Setup

1. Configure Environment

Edit taskpane.html and replace the REDLIGHT_BASE_URL at the top of the script section with your Redlight instance URL:

const REDLIGHT_BASE_URL = 'https://your-redlight-instance.com';

2. Update Manifest

Edit manifest.xml and update:

• All <bt:Url id="..." DefaultValue="..." /> entries to point to where you host these files.
• The <Id> GUID if you want a unique add-in identifier.
• <SupportUrl> / <ProviderName> as needed.

3. Host the Add-in Files

The add-in files (taskpane.html, manifest.xml) must be served over HTTPS. Options:

1. Host on your Redlight server — place the files in public/outlook-addin/ and they'll be served at https://your-domain/outlook-addin/taskpane.html.
2. Host anywhere — any static HTTPS server works.

4. Sideload or Deploy

Sideload for Testing (Outlook Web)

1. Go to Outlook on the Web → https://outlook.office.com
2. Click the gear icon → View all Outlook settings → Mail → Customize actions → Get add-ins
3. Click My add-ins → Add a custom add-in → Add from file...
4. Upload manifest.xml

Sideload for Testing (Outlook 365 Desktop)

1. Open Outlook → File → Manage Add-ins (or Get Add-ins)
2. Click My Add-ins → Add a custom add-in → Add from file...
3. Select manifest.xml

Deploy via Microsoft 365 Admin Center

1. Go to admin.microsoft.com → Settings → Integrated apps
2. Upload the manifest to deploy for your organization

Usage

1. Open your Outlook Calendar and create a new event
2. In the compose toolbar, click the Redlight icon
3. Log in with your Redlight credentials (token is cached for future use)
4. Select an existing room or create a new one
5. Click Insert Meeting Link — the room join URL will be inserted into the event body and location

Files

• manifest.xml — Office Add-in manifest (defines capabilities, icons, URLs)
• taskpane.html — The add-in UI and logic (single-file HTML+CSS+JS)