Business Assist (Preview)

Business Assist uses Machine Learning models which will help in improving the customer experience and provide customer success. This will help you optimize your customer support that can help you forecast call volumes, analyze customer feedback, and provide self-help support for faster service. You can integrate with any platform they already use, allowing them to create their own technology stack based on both preference and value.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Microsoft
URL	https://admin.microsoft.com
Email	PowerConnector-BA@microsoft.com

Connector Metadata
Publisher	Microsoft
Website	https://microsoft.com
Privacy policy	https://support.microsoft.com/privacy
Categories	AI

The Business Assist APIs are a set of Machine learning based tools developed to help automate common customer success-oriented tasks. They will help customers and partners achieve their goals to reduce costs, more efficiently listen to customers, and respond to their needs more quickly. These tools will allow large scale data analysis to be performed quickly and automatically. The Business Assist APIs give you tools to better understand your customers' wants and needs and respond to them more quickly.

Forecasting: Customer service organizations need to reliably predict service call volumes to allocate resources and set staffing levels appropriately. Analyzing past trends and volume levels manually is a time-consuming task. Using machine learning can speed up the process considerably. The Business Assist Forecast API brings the ability to quickly and confidently forecast future support case volume based on historical data.

TextAnalytics:Business Assist TextAnalytics offers Microsoft's Artificial Intelligence and Machine Learning tools to our customers. As one of the largest companies in the world, Microsoft receives massive amounts of user feedback, and needs powerful tools to point towards the feedback that matters which created need for self-serve text analytics.

SelfHelp: Organizations can improve their customers' experience by helping users solve issues on their own without ever needing to contact support. The Business Assist SelfHelp API helps find self-serve solutions from Microsoft's extensive library of support articles.

Prerequisites

You will need the following to proceed:

A Microsoft PowerApps or Microsoft Power Automate plan with custom connector feature. An Azure subscription.

How to get credentials

1. You need to have your app registered in Azure Active Directory, as APIs used by the connector are secured by Azure Active Directory (AD).
2. Generate a client secret id, copy that secret value before you close or redirect to another blade.
3. You can connect securely with the connector.

Get started with your connector

1. Select "Create"
2. Select "Automated Cloud Flow".
3. Under Triggers select “Manually trigger a flow”.
4. Select "New Step".
5. Under "Actions" under "Premium" search for Business Assist conenctor.
6. Based on the service you want to use, you can select the Forecasting, TextAnalytics or SelfHelp connector.
7. Once you have selected the service, you can add the input in json format and click save and test the flow and get the output results.

Common errors and remedies

Highlight any errors that might commonly occur when using the connector (such as HTTP status code errors), and what the user should do to resolve the error.

1. HTTP status: 500 a. Submit Request Failed: The request failed because of an internal error. b. Get Status Request Failed: The request failed because of an internal error. c. Get Result Request Failed: The request failed because of an internal error.
2. HTTP status: 403 Ensure your application is registered and you are connected with Business Assist connector.

Creating a connection

The connector supports the following authentication types:

Default	Parameters for creating connection.	All regions	Not shareable

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

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create forecast job	Submit forecast job to Business Assist.
Create text analytic job	Submit text analytic job to Business Assist.
Get self-help insights	Get self-help insights from Business Assist.

Create forecast job

Operation ID:

CreateForecastJob

Submit forecast job to Business Assist.

Parameters

