Edit

Manage Microsoft 365 connectors and custom connectors

  • Article
  • 2 minutes to read
  • Applies to:
    Microsoft Teams

Connectors in Microsoft Teams deliver content and service updates directly from third-party services into a Teams channel. Using connectors, the users receive updates from popular services such as Trello, Wunderlist, GitHub, and Azure DevOps Services. Connectors post these updates directly into the chat stream. This functionality makes it easy for all the team members to stay in sync and quickly receive the relevant information.

Teams and Microsoft 365 groups use connectors. You can use the same connectors in Teams and Microsoft Exchange.

Any team member can add a connector to a channel, if the team permissions allow it. The updates from the service, that the connector fetches information from, notifies all the team members. Any team member with the permissions to add or remove can modify connectors setup done by other members.

Enable or disable connectors in Teams

The Exchange Online PowerShell v2 module uses modern authentication and works with multi-factor authentication (MFA) to connect to all Exchange related PowerShell environments in Microsoft 365. Admins can use Exchange Online PowerShell to disable connectors for an entire tenant or a specific group mailbox. If a connector is disabled, it affects all users in that tenant or mailbox. You can't disable a connector for a few specific users.

The tenant setting overrides the group setting. For example, if an admin enables connectors for the group and disables them on the tenant, connectors for the group are disabled. To enable a connector in Teams, connect to Exchange Online PowerShell using modern authentication with or without MFA.

To enable or disable a connector, execute the following commands in Exchange Online PowerShell:

  • To disable connectors for the tenant: Set-OrganizationConfig -ConnectorsEnabled:$false.
  • To disable actionable messages for the tenant: Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$false.
  • To enable connectors for Teams, execute the following commands:
    • Set-OrganizationConfig -ConnectorsEnabled:$true
    • Set-OrganizationConfig -ConnectorsEnabledForTeams:$true
    • Set-OrganizationConfig -ConnectorsActionableMessagesEnabled:$true

For more information on PowerShell module exchange, see Set-OrganizationConfig. To enable or disable Outlook connectors, connect apps to your groups in Microsoft Outlook.

Publish connectors for your organization

To make a custom connector available to your organization's users, upload a custom connector app to your org's app catalog. Users within the org can install, configure, and use the connector in a team.

Important

Custom connectors are not available in Government Community Cloud (GCC), Government Community Cloud-High (GCCH), and Department of Defense (DOD) environments.

To use connectors in a team or a channel, open the More Options menu from the upper right corner of a channel. From the menu, select Connectors and then locate or search for the required connector. Configure the selected connector if necessary.

Add connectors to your channel in Teams from the More options in the upper right corner of the channel.

Considerations when using Connectors in Teams

  • Connectors are disabled by default in the Government Cloud Community (GCC) environments. To enable connectors, set the ConnectorsEnabled or ConnectorsEnabledForTeams parameters to $true with the SetOrganizationConfig cmdlet. To set the parameters, connect to the Exchange Online PowerShell.

  • If the user who added a connector to a team leaves the team, the connector continues to work.

  • You can't configure new connections for the following connectors:

    • Aha!
    • Airbrake
    • Aircall
    • App Links
    • AppSignal
    • Beanstalk
    • Bitbucket
    • Buddy
    • Buildkite
    • CATS
    • Chatra
    • CircleCI
    • CodeShip
    • Constant Contact
    • GetResponse
    • Ghost Inspector
    • Groove
    • Heroku
    • Honeybadger
    • Intercom
    • Logentries
    • Mailchimp
    • Microsoft Forms
    • Opsgenie
    • PagerDuty
    • Papertrail
    • Pivotal Tracker
    • Raygun
    • Rollbar
    • Runscope
    • SatisMeter
    • Semaphore
    • Sentry
    • Simple In/Out
    • Stack Exchange
    • SUBVERSION
    • TestFairy
    • Travis CI
    • Trello
    • Uptodown
    • Userlike
    • Wrike
    • XP-Dev
    • Zendesk