SharePoint Webex Space Integration

Embed Webex Space Widget inside UA Sharepoint Portal
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • URL Examples
2. Getting Started
   • Installation
3. Contributing
4. License
5. Contact

*Everything included is for demo and Proof of Concept purposes only. Your use of the site is solely at your own risk. This site may contain links to third party content, which we do not warrant, endorse, or assume liability for. These demos are for Cisco Webex usecases, but are not Official Cisco Webex Branded demos.

About The Project

To display two space widgets in a single web application. One widget to only display the content and messages being sent in a targeted space (SPACE_DESTINATION) and the other space widget to allow the user with a valid ACCESS_TOKEN to chat with an agent** (AGENT_EMAIL_ADDRESS) by clicking on Connect On Webex button. After clicking on Connect On Webex button, the user will automatically get redirected to Webex Desktop application to chat with an agent.

** skipping this parameter will hide the Connect On webex button.

Note that there are some URL parameters that need to be passed before running this PoC.

Parameters	Description	Default Value	Required
accessToken	Valid access token that can be retrieved in here	<YOUR_ACCESS_TOKEN>	Yes
spaceDestination	Valid space ID to display the view-only widget	<SPACE_ID>	Yes
agent	Valid email address to chat with	<AGENT_EMAIL_ADDRESS>	No
displayTextBox	To convert the read-only mode space back to read-write mode	no	No

URL Examples

Example #1 - to render a read-only space widget with the button to chat with an agent

https://wxsd-sales.github.io/sharepoint-space-widget/?accessToken=<YOUR_ACCESS_TOKEN>&spaceDestination=<TARGETED_SPACE_ID>&agent=<VALID_EMAIL_ADDRESS>

Example #2 - to render a read-write space widget with the button to chat with an agent

https://wxsd-sales.github.io/sharepoint-space-widget/?accessToken=<YOUR_ACCESS_TOKEN>&spaceDestination=<TARGETED_SPACE_ID>&agent=<VALID_EMAIL_ADDRESS>&displayTextBox=true

Example #3 - to render a read-write space widget without the button

https://wxsd-sales.github.io/sharepoint-space-widget/?accessToken=<YOUR_ACCESS_TOKEN>&spaceDestination=<TARGETED_SPACE_ID>&displayTextBox=yes

Getting Started

If you would like to contribute to our source code and to improve our demo, please follow the steps mentioned below:

Installation

1. Clone the repo

   git clone https://github.com/WXSD-Sales/sharepoint-space-widget.git

2. We use NVM to manage our node.js machine versioning. You can learn more about NVM here

   nvm use

3. Install the packages via Yarn

   yarn

4. Start the server

   yarn start

5. This app requires some environment variables - env default template file is provided.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch in your forked repo (git checkout -b myrepo/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin myrepo/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

wxsd@cisco.external.com