Name	Key	Required	Type	Description
Name	Name	True	string	User-defined name for the Forecast job.
Forecast end date	EndDateTime	True	string	End date for the forecasting. It can be yyyymmdd, mm/dd/yyyy, or other widely known date format.
Seasonality	Seasonality	True	string	Divide forecasts by time periods for comparison. Select at most two seasonality from (daily, weekly, monthly, quarterly, yearly).
Include prediction interval	IncludePredictionInterval	True	boolean	Include prediction interval with results.
History data JSON	inputDataJson	True	string	JSON-formatted version of the historical data. For example, ``[{"Date":"2022-07-01","Ticket":"195","DAO":"20000"},{"Date":"2022-07-02","Ticket":"774","DAO":"20500"}]`
Date property name	DateTimeColumnName	True	string	Column header for the column containing data and time information.
Volume property name	VolumeColumnName	True	string	Column header for the column containing volume data.
Adjustment property names	AdjustmentColumnNames		array of string	["DAO"]
Special date data JSON	SpecialDateDataJson		string	JSON-formatted string containing special date data. [{"Date":"2021-10-28","Name":"IgniteDay1"}]
Special date adjustment data JSON	SpecialDateAdjustmentDataJson		string	JSON-formatted string containing adjustments to make on special dates. [{"Date":"2022-10-01","Ratio":"-0.3"}]
Name of the column in the `specialDateFileName` listing dates for special days and holidays.	SpecialDateColumnName		string	Date
Name of the column in the `specialDateFilename` listing names of special days and holidays.	SpecialDateEventColumnName		string	Name
Special date adjustment property name	SpecialDateAdjustmentColumnName		string	Name of the column in the special event data describing the adjustments to make.

Returns

Name	Path	Type	Description
OperationId	OperationId	string	Job ID, use to get status and results
Name	Name	string	User-defined name for the Forecast job
Status	Status	integer	Status code of forecast job.
Diagnostics	Diagnostics	string	Errors or warnings generated during job creation
Results	Results	array of object	Results
Date	Results.Date	string	Date
Forecast	Results.Forecast	float	Forecast
Low	Results.Low	float	Low
High	Results.High	float	High

Create text analytic job

Operation ID:

CreateCluserting

Submit text analytic job to Business Assist.

Parameters

Name	Key	Required	Type	Description
Name	Name		string	Name
RecordId	RecordId		string	A unique identifier is assigned to each record.
Text	Text		string	The text associated with a record.

Returns

Name	Path	Type	Description
OperationId	OperationId	string	OperationId
Name	Name	string	Name
Status	Status	integer	Status
Diagnostics	Diagnostics	string	Errors or warnings generated during job creatio
Results	Results	array of object	Results
RecordId	Results.RecordId	string	RecordId
Cluster_Id	Results.Cluster_Id	integer	Cluster_Id
Cluster_Probability	Results.Cluster_Probability	float	Cluster_Probability
Cluster_Label	Results.Cluster_Label	string	Cluster_Label

Get self-help insights

Operation ID:

GetSelfHelpInsights

Get self-help insights from Business Assist.

Parameters

Name	Key	Required	Type	Description
Problem Description	QueryText	True	string	Text of the user's query.
Locale	Locale	True	string	Locale to use for the solution returned.

Returns

Name	Path	Type	Description
solutions	solutions	array of object	Instant answer to the user query. Contains title, details and SolutionConfidence score.
title	solutions.title	string	Solution or article title.
details	solutions.details	string	Preview text of article or content.
solutionConfidence	solutions.solutionConfidence	float	Algorithmic confidence score of the confidence the solution is relevant to the query.
webSearchResults	webSearchResults	array of object	Related article from the web search.Contains the title, details, and url found through a web search.
title	webSearchResults.title	string	Solution or article title.
details	webSearchResults.details	string	Preview text of article or content.
url	webSearchResults.url	string	Link to full content of the WebSearchResults.
serviceIncidents	serviceIncidents	array of object	ServiceIncidents
id	serviceIncidents.id	string	Id
serviceName	serviceIncidents.serviceName	string	ServiceName
issueType	serviceIncidents.issueType	string	IssueType
startTime	serviceIncidents.startTime	string	StartTime
endTime	serviceIncidents.endTime	string	EndTime
lastUpdatedTime	serviceIncidents.lastUpdatedTime	string	LastUpdatedTime
impactDescription	serviceIncidents.impactDescription	string	ImpactDescription
title	serviceIncidents.title	string	Title
severity	serviceIncidents.severity	string	Severity
issueStatus	serviceIncidents.issueStatus	string	IssueStatus
isIncidentResolved	serviceIncidents.isIncidentResolved	boolean	IsIncidentResolved