Support Centre

Microsoft Teams Integration

In this article you will learn about:

  • Overview of the Microsoft Teams integration
  • Before you start
  • Connect your Microsoft account
  • What to do if administrator approval is required
  • Create, join and manage Teams meetings
  • Troubleshoot connection issues
  • Security and Microsoft permissions

Overview of the Microsoft Teams integration

The Microsoft Teams integration lets Meeting Organisers add a Teams call directly to a meeting in Sherpany. Sherpany adds the Teams link to the meeting and includes it in calendar invitations, so participants can join from Sherpany, their calendar invitation or Microsoft Teams.

Information

  • Only the Meeting Organiser creating the Teams call needs to connect their Microsoft account to Sherpany.
  • Participants do not need to connect their Microsoft account to Sherpany. Depending on the meeting organiser's Microsoft Teams settings, guests may be able to join without a Teams account.

Before you start

To create Teams meetings from Sherpany, you need:

  • A Microsoft 365 work or school account with access to Microsoft Teams.
  • Exchange Online (Microsoft 365). On-premises or hybrid Exchange configurations may have limitations.
  • The Microsoft Teams integration enabled for the relevant Sherpany room.

Your organisation's Microsoft 365 security settings determine whether you can approve the connection yourself or need help from an IT administrator.

Connect your Microsoft account

  1. Open your personal settings in Sherpany.
  2. In the Integration section, select Connect account for Microsoft Teams.
  3. Sign in with your Microsoft work or school account (not your Sherpany credentials).
  4. Follow the instructions on the Microsoft screen. You may be able to review the permissions and select Accept, or you may be asked to obtain administrator approval.
  5. If the connection succeeds, select Return to Sherpany when prompted.

Important

Administrator approval and connecting your personal Microsoft account are two different steps. Even after your organisation approves the Sherpany application, you may still need to connect your own account in Sherpany. If your organisation enables additional Microsoft integrations or permissions later, Microsoft may ask you to consent again.

What if Microsoft asks for administrator approval?

Some organisations restrict which applications can access Microsoft 365. If Microsoft does not let you approve the Sherpany connection directly, follow the option shown on your screen.

If you see "Approval required" and "Request approval"

  1. Select Request approval.
  2. If prompted, explain that you need to create Microsoft Teams meetings from Sherpany.
  3. Submit the request and wait for your Microsoft 365 administrator to review it.
  4. Once approved, return to Sherpany and try Connect account again.

If approval is required but there is no request button

Contact your organisation's Microsoft 365 IT administrator. Ask them to review and approve the Sherpany Enterprise Application for the Microsoft Teams integration. Your IT team may also need to check whether you have been assigned access to the application.

For Microsoft 365 administrators

Review the Sherpany Enterprise Application and its requested Microsoft Teams permissions in Microsoft Entra. Depending on your tenant's consent policies, an authorised administrator may need to grant consent before users can connect. If user assignment is required for the application, assign the relevant users as well.

Microsoft documentation: Grant tenant-wide admin consent and Configure the admin consent workflow.

Create a meeting with Microsoft Teams

  1. Open or create a meeting in Sherpany.
  2. Under Conference Call, choose Add conference call if shown, then select Microsoft Teams.
  3. If this is your first time using the integration, follow the Microsoft connection or approval steps described above.
  4. Select Create/Update to save your meeting.

Sherpany adds the Teams link to your meeting and sends calendar invitations to participants.

Tip

You can add the Teams call after creating the meeting. Select Update to save the change and update the invitations.

Join a meeting

Participants can join through:

  • The Teams link in the Sherpany meeting details.
  • The link in their calendar invitation.
  • The Teams calendar, if they use Microsoft Teams.

Information

  • Calendar invitations cover the full meeting duration, even when some agenda items are restricted.
  • Guests without a Teams account may be able to join by entering their name. Access depends on the organiser's Microsoft Teams meeting policies.

Manage and update meetings

  • Reschedule: Changing the meeting date or time updates the associated Teams invitation.
  • Remove the call: Removing the Teams call cancels the associated Teams invitation.
  • Meeting organiser: The Microsoft account used to create the Teams call is the Teams meeting organiser.

Troubleshooting

Microsoft says "Approval required"

Your organisation's consent policy requires administrator approval. Use Request approval if available, or contact your Microsoft 365 IT administrator. After approval, try connecting your account again in Sherpany.

Error AADSTS50105: You are not assigned to the application

Your organisation may require explicit user assignment for the Sherpany Enterprise Application. Ask your Microsoft 365 administrator to check whether your account has been assigned.

Error AADSTS50020: Your account is not in the directory

Make sure you are signing in with the correct Microsoft 365 work or school account. Personal Microsoft accounts, such as Outlook.com or Hotmail.com accounts, are not supported for this integration.

You are asked to approve permissions again

This can happen when additional Microsoft integration features or permissions become available. Review the request and follow your organisation's approval process if necessary.

You still cannot connect

Contact your organisation's IT administrator or Sherpany Support. Include the error message or code displayed by Microsoft and describe the step at which the connection failed. Do not share passwords or authentication codes.

Security and Microsoft permissions

Sherpany uses Microsoft sign-in and OAuth 2.0 to request access. You sign in with Microsoft; you do not provide your Microsoft password to Sherpany.

For the Microsoft Teams integration, Sherpany requests permissions needed to identify your Microsoft account and create or update Teams meetings and related calendar events:

  • User.Read – identify the signed-in Microsoft user.
  • Calendars.ReadWrite – create and update calendar events.
  • OnlineMeetings.ReadWrite – create and manage online Teams meetings.
  • openid, profile and email – support Microsoft sign-in and user identification.
  • offline_access – support continued authorised access when a new interactive sign-in is not required.

The permissions requested during sign-in depend on the Microsoft integrations enabled for your Sherpany room. Additional integrations, such as SharePoint, may require different permissions and are not covered by the Teams setup instructions in this article.

For more information on how Microsoft controls application permissions, see Configure user consent to applications.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.