Michelle
13c60ba052
All checks were successful
Build & Push Docker Image / build (push) Successful in 6m25s
58 lines
2.3 KiB
Markdown
58 lines
2.3 KiB
Markdown
# 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:
|
|
|
|
```js
|
|
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](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)
|