This solution is an example for the [Valo Connect] widgets extensibility framework. When this SharePoint Framework solution is added to a Valo Connect customer's environment, two new widgets will be available:
- ServiceNow - View Incidents breached SLA inside Microsoft Teams
- Xero - Open your payslip inside Microsoft Teams
- Zendesk - View assigned zendesk tickets in Microsoft Teams
Combined with the sample valo-connect-integration-proxy Azure Function solution, customers and partners can reference the approach outlined in these solutions to build a custom widget that integrates with third-party software applications with OAUTH2 capable authentication platforms, and presents data from the third-party applications in to the Connect Me / Microsoft Teams personal dashboard.
Get your own free development tenant by subscribing to Microsoft 365 developer program
- This solution runs in a Microsoft Teams environment, part of the Microsoft 365 platform
- The solution an extension deployed on top of Valo Connect. The Microsoft Teams environment must already have Valo Connect installed for this extension to work
- Valo partners can access more information on the deployment steps of Valo Connect extension packages here
| Solution | Author(s) | Contact |
|---|---|---|
| ./src/extensions/connectMeServiceNow | Mark Powney, Product Owner at Valo Solutions (a Staffbase company) | Twitter: @mpowney |
| ./src/extensions/connectMeXero | Mark Powney, Product Owner at Valo Solutions (a Staffbase company) | Twitter: @mpowney |
| ./src/extensions/connectMeZendesk | Mark Powney, Product Owner at Valo Solutions (a Staffbase company) | Twitter: @mpowney |
| Version | Date | Comments |
|---|---|---|
| 1.0.3 | May 9, 2022 | Added Zendesk extension sample widget |
| 1.0.2 | March 11, 2022 | Updated README with descriptive information about this solution |
| 1.0.1 | August 17, 2021 | Added Xero and ServiceNow extension widgets as samples |
| 1.0.0 | August 4, 2021 | Initial release |
THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.
- Clone this repository
- Ensure that you are at the solution folder
- in the command-line run:
- npm install
- gulp bundle --ship
- gulp package-solution --ship
- follow steps to deploy the bundled SPFx solution, documented here
Two widgets are made available to users of Valo Connect and Connect Me when this solution is deployed. Each widget implements the steps needed to authenticate to the respective third-party applications - ServiceNow, and Xero.
This extension illustrates the following concepts:
- obtaining an authentication token from:
- ServiceNow authentication platform
- Xero authentication platform
- Zendesk authentication platform
- managing authentication tokens in Microsoft Teams, e.g. long-life refresh tokens from ServiceNow, and silently refreshing access tokens
- integrating Microsoft Teams with a custom Azure Function app to make an auth token available inside Microsoft Teams
- Getting started with SharePoint Framework
- Building for Microsoft teams
- Use Microsoft Graph in your solution
- Publish SharePoint Framework applications to the Marketplace
- Microsoft 365 Patterns and Practices - Guidance, tooling, samples and open-source controls for your Microsoft 365 development