Microsoft Console Integration to reply to reviews
In This Article
Integration with Microsoft Console provides you with the powerful tool to get user feedback and respond to it right away. Using this integration, you will get Windows apps and XBox games reviews into AppFollow interface, any help-desk services or team chats you use and will be able to respond not leaving them.
Set up the Reply to Reviews Integration with Microsoft Store
1. Go to watch.appfollow.io > Integrations List and choose a Microsoft app. Then click "Add Integration";
2. Complete prerequisites for using the Microsoft Store reviews API.
Before you start writing code to call the Microsoft Store reviews API, make sure that you have completed the following prerequisites:
- You (or your organization) must have an Azure AD directory and you must have Global administrator permission for the directory. If you already use Office 365 or other business services from Microsoft, you already have Azure AD directory. Otherwise, you can create a new Azure AD in Partner Center for no additional charge.
- You must associate an Azure AD application with your Partner Center account, retrieve the tenant ID and client ID for the application and generate a key. The Azure AD application represents the app or service from which you want to call the Microsoft Store reviews API. You need the tenant ID, client ID and key to obtain an Azure AD access token that you pass to the API.
To associate an Azure AD application with your Partner Center account and retrieve the required values:
- In Partner Center, associate your organization's Partner Center account with your organization's Azure AD directory.
- Next, from the Users page in the Account settings section of Partner Center, add the Azure AD application that represents the app or service that you will use to respond to reviews. Make sure you assign this application the Manager role. If the application doesn't exist yet in your Azure AD directory, you can create a new Azure AD application in Partner Center.
- Return to the Users page, click the name of your Azure AD application to go to the application settings, and copy down the Tenant ID and Client ID values.
- Click Add new key. On the following screen, copy down the Key value. You won't be able to access this info again after you leave this page. For more information, see Manage keys for an Azure AD application.
3. Obtain an Azure AD access token
Before you call any of the methods in the Microsoft Store reviews API, you must first obtain an Azure AD access token that you pass to the Authorization header of each method in the API. After you obtain an access token, you have 60 minutes to use it before it expires. After the token expires, you can refresh the token so you can continue to use it in further calls to the API.
To obtain the access token, follow the instructions in Service to Service Calls Using Client Credentials to send an HTTP POST to the
https://login.microsoftonline.com/<tenant_id>/oauth2/token endpoint. Here is a sample request.
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1<br>Host: login.microsoftonline.com<br>Content-Type: application/x-www-form-urlencoded; charset=utf-8<br> grant_type=client_credentials<br>&client_id=<your_client_id><br>&client_secret=<your_client_secret><br>&resource=https://manage.devcenter.microsoft.com<p>For the <em>tenant_id</em> value in the POST URI and the <em>client_id</em> and <em>client_secret</em> parameters, specify the tenant ID, client ID and the key for your application that you retrieved from Partner Center in the previous section. For the <em>resource</em> parameter, you must specify <code>https://manage.devcenter.microsoft.com
4. Call the Microsoft Store reviews API
After you have an Azure AD access token, you are ready to call the Microsoft Store reviews API. You must pass the access token to the Authorization header of each method.
The Microsoft Store reviews API contains several methods you can use to determine whether you are allowed to respond to a given review and to submit responses to one or more reviews. Follow this process to use this API:
- Get the IDs of the reviews you want to respond to. Review IDs are available in the response data of the get app reviews method in the Microsoft Store analytics API and in the offline download of the Reviews report.
- Call the get response info for app reviews method to determine whether you are allowed to respond to the reviews. When a customer submits a review, they can choose not to receive responses to their review. You cannot respond to reviews submitted by customers who have chosen not to receive review responses.
- Call the submit responses to app reviews method to programmatically respond to the reviews.
5. Get back to your AppFollow account and insert Client ID, Client secret, and Client tenant you got on the previous steps and click "Add Integration".
6. Once the status is "Active", you will be able to reply to reviews from AppFollow.