How to Configure the Microsoft Teams Integration

Before you begin:

You must be an Acorn Administrator or Tenancy Administrator.
You must have access to a Microsoft Teams account with permission to create online meetings.
Ensure your organisation’s Microsoft Azure permissions are configured for API access (see Permission Configuration below).

Note: The integration uses secure RESTful API calls with TLS encryption and requires HTTPS access.

Log in to Acorn LMS as an administrator.
Navigate to Live Learning Integrations.
Click Add New Integration and select Microsoft Teams.
Authenticate via the Microsoft Authentication Portal:
- Sign in using your Microsoft credentials.
- Grant the requested permissions when prompted.
Once authenticated, complete the Integration Label Options within Acorn LMS.
Acorn will request and securely store a Bearer Token and Refresh Token in its database for session creation

Go to Live Learning > Sessions.
Click Create Session and select Microsoft Teams as the session type.
Enter the session details:
- Start time
- Finish time
- Subject (event name)

4. Save the session.

- Acorn will send a secure POST request to the Azure app.
- A new Microsoft Teams meeting will be automatically created.
- The Teams meeting link will appear in both Teams and Acorn LMS

A Microsoft Teams meeting is created automatically for the selected Acorn session.
Session details (time, title, participants) match between Acorn LMS and Microsoft Teams.
Users can launch the Teams session directly from Acorn.

Issue	Possible Cause	Solution
Teams session not created	Invalid token or permission issue	Reauthenticate through Microsoft portal and verify OnlineMeetings.ReadWrite permission.
“Forbidden access” error when joining	Integration removed or rolled back	Recreate the integration in Acorn or contact an administrator.
Integration rollback needed	Configuration or security change	Delete the integration from {base_URL}/live_learning_integrations to remove all links between Acorn and Teams

To enable Acorn to create and manage Teams sessions, the following Microsoft Graph API permissions are required.

Permission	Purpose	Documentation
offline_access	Allows Acorn to obtain a refresh token to create and reschedule meetings on behalf of users.	Microsoft Graph API: Offline Access
OnlineMeetings.ReadWrite	Enables Acorn to create, read, and update Teams meetings.	Microsoft Graph API: Online Meetings Permissions
OnlineMeetings.ReadWrite (delegated)	Allows Acorn to act as the signed-in user for meeting creation.	Microsoft Graph API Permissions Reference

Security: The integration uses TLSv1.2 (upgrading to TLSv1.3) with RSA 2048-bit encryption. All data is encrypted at rest and in transit.
Rollback: Removing the integration severs all links between Acorn and Teams without affecting Microsoft Teams infrastructure.

This article explains how to set up, authenticate, and manage the Microsoft Teams integration in Acorn. The integration automatically creates Microsoft Teams sessions for face-to-screen training events, reducing manual setup and ensuring consistency between Acorn and Microsoft Teams.