microsoftOmnichannel SDK
This repo contains the source code for getting up and running with the Omnichannel SDK on the web using standard web technologies and on mobile using React Native.
Getting Started
Prerequisites
- Node v12.13.0 (or equivalent)
- npm
Installation
npm installBuild
Load SDK in memory and watches the changes for development
npm run watchBuild SDK for development
npm run build:devBuild SDK for production
npm run build:prodCheck lint rules
npm run lint
```console
Lint checks is enabled by default in watch mode.
# Examples
### Initialize SDK
```js
const params = {
orgUrl: '',
orgId: '',
widgetId: '',
}
const ocsdk = Microsoft.CRM.Omnichannel.SDK.SDKProvider.getSDK(params);
window.ocsdk = ocsdk;Initialize SDK with custom configuration
const params = {
orgUrl: '',
orgId: '',
widgetId: '',
}
const configuration = {
getChatTokenRetryCount: 35,
getChatTokenTimeBetweenRetriesOnFailure: 10000,
maxRequestRetriesOnFailure: 5
};
const ocsdk = Microsoft.CRM.Omnichannel.SDK.SDKProvider.getSDK(params, configuration);
window.ocsdk = ocsdk;Get Chat Config
// Manually generate request id
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
try {
const config = await window.ocsdk.getChatConfig(requestId);
// success
} catch {
// failure
}
// Auto generate request id
try {
const config = await window.ocsdk.getChatConfig();
// success
} catch {
// failure
}Get Chat Token
// Manually generate request id
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
try {
const chatToken = await window.ocsdk.getChatToken(requestId);
// success
} catch {
// failure
}
// Auto generate request id
try {
const chatToken = await window.ocsdk.getChatToken();
const {requestId} = chatToken; // Request ID auto generated used to getChatToken
// success
} catch {
// failure
}Session Init
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
const optionalParams = {
authenticatedUserToken: '',
getContext: true, // Automically gets browser, device, location & os info
initContext: { // Optional init context to pass
locale: '', // 'en-us' by default if not set
originalurl: '', // window.href.location by default
os: '',
browser: '',
device: '',
longitude: '',
latitiude: '',
preChatResponse: {}
}
};
try {
await window.ocsdk.sessionInit(requestId, optionalParams);
// success
} catch {
// failure
}Session Close
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
const optionalParams = {
authenticatedUserToken: '',
};
try {
await window.ocsdk.sessionClose(requestId, optionalParams);
// success
} catch {
// failure
}Submit PostChat Response
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
const postChatResponse = {};
const optionalParams = {
authenticatedUserToken: '',
};
try {
await window.ocsdk.submitPostChatResponse(requestId, postChatResponse, optionalParams);
// success
} catch {
// failure
}Get Chat Transcripts
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
const chatId = ''; // Chat thread ID
const token = ''; // Skype token
const optionalParams = {
authenticatedUserToken: '',
};
try {
const response = await window.ocsdk.getChatTranscripts(requestId, chatId, token, optionalParams);
// success
} catch {
// failure
}Email Transcript
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
const token = ''; // Skype token
const emailRequestBody = { // Email body
ChatId: '', // Chat thread ID
EmailAddress: 'contoso@microsoft.com',
DefaultAttachmentMessage: '',
CustomerLocale: 'en-us'
};
const optionalParams = {
authenticatedUserToken: '',
};
try {
await window.ocsdk.emailTranscript(requestId, token, emailRequestBody, optionalParams);
// success
} catch {
// failure
}Fetch Data Masking Info
// Manually generate request id
const requestId = Microsoft.CRM.Omnichannel.SDK.Util.uuidv4();
try {
const response = await window.ocsdk.fetchDataMaskingInfo(requestId);
// success
} catch {
// failure
}
// Auto generate request id
try {
const response = await window.ocsdk.fetchDataMaskingInfo();
// success
} catch {
// failure
}SDK Configuration
These are the available config options with its default values for the SDK.
{
/**
* Number of times a getchattoken request is retried.
*/
getChatTokenRetryCount: 35,
/**
* Time in milliseconds between two successive getchattoken retry requests.
*/
getChatTokenTimeBetweenRetriesOnFailure: 10000,
/**
* Maximum number of request retries before failing.
*/
maxRequestRetriesOnFailure: 5,
}Contributing
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.