sp-dev-fx-webparts/samples/js-skype-status
Hugo Bernier 2aa5345319 It's called a **web part** not a **webpart** 2022-01-16 13:41:07 -05:00
..
assets Removing unnecessary office product from the sample metadata 2021-12-10 19:55:32 +02:00
config js-skype-status: upgrade to spfx 1.7.0 (#689) 2018-11-19 23:52:22 +02:00
images js-skype-status: fixed a bug where subscription to the current users status wouldn't work (#553) 2018-07-05 18:51:31 +03:00
src upgraded js skype status spfx180 (#822) 2019-03-30 12:55:16 +02:00
teams_skypePresence js-skype-status: upgrade to spfx 1.7.0 (#689) 2018-11-19 23:52:22 +02:00
typings adding js sample to demonstrate how to use UCWA SDK and subscribe to people status (#378) 2017-12-08 13:58:58 +02:00
.editorconfig adding js sample to demonstrate how to use UCWA SDK and subscribe to people status (#378) 2017-12-08 13:58:58 +02:00
.gitignore adding js sample to demonstrate how to use UCWA SDK and subscribe to people status (#378) 2017-12-08 13:58:58 +02:00
.yo-rc.json upgraded js skype status spfx180 (#822) 2019-03-30 12:55:16 +02:00
README.md It's called a **web part** not a **webpart** 2022-01-16 13:41:07 -05:00
gulpfile.js js-skype-status: upgraded to spfx 1.5.0 (#545) 2018-07-02 10:09:25 +03:00
package-lock.json Bump jquery from 3.3.1 to 3.5.0 in /samples/js-skype-status 2020-04-29 23:12:09 +00:00
package.json Bump jquery from 3.3.1 to 3.5.0 in /samples/js-skype-status 2020-04-29 23:12:09 +00:00
tsconfig.json upgraded js skype status spfx180 (#822) 2019-03-30 12:55:16 +02:00
tslint.json js-skype-status: upgrade to spfx 1.7.0 (#689) 2018-11-19 23:52:22 +02:00

README.md

page_type products languages extensions
sample
office-sp
skype
office-skype-business
javascript
typescript
contentType technologies createdDate
samples
SharePoint Framework
12/1/2017 12:00:00 AM

JavaScript Skype Status Web Part

Summary

This sample demonstrates how to use the UCWA JS SDK for skype in the SharePoint Framework. It shows how to subscribe to status change of the different people of the organization but you can get much more information, checkout the documentation
The goal is to demonstrate how you can leverage the SDK and to have the simplest approach, hence the usage of JQuery. No Framework (React, Angular, Knockout...) is used here but you can use that SDK in conjuction with any framwork.
No branding has been applied to keep it simple but you could perfectly leverage Office Ui Fabric to display persona cards.

Allows you to properly display and subscribe to change of users' availability.
See the demo:
demo

Compatibility

SPFx 1.8.0 Node.js v6 | v5 Compatible with SharePoint Online Does not work with SharePoint 2019 Does not work with SharePoint 2016 (Feature Pack 2) Local Workbench Compatible Hosted Workbench Compatible

Applies to

Solution

Solution Author(s)
js-skype-status Vincent Biret

Version history

Version Date Comments
1.4 March 27th, 2019 Upgrade to SPFx 1.8.0
1.3 November 18th, 2018 Upgrade to SPFx 1.7.0
1.2 July 4th, 2018 Fixed a bug when subscribing to the current user's status
1.1 June 22nd, 2018 Upgraded to SPFx 1.5
1.0 December 1, 2017 Initial release

Minimal Path to Awesome

Authentication

Because the Skype API's are secured, you first need to register an Azure Active Directory application.
To do that go to portal.azure.com and sign in as your tenant administrator.
azure active directory
Click on Azure Active Directory.
app registrations
Click on on App Registrations and then New Application Registration
app details entry
Enter any name, select Web app / API in Application Type and in Sign-In URL enter https://*.sharepoint.com/*, then click on Create
app details display
Take note of the application ID, we'll need it later. Click on required permissions.
skype permission
Click on add then select an API and select Skype for Business.
skype scopes
Select under delegated permissions both Read/Write Skype user contacts and groups, Read/Write Skype user information (preview), Receive conversation invites (preview) (the receive conversation permission is required to get access to the mePerson object and have access to the current user's presence information) then click select. Finish by clicking Done.
grant permission
Don't forget to click on Grant permissions and yes.

Updating the app

After copying that sample to your local machine and running npm install to install the depenencies, /src/webparts/skypePresence/services/Constants.ts open your favorite editor. Make sure you replace the value of ApplicationIdKey to the value application id we kept earlier.

Deploying the application

Start by running gulp package-solution and deploy the application to the app catalog. More information on how to do it here
At the end select SkypePresence web part instead
Don't forget to run gulp serve --nobrowser to start the debugging server.

Additional page required

Because Skype needs to silently redirect the user to a page for the authentication flow, you need to create an additional page called skypepresence in your site.
You don't need to add anything on that page.

Help

We do not support samples, but we this community is always willing to help, and we want to improve these samples. We use GitHub to track issues, which makes it easy for community members to volunteer their time and help resolve issues.

If you're having issues building the solution, please run spfx doctor from within the solution folder to diagnose incompatibility issues with your environment.

You can try looking at issues related to this sample to see if anybody else is having the same issues.

You can also try looking at discussions related to this sample and see what the community is saying.

If you encounter any issues while using this sample, create a new issue.

For questions regarding this sample, create a new question.

Finally, if you have an idea for improvement, make a suggestion.

Disclaimer

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.

tracking image