The Spark Message Meet widget allows developers to easily incorporate Cisco Spark 1 on 1 messaging into an application.
This widget handles the heavy lifting of coordinating between your application and the Spark APIs, and provides components of the Spark messaging experience without having to build all front end UI yourself.
This widget supports:
Depending on how comfortable you are with these frameworks, there are are a number of ways you can "install" our code.
If you haven't already, go to the Spark for Developers Portal (https://developers.ciscospark.com) and sign up for an account. Once you've created an account you can get your developer access token by clicking on your avatar at the top right of the screen.
When you want to eventually create an integration and have your own users take advantage of the widget, you'll need to create an integration with the following scopes:
Head over to the Spark for Developers Documentation for more information about how to setup OAuth for your app: https://developer.ciscospark.com/authentication.html
Using our CDN requires the least amount of work to get started. Add the following into your HTML file:
npm run bootstrapfrom the root of the sdk repo. You will want to run this every time you pull down any new updates for the sdk.
PACKAGE=widget-message-meet npm run grunt:package -- build
If you would just like to get running immediately follow these instructions to get a webpack-dev-server running with the widget.
.env file in the root of the SDK project with the following lines, replacing the Xs with the appropriate value:
From the root directory run:
PACKAGE=widget-message-meet npm run grunt:package serve
The easiest way to get the Spark Message and Meet Widget into your web site is to add the built resources and attach data attributes to your a container.
distdirectory to own project.
<script />tag to your page to include the
<link />tag to include
data-access-token: (required) Access token for the user account initiating the messaging session. For testing purposes you can use a developer access token from https://developers.ciscospark.com.
Include one of the following attributes:
data-to-person-email: Email of the message recipient.
data-to-person-id: User Id of the message recipient.
Because our widgets are built using React, you'll be able to directly import the modules and components into your React app.
YOUR_ACCESS_TOKEN with the access token of the user who is going to be sending the messages (for development purposes this can just be your Developer Access Token),
TARGET_USER_EMAIL with the email of the user who is receiving the messages, and
ELEMENT with the ID of the element you want to inject into.
If you have the User ID of the recipient, you may provide that in the property
MessageMeetWidget instead of using
This widget supports the follow browsers:
Please see CONTRIBUTING.md for more details.
© 2016-2017 Cisco and/or its affiliates. All Rights Reserved.