Skip to content
JavaScript SDK for Webex Teams
JavaScript Shell Python Dockerfile
Branch: master
Clone or download
Jenkins
Jenkins v1.80.2
Latest commit f65c0b7 Sep 13, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Revert "chore(circleci): move to executors and add integration test job" Aug 29, 2019
.github docs: add GitHub SUPPORT file Jul 12, 2018
.vscode chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
docker/builder chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
docs v1.80.2 Sep 12, 2019
documentation refactor(webex): rename repo and main package to webex Jun 9, 2019
packages/node_modules v1.80.2 Sep 12, 2019
scripts chore(bin-sauce-connect): deprecate @webex/bin-sauce-connect Aug 2, 2019
tooling chore(test-helper-sinon): deprecate @webex/test-helper-sinon Aug 2, 2019
wdio.helpers.d chore(styling): update eslint and fix all errors Apr 3, 2019
webpack chore(tooling): append u2c data to all catalogs Aug 15, 2019
.babelrc committed by mistake Jun 5, 2019
.codeclimate.yml refactor(webex): rename repo and main package to webex Jun 9, 2019
.coveralls.yml chore(build): configure coveralls Jul 22, 2016
.editorconfig feat(ciscospark): Initial commit for github.com Jul 7, 2016
.env.default chore(tooling): append u2c data to all catalogs Aug 15, 2019
.eslintignore build(script): update readmes and script output folder Dec 11, 2018
.eslintrc.yml refactor(rebranding): rebase + ediscovery and meetings fixes May 9, 2019
.gitattributes chore(tooling): tell github where our code is Apr 7, 2017
.github-todos feat(ciscospark): Initial commit for github.com Jul 7, 2016
.gitignore chore(meetings): remove separate meetings bundle Jul 23, 2019
.gitmodules feat(ciscospark): Initial commit for github.com Jul 7, 2016
.jscsrc feat(ciscospark): Initial commit for github.com Jul 7, 2016
.jsdoc.json refactor(webex): rename repo and main package to webex Jun 9, 2019
.nvmrc chore(nvm): use supported node for precommits Mar 7, 2019
.tern-project feat(ciscospark): Initial commit for github.com Jul 7, 2016
.yo-rc.json feat(ciscospark): Initial commit for github.com Jul 7, 2016
BUILD-ISSUES.md docs(readme): added more build dependency info Apr 12, 2019
CONTRIBUTING.md chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
Jenkinsfile chore(tooling): append u2c data to all catalogs Aug 15, 2019
LICENSE refactor(webex): rename repo and main package to webex Jun 9, 2019
README.md chore(rebranding): post rebranding fixes Jun 13, 2019
SCRIPTS.md chore(bin-sauce-connect): deprecate @webex/bin-sauce-connect Aug 2, 2019
UPGRADING.md docs(UPGRADING): fix Plugins section Jun 13, 2019
appveyor.yml chore(tooling): do not build samples on windows Nov 21, 2017
browsers-ng.js chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
browsers.js chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
commitlint.config.js chore(tooling): upgrade commitlint Apr 5, 2018
deps.js refactor(webex): rename repo and main package to webex Jun 9, 2019
jsconfig.json fix(plugin-phone): update video toggle flow Jul 2, 2018
karma-ng.conf.js chore(circleci): create new pipeline with CircleCI and add new Github… Jul 25, 2019
netlify.toml fix(samples): tweak webpack environment parameter Mar 7, 2019
package-lock.json chore(package): correct some issues caused from incomplete rebase Aug 12, 2019
package.json fix(npm): fix clean script Aug 13, 2019
rollup.config.js refactor(webex): rename repo and main package to webex Jun 9, 2019
run.sh chore(tooling): append u2c data to all catalogs Aug 15, 2019
sauce.py chore(tooling): append u2c data to all catalogs Aug 15, 2019
test.py chore(tooling): append u2c data to all catalogs Aug 15, 2019
wdio.conf.js chore(wdio): remove selenium version config Jul 29, 2019
webpack.config.js chore(tooling): append u2c data to all catalogs Aug 15, 2019

README.md

webex-js-sdk

Greenkeeper badge

npm license Build status

