Dynamics 365 Commerce - Ratings and Reviews

Utilize Dynamics 365 Commerce Ratings and Reviews APIs to import new reviews, export existing reviews, and more!

This connector is available in the following products and regions:

The Dynamics 365 Commerce - Ratings and Reviews connector provides a set of actions to interact with the Dynamics 365 Ratings and Review Service APIs. These actions facilitate importing and exporting of reviews data. Two actions are available: Export All Reviews and Submit a Review.

Prerequisites

You will need the following to proceed:

• Microsoft Dynamics 365 Commerce subscription
• Enabled Ratings and Reviews solution Details

Contact a Dynamics 365 Commerce partner here for details on how to get started with Microsoft Dynamics 365.

How to get credentials

The first step is to register the connector as an application in Microsoft Entra ID. This allows the connector to identify itself to Microsoft Entra ID and ask for permissions to access Ratings and Reviews data on behalf of the end user. Read more about this here and follow the steps below:

1. Create an Microsoft Entra ID application:

This Microsoft Entra ID application will be used to identify the connector connection to Ratings and Reviews. This can be done using Azure Portal, by following the steps here to register an app on Microsoft Entra ID and enable authentication.

During registration, capture the following information, as it will be used to establish an authenticated connection with the connector using service principal:

• Client Application ID
• Client Secret (remember to note this down, as it is only shown once).
• Client directory (tenant) ID.

With the Microsoft Entra ID application created, it can now be used to get permissions from end users. Use the fields you have saved to establish an authenticated connection via service principal using the Dynamics 365 Commerce - Ratings and Reviews Connector.

The next step is to register this app in the Ratings and Reviews moderation tool settings page.

2. Register the Microsoft Entra ID Application in the Ratings and Reviews Moderation Tool

In order for the Ratings and Reviews service to authenticate operations coming from the connector, clients must register their Microsoft Entra ID app within the Ratings and Review moderation tool settings page. Use the Client application ID and the Client directory ID from the previous step to add a Service to Service (S2S) application entry. For more details on how to manage Ratings and Reviews settings from the Moderation Tool, refer here.

Get started with your connector

To get started with the Dynamics 365 Commerce - Ratings and Reviews Connector, simply add it an existing flow, or start with searching up our sample template flows for import and export of reviews.

Note: The Dynamics 365 Commerce - Ratings and Reviews Connector will be available in all Power Automate regions, but Ratings and Reviews will only process calls in regions supported for your tenant. Be sure to review compliance requirements for your organization and create the Power Automate environment in a region that fits compliance needs.

FAQ

• What is the maximum length of a review text body and review title?

  The maximum length of a review title is 55 characters. The maximum length of the review text body is 1,000 characters.

• What is the structure of the encodedUser parameter in the Submit Review action?

  The encodedUser adds additional security in order to pass user information. It encodes a user identity schema to base64. Refer to the schema structure below to compose the object in your flow, and then use the built in toBase64() function to encode it before passing it in the SubmitReview action.

  {
      "p" : {
              "t" : "Unix epoch in seconds (should be within an hour of current time)",
              "email" : "Reviewer User Email Here",
              "name" : "Reviewer User Name Here",
              "id" : "Reviewer User Id Here"
          }
  }
  

  For more details, check out an example of this in our import reviews template flow.

• I need more support. Who can I reach out to?

  Contact Dynamics 365 Commerce support for general support or email d365ratingreviewconn@microsoft.com.

Creating a connection

The connector supports the following authentication types:

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Actions

Export All Reviews

Submit User Review

Definitions

SubmitReviewResponse

ExportSuccessfulResponse