Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
- This is a production-ready preview feature.
- Production-ready previews are subject to supplemental terms of use.
[This article is prerelease documentation and is subject to change.]
This article provides concise instructions to help you quickly start to build a Microsoft Power Platform connector by using your application APIs, so that you can extend Sales. For more comprehensive information about connectors, go to Connectors overview.
After you build your custom connector, you must create an action in Microsoft Copilot Studio, enable it for your users, and get it certified.
Create and test a custom connector in Microsoft Power Platform
Download the OpenAI file to quickly get started with the connector actions that are needed to extend Sales.
You can create a custom connector from either Power Apps or Power Automate.
Be sure to use an environment where Dynamics 365 apps are enabled, because environments of this type are used in the Sales Outlook add-in. Environments without Dynamics 365 apps, such as the default environment, aren't supported for custom connectors. To create a new environment where Dynamics 365 apps are enabled, go to Create an environment with a database.
When you set up authentication for the connector, be sure to use the OAuth 2.0 authentication type, and be sure to use Microsoft Entra ID as the authentication provider. (Microsoft Entra ID was previously known as Azure Active Directory or Azure AD.) In this way, your back-end service can receive Microsoft Entra ID tokens that can then be exchanged when Microsoft services such as Microsoft Graph are invoked. The connector and the back-end service are secured by using two different application registrations, as described in Set up Microsoft Entra ID authentication.
For the steps to create a custom connector, set up authentication, and test the connector, go to Create a custom connector from an OpenAPI definition.
Note
To automatically create connection for connector plugins using Microsoft Entra ID, you must set the Enable on-behalf-of login value to "true" in the Security section of the custom connector. For more information, see Manage connections
Create and publish an action in Copilot Studio
Actions determine what operations are performed with the custom insights and data sources, such as the custom connectors that you built. They enable Sales to identify the external sources that insights should be extracted from to enrich the Sales experience. You can create actions based on the connector that you developed by using Copilot Studio. For more information, go to Create and configure Copilot plugins.
Note
If Sales doesn't currently appear in Copilot Studio, ask your administrator to deploy the Sales enhanced Teams app.
Enable the connector action for users
Before Sales users can access a connector action that is published in Copilot Studio, a Sales administrator must enable it. If you want to enable a connector action for your Copilot users, ask your administrator to follow these steps.
Note
- Actions enabled by your administrator could take up to seven days to be ingested in Sales experiences. To force a quicker update, ask the users to sign out and then sign in again to Sales in either Outlook or Teams.
- When you enable a connector action for Sales, Sales users in Microsoft 365 and Teams applications might be able to send and receive data from external sources by using Sales, even if the same connector action was disallowed for direct use with Microsoft 365. Before you enable a connector action, we recommend that you ensure that it complies with your organization's policies.
- The data and insights that connector actions bring to Sales experiences are powered by third parties. They might be subject to third-party terms and conditions and/or privacy policies. We recommend that you validate these connector actions for compliance with your organization's policies.
Get your connector and action certified (optional)
After you create a custom connector and connector action in Copilot Studio, they become accessible in your tenant. If you want to make your connector and action available to all Sales users, you must get them certified. Learn more about getting your Power Platform connector and plugin certified. To get your connector and action certified, you must prepare Power Platform connector and plugin files for certification.
Related information
Extend Sales in Microsoft 365 Copilot with partner applications
Build Sales extensions