Awesome Webex

A curated list of Webex Developer Resources, inspired by awesome-go and awesome-python.

Note that this list covers Webex Messaging, Meetings and Devices APIs and SDKs, as well as Webex Admin APIs. Check awesome-xapi if you are interested in developer resources for on-premises Cisco Collaboration Devices.

Contributing

Please take a quick gander at the Contribution guidelines first. Thanks to all contributors; you rock!

If you see a package or project here that is no longer maintained or is not a good fit, please submit a pull request to improve this file. Thank you!

Contents

DISCLAIMER: Cisco does not make any commitments about the resources listed in this document, nor the accuracy of the third party resources and any content accessible via the links below.

• Bot frameworks
• Clients SDKs
  • REST API
  • Advanced APIs
• Code samples
  • REST API samples
  • Bot samples
  • Mobile samples
  • Web SDK & Widgets samples
• Developer Tools
  • Postman collections
• Integration Services
• Reference

Bot frameworks

Libraries to code your own bots and integrations implementing Webhooks and/or the OAuth Grant Flow.

• Java
  • odl-sparkbot - An SDK for developing clients and bots on top of the OpenDaylight platform (by jmedved).
• JavaScript
  • Botkit - Build conversational bots that can live on multiple platforms (by Howdy.ai).
  • bot-connector - Connect your bot to multiple messaging channels (by Recast.ai).
  • flint - Bot SDK for Node.js (by nmarus).
  • hubot-spark - A Hubot integration (by tonybaloney).
  • hubot-sparkwebhook - A Hubot adapter (by marchfederico).
  • node-sparkbot - Build bots in Node.js and experiment webhooks (by ObjectIsAdvantag).
  • webex-bot-node-framework - A port of flint using the webex-js-sdk (by jpjpjp).
• Perl
  • cisco_spark-perl - Asynchronous Bot and HTTP Client Library for Perl (by akalinux).
• PHP
  • botman - Driver to connect with BotMan (by mpociot).
• Python
  • err-backend-cisco-spark - An errbot backend (by panholt).
  • err-backend-cisco-webex-teams - An errbot backend (by marksull).
  • webexteamsbot - A framework for simple '/command' bots (by hpreston)

Client SDKs

REST API clients

• C#
  • SparkDotNet - An unofficial dotnet library for consuming the RESTful APIs (by darrenparkinson).
• Elixir
  • ex_webexteams - Elixir package (by zpeters).
• Go
  • go-cisco-webex-teams - A Go client library (by jbogarin).
• Haskell
  • webex-teams-api - A Haskell binding (by nshimaza).
• Java
  • webex-java-sdk - A Java library for consuming the RESTful APIs (by Cisco Webex).
• Node.js
  • sparkclient - A simple Node.js module (by marchfederico).
  • sparky - A simple API wrapper for Node.js (by nmarus).
  • webex-js-sdk - Wrapper maintained by Cisco's engineering group (by Cisco Webex).
• Perl
  • cisco_spark-perl - Asynchronous Bot and HTTP Client Library (by akalinux).
• PHP
  • SparkBundle - Symfony bundle (by CiscoVE).
• Python
  • aiociscospark - Python 3 asynchronous API client (by andriyko).
  • pyCiscoSpark - Python library (by brbester).
  • spark-python-sdk - Python module for consuming the RESTful APIs (by Bassintag551).
  • webexteamssdk (formerly ciscosparkapi) - Work with the REST APIs in native Python (by cmlccie).
• Ruby
  • cisco_spark-ruby - Ruby client (by NGMarmaduke).
  • ciscospark-ruby - REST kit for Ruby (by chadstachowicz).

Advanced APIs

• SDK for Android - Integrate messaging and calling in your Android apps (by Cisco Webex).
• SDK for Browsers - Integrate calling into your client-side JavaScript applications (by Cisco Webex).
• SDK for iOS - Integrate messaging and calling in your iOS apps (by Cisco Webex).
• SDK for Windows - Integrate messaging and calling in your Windows apps (by Cisco Webex).
• Widgets - React components that mimic the Web user experience (by Cisco Webex).

Code samples

REST API samples

• Node.js
  • integration-sample - Creating a server-side OAuth integration (by ObjectIsAdvantag).
  • node-sparky-samples - Client samples with node-sparky (by ObjectIsAdvantag).
  • spark-messages - A collection of helpers to ensure consistent formatting of markdown messages (by brh55).
• Python
  • Blog companions - Simple scripts and bots (by Webex Developer support).
• Ruby
  • Fault Report - Reporting dystem for efficient Fault Resolution (by jfield44).

Bot samples

• Java
  • Midori - An extensible chat robot platform (by midoricorp).
  • QuizBot - Answer a technology quiz, get scored (by LucaCalabrese).
• Node.js
  • email2spark - Move an email thread to a space using Mailgun (by marchfederico).
  • generator-spark-bot - A yeoman generator that scaffolds out a bot with usability and simplicity in mind (by brh55).
  • sparkbot-samples - Examples of bots, leveraging the node-sparkbot framework (by ObjectIsAdvantag).
  • sparkbotstarter - Starter kit for a simple bot leveraging flint (by valgaze).
  • zbot - Play the Zork interactive game in spaces (by akalsey).
• Node.js (Botkit)
  • botkit samples - Conversational bot samples built with Botkit (by ObjectIsAdvantag).
  • botkit-template - Best practices to bootstrap a Botkit project (by ObjectIsAdvantag).
  • ciscospark-jira - Jira bot built with Botkit (by patricksmith).
  • spark-botkit-salesforce - SalesForce bot built with Botkit (by asynchrony-ringo).
  • spark-botkit-servicenow - ServiceNow bot built with Botkit (by asynchrony-ringo).