The Cisco Webex JS SDK

Upgrading from Cisco Spark to Webex?

This is a monorepo containing all officially maintained Cisco Webex JS SDK modules in the same repo. webex is a collection of node modules targeting our external APIs.

Install

We test against the Active LTS (Long Term Support) version of Node.js and use npm@6 to run security audits.

To install the latest stable version of the SDK from NPM:

npm install --save webex

Usage

To use the SDK, you will need Cisco Webex credentials. If you do not already have a Cisco Webex account, visit Cisco Webex for Developers to create your account and retrieve your access token.

See the detailed docs for more usage examples.

const Webex = require(`webex`);
const webex = Webex.init({
  credentials: {
    access_token: <your webex teams access token>
  }
});

// Create a room with the title "My First Room"
// Add Alice and Bob to the room
// Send a **Hi Everyone** message to the room
webex.rooms.create({ title: `My First Room` }).then(room => {
  return Promise.all([
    webex.memberships.create({
      roomId: room.id,
      personEmail: `alice@example.com`
    }),
    webex.memberships.create({
      roomId: room.id,
      personEmail: `bob@example.com`
    })
  ]).then(() =>
    webex.messages.create({
      markdown: `**Hi Everyone**`,
      roomId: room.id
    })
  );
});

A note on browser usage

We do provide a built, minified version of the SDK, that includes window.webex, which is hosted on our repo and can be used with gitcdn.xyz.

<script src="https://gitcdn.xyz/repo/webex/webex-js-sdk/master/packages/node_modules/webex/umd/webex.min.js"></script>

In-browser usage is almost the same as Node.js, but it handles the user authentication flow for you. See the browser guide for more information.

If you're already using a bundler (like Webpack or Rollup) you can simply import/require the package and use the above snippet and assign the initialized team variable to window.webex. For a quick example, we'll use Parcel to bundle the SDK for a website. For any more information and questions on how to use Parcel, please head to their website.

  1. Create index.js.
import { init as initWebex } from 'webex';

// Initialize the SDK and make it available to the window
const webex = (window.webex = initWebex({
  credentials: {
    access_token: <your webex teams access token>
  }
}));

// Create a room with the title "My First Room"
webex.rooms
  .create({
    title: 'My First Room!'
  })
  .catch((error) => {
    console.error(error);
  });

// Filter for "My First Room" from the last 10 rooms
webex.rooms
  .list({
    max: 10
  })
  .then((rooms) => {
    // Destructure room properties for its id (aliased to roomId) and title
    const { id: roomId, title } = rooms.items.filter(
      room => room.title === 'My First Room!'
    )[0];

    // Post message "Hello World!" to "My First Room!"
    webex.messages.create({
      roomId,
      text: 'Hello World!'
    });

    // Log the the room name and the message we created
    return webex.messages
      .list({ roomId, max: 1 })
      // Destructure promised value to get the text property from the first item in items array
      .then(({ items: [{ text }] }) =>
        console.log(`Last message sent to room "${title}": ${text}`)
      );
  })
  .catch((error) => {
    console.error(error);
  });
  1. Create index.html .
<html>
  <head>
    <title>Webex SDK for Browsers</title>
  </head>
  <body>
    <script src="./index.js"></script>
  </body>
</html>
  1. Run parcel index.html in your terminal.
  2. Go to http://localhost:1234 and open the developer console to see the output.

Still using webex/env or ciscospark/env?

Samples

Sample code can be found in packages/node_modules/samples. You can run them yourself with the following commands:

Note: This installs all of the SDK's tooling dependencies, so you'll need libgcrypt and (possibly) graphicsmagick. On a mac, you can install these with brew install graphicsmagick libgcrypt.

git clone git@github.com:webex/webex-js-sdk.git
cd webex-js-sdk
npm install
npm run samples:serve
Samples localhost Hosted
Samples code https://localhost:8000/ https://js.samples.s4d.io/

Contribute

Pull requests welcome. Please see CONTRIBUTING.md for more details about building the packages and submitting pull requests for suggested changes.

License

© 2016-2019 Cisco and/or its affiliates. All Rights Reserved.

See LICENSE for details.

You can’t perform that action at this time.