• PHP
  • botman-spark-demo - Use BotMan in combination with the REST API (by mpociot).
• Python
  • ciscosparkapi bots - Flask, webpy and pyramid bot examples (by cmlccie).
  • My Hero - Vote for your favorite superhero, deploy as a docker container on Mantl.io (by hpreston).
  • pyIntegration - Flask OAuth example utilizing ciscosparkapi (by lorashley).
  • Room Finder - Bot to a meeting room finder interfaced with Microsoft Exchange (by Guismo1).
  • Walkthrough - Quick walkthrough to build a simple bot (by JustinDupree).

Mobile samples

• Android
  • Kitchen Sink - Developer friendly sample to showcase the Android SDK features (by Cisco Webex).
  • Goggles - ‘You See What I See’ remote expert app for augmented reality headsets (by Promptworks).
  • Wrapper - Embed video calls into your Android App in a few lines of code (by weddle).
• iOS
  • Buddies - Application which combines message/call in a UI (by Cisco Webex).
  • iOS SDK Wrapper - Wrapper library offering a drop in voice and video calling component (by jfield44).
  • Kitchen Sink - Developer friendly sample to showcase the iOS SDK features (by Cisco Webex).
  • Notification Server - Receive Incoming Call Notifications using Apple Push Notification Service (by Cisco Webex).

Web SDK & Widgets samples

• SDK for Browsers
  • call samples - Offical samples of the Browser SDK in action (by Cisco Webex).
• Widgets
  • custom-menu - Creating custom activities (by adamweeks).
  • oauth-example - Widget OAuth example with the JavaScript SDK (by adamweeks).
  • webdialer - Test calls and overlay an existing Web site (by achhabra2).
  • widget-samples - Examples for the Space and Recents widgets (by ObjectIsAdvantag).
  • widget-space-demo - Source code for the Space Widget Demo (by Cisco Webex).

Developer Tools

Handy tools to browse or interact with the APIs

• admin sandbox - apply for administrator rights to a Sandbox Organization (by Cisco Webex).
• guestissuer - CLI to generate Persistent Guest tokens (by ObjectIsAdvantag).
• interactive documentation - Toogle "Test mode" in the API documentation (by Webex for Developers).
• Postman
  • postman-webex - Scripted collections for Messaging API, Admin API and Cards (by ObjectIsAdvantag).
  • postman-webex-calling - Collection to demonstrate using the Calling APIs (by Cisco Webex).
  • postman-webex-meetings - Collection to demonstrate using the Meetings REST APIs (by Cisco Webex).
• Space widget demo - Teams Space widget demo (by Cisco Webex).
• sparkcli - A command line interface (by tdeckers).
• teams-space-archive - Archive messages to a single HTML file (by DJF3).
• webex-tokens - Generate scoped tokens for admins (by ObjectIsAdvantag).
• websocket-events - An unsupported hack to get events thru a native websocket (by marchfederico).
• whproxy - Proxy incoming webhooks to established websockets (by sgrimee).

Integration services

Cloud platforms and wiring engines to build applications with little to no coding

• Cloud Services - Create integrations or assemble from pre-built modules (priced services with trials)
  • API.AI - Create Teams bots with natural language understanding.
  • Built.io - Pre-defined Teams templates (signin required).
  • Gupshup - How to build and deploy a Teams bot.
  • IFTTT - Webex Teams recipies.
  • Recast - Collaborative platform to build, train, deploy and monitor bots.
  • Stamplay - Integrate and automate Webex Teams.
  • Workato - Get more out of Webex Teams by connecting it.
  • Zapier - Recommended zaps for Webex Teams.
• Wiring Engines
  • node-red - Node-RED Node.js binding to Webex Teams (by nmarus).

Reference

Resources maintained by Cisco Product teams and Developer Communities

• Developer Community Spaces
  • #webex4devs - Get help from developer support and community (by Webex for Developers).
  • Botkit devs - The Botkit developer community space.
  • Flint devs - The node-flint developer community space.
  • Node Bot Framework devs - The node-bot-framework developer community space.
  • Python devs - The Python developer community space.
• Learn
  • API documentation - The reference documentation (by Webex for Developers).
  • Blog - Samples and API updates (by Webex for Developers).
  • Learning track - Learn the REST API, build bots, embed Video Calls (by CiscoDevNet).
  • Rate limiting - Explains 429 & Retry-After HTTP header (by Webex for Developers).
  • Videos - A YouTube playlist to discover how to setup and manage Webex Teams (by Cisco).
  • What's new and coming - New and upcoming features (by Cisco).
• Security
  • Firewall traversal - Whitepaper about deployment requirements (by Cisco).
  • Network requirements - For firewall and web security administrators (by Cisco).
  • Privacy Data Sheet - Describes how "personal data" are processed (by Cisco).
  • Security FAQs - Tech Ops and Security FAQs (by Cisco).
  • Security whitepaper - Details the end-to-end secured service (by Cisco).
• Share
  • ambassadors - A worldwide network of professionals (by Cisco).
  • app hub - Catalog for bots & integrations (by Cisco).
  • community of interest - Share your passion for bots and integrations, learn from others (by CiscoDevNet).
  • creations - Inspire others by sharing your code (by CiscoDevNet).
  • partner program - Get Started as a Webex Partner (by Cisco).
• Support
  • devsupport - 24/7 developer support community (by Webex for Developers).
  • geos - Quickly check where Webex Teams is available (by Cisco Webex).
  • media test - Test your TCP/UDP network eligibility (by Cisco Webex).
  • release notes - Improvements and fixes for Webex Teams applications (by Cisco).
  • status page - Service availability page for the APIs (by Cisco Webex).