Tour the latest Cisco Spark API features

DEVNET-3609 Tour the latest Cisco Spark API features Stève Sfartz, stsfartz@cisco.com David Staudt, dstaudt@cisco.com API Evangelists / @CiscoDevNet

Cisco Spark Questions? Use Cisco Spark to communicate with the speaker after the session How 1. Browse to cs.co/ciscolivebot#devnet 2. Follow the instructions to be added 3. Install Spark or open the space: DEVNET: CLEUR DevNet Attendees 1. Enter messages/questions in the space cs.co/ciscolivebot#devnet 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public

Agenda Intro to Cisco Spark APIs Video SDK Updates Events API (Compliance) Open Source Starter Kits Spark-registered Devices programmability

Cisco Spark APIs and SDKs - Intro

Extend Depot and Integration Platform Services Cisco Spark Depot Instantly add functionality Cisco and 3 rd party developed Interactive bots and app integrations Integration Platforms No-code (or low-code) Integrate with 100s of services Easy Spark messaging and bot features DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 8

Integrate Human + System Collaboration REST API / Messaging Push Scripts/Apps Automate Spark operations with requests from virtually any language Chat Bots Use Spark Webhooks and REST API to build interactive messaging apps Custom Messaging Integrations Connect to Spark SSO/Oauth to perform operations on users behalf xapi / Room Devices / CE9.2.1+ In-Room Meetings UX new In-Room Controls, Node.js jsxapi, Macros (coming for Spark-registered) DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 9

Embed Cisco Spark SDKs w/video What if your users spend most of their time in some other business app? Patient Information Date: Name: Coud Inc. Weight: Appointments Meeting (Doctor) Full status (Doctor) Assistant Billing Reports Medical History 2 month checkup 1 month checkup Respiration problem 10 days checkup Notes DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 10

Easily embed Spark messaging, video and calling into your workflow Spark SDKs Build your own UI Spark Widgets Leverage Spark UI/UX DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 11

Cisco Spark SDK Video Updates

Spark SDK - Features Calling Call & Media Controls Other Functions Specs Calling Call Events Both 1:1 and Group Calling Call Control Audio Control Video Control Feedback Push notifications ios SDK - swift ios 10 and 11 JS SDK - WebRTC Chrome - current Firefox - current Android SDK Android 5.0 CODECS H264 Opus DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 13

Cisco Spark Client to Widget Think of the client as two separate pieces Recents Recent convos Space Persistent chat and calling capabilities, etc. DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 14

Space Widget Group & 1:1 audio & video calling Group & 1:1 persistent messaging View shared content Markdown support File sharing and management Flag or delete messages Read receipts Add or remove people @mentions DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 15

Recents Widget Recent Spark conversation list (spaces & people) Hooks to open a conversation with the Space Widget Unread space highlighting Event hooks for messages, calls, and memberships Incoming call notifications DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 17

Spark Feature SDK for ios SDK for Android SDK for Browsers Widgets Audio and/or video 1:1 calling Group space calling - NEW Dial by email, Spark user ID, or SIP address PSTN and DTMF Call and event controls Audio and video call control View shared content View content and video simultaneously - NEW Maximum bandwidth controls - NEW Create Teams, Spaces, and Memberships Send Messages User Interface included Advanced Messaging Receipts, Flags, Roster List, @mention - NEW DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 18

Salesforce / Spark Integration Demo

Persistent Guest Mode - What if My Users are Not on Spark? Anyone - Cisco Spark user - Guest Cisco Spark platform Everywhere - Cisco Spark user, spaces, devices - SIP addresses DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 20

Persistent Guests for Spark SDK Connects consumers and other non-cisco enterprise users with Cisco Spark paid users via simple browser & mobile voice and video through Spark platform Use cases: For patients to tele-doctor on healthcare mobile app. For consumers to support helpline on retail website. Terms of service: Guests offer is included in all Spark paid offers. No additional cost. Guest can reach only paid Spark users Guest to Guest is forbidden Guest issuers are created by developers who are part of a paid Org DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 21

Cisco Spark for Developers developer bot oauth guest token REST API SDKs Widgets, ios / Android SDK all Spark features DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 22

https://jwt.io/

Request an access token from the Guest token POST https://api.ciscospark.com/v1/jwt/login Authorization: Bearer <guest token> { } "token": "eyjhbgci.eynlx3r5cgu.i4zgvxatoh9y" "expiresin": 21599 DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 27

Guest token demo

Mobile SDKs - Simplify the User Experience Business App + separate video App Business App with Spark Video SDK embedded DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 29

Spark SDK for Android Project Setup Install the Spark SDK Maven repo to your project Gradle file: Enable Multi-Dex Add Spark SDK module Gradle file: Import Spark SDK: DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 31

Android SDK Demo

Cisco Spark Messaging API Updates

Ambassador Starter Kits A set of community driven starter kits for Cisco Spark Primarily based on Botkit, the most popular Open Source Bot framework. Open Source and Highly Customizable Reference Implementation Deploy securely in your preferred Cloud in minutes Open Source MIT License, meaning you can use, modify, deploy and sell the code without restriction. Provided as a Reference implementation containing the core functionality and services that apply to most deployments. Easy to extend and customize using the skills capability of Botkit, making it easy to add new functionality and function with customized versions of popular SaaS applications. Each project comes with a pre-composed Dockerfile and a Deploy to Heroku button, allowing deployments in your chosen Cloud within minutes. New features over time thanks to the Cisco Spark for Developers community. DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 37

Enterprise Bots: Deployment Checklist Ability to host Bots and Integrations in the customers choice of Cloud, allowing transparency of any associated data flows Ability to heavily customize Bots and Integrations to work with the customers heavily customized business applications Any data storage to be on a compliant and trusted storage platform to which only the customer has access DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 38

Top Cisco Spark API Horizontal Use Cases https://ciscosparkambassadors.github.io/starterkits Incident Management HR Onboarding Task Management Sales Pipeline Finance Operations Polling Scheduling Content Management Network Operations DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 39

Doorman Demo

Cisco Spark Compliance Enforce company policies Comply with legal requests Enforce company retention policies Integrate with Existing DLP, Archival and ediscovery ediscovery Search and Extraction Flexible Retention Policy Administration Events API DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 41

Compliance Officer Ensures that a company is conducting its business in full compliance with all laws and regulations search Cisco Spark for space IDs, keywords, shared files, and any email address used in your organization. Generate reports and download data in JSON format. The Cisco Spark API has compliance authorization scopes that support the compliance officer s role. access and manage all data created by their organization including messages, content attachments, etc. in order to monitor data and to mitigate compliance issues Note that: Full administrators can't assign the compliance officer role to themselves. Another full administrator must assign the role to them. Administrators can limit the amount of messages and files that are kept by configuring a data retention policy. When that threshold is met, aging content gets purged. DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 44

ediscovery Search and Extraction Extension of Cisco Spark Control Hub Designed for Compliance Officer Search on email ID, space ID, keywords 90-day in Cisco Spark base offer Any time period in Pro Pack for Cisco Spark Control Hub DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 45

JSON data reports https://collaborationhelp.cisco.com/article/en-us/nr70c1m Actor Object Target Verb An actor represents the person or entity that initiated the event or action. An object is the person or conversation or entity that is being operated on. For example, someone sends a message, the object will be of type comment. If someone adds Bob to a space, the object will of type person. If someone shares a file, the object will be of type file. A target is the place or destination the action is directed towards. Target is always conversation (for example, a conversation in a space). A verb is the type of action being performed. For messages, the action is usually post but could be other things such as delete (when someone deletes a message). DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 46

Events API https://developer.ciscospark.com/resource-events.html Enables polling for events and content that enables organizations to monitor and correct behavior, preventing the loss of sensitive data Cisco Spark Events API Third party DLP or CASB Cisco Cloudlock will be the first integration to provide DLP management via the Events API Corrective actions - delete content - remove member - alert admin/user Governance code DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 49

Admin Sandbox When you are not an administrator of your Cisco Spark Organization Send an email from the email address used on your existing Cisco Spark account to devsupport@ciscospark.com, Ask for the creation of a separate Cisco Spark account : For a separate email address: dev support will create a new Cisco Spark account for this email address and assign it to the Admin Sandbox organization. This email address cannot have been previously used for a Cisco Spark account. Using your home email address or a web email service is recommended. When your new admin account is created, you will receive an email inviting you to administer the Sandbox organization. Follow the instructions to complete the activation. You will be an admin in the Sandbox Organization, along with every other developer who has been granted access to the Sandbox organization. DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 51

To go further: import a Cisco Spark colllection https://github.com/ciscodevnet/postman-ciscospark#admin-api https://raw.github.../admin-scripted.json DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 52

Cloudlock Demo

Spark-registered Devices Updates Counting People Branding Spark-registered devices Calling Spark & SIP addresses

Accessing the WebUI of your Spark-registered Devices https://admin.ciscospark.com/devices http://192.168.1.34/cloud-login DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 55

Accessing the xapi of your Spark-registered Devices http://192.168.1.34/web/localusers Create a local Integrator user Connect via SSH with the Integrator user credentials REQUIREMENT: network connectivity to the Room System DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 56

In-Rooms Control Demo CLEUR agenda

Waking up your system (via WebUI and TSH) http://<ip-address>/web/personalization xcommand Standby Deactivate *s Standby State: Off Other Standby commands - xcommand Standby Activate - xcommand Standby Halfwake DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 58

Personalization: Custom text (awake) via Web UI & TSH http://<ip-address>/web/personalization xconfiguration UserInterface CustomMessage: Welcome to the DevNet Zone" DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 59

To go further: import the xapi collection https://github.com/ciscodevnet/postman-xapi https://raw.github.../xapi-integrator.json DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 61

Personalization: Custom text (awake) via Node.js jsxapi https://github.com/objectisadvantag/xapi-samples/tree/master/jsxapi DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 62

jsxapi Demo Counting participants at DevNet Workshops

Resources Room Devices on DevNet https://developer.cisco.com/site/roomdevices/ Postman collection for xapi https://github.com/ciscodevnet/postman-xapi Learning Lab: Introduction to xapi https://learninglabs.cisco.com/lab/collab-xapi-intro/step/1 Macros & Controls samples https://github.com/ciscodevnet/roomdevices-macros-samples https://github.com/objectisadvantag/xapi-samples https://github.com/objectisadvantag/xapi-samples/tree/master/jsxapi DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 64

What s next?

SDK & Widgets Roadmap Android SDK Windows SDK - C# Persistent Guests for SDK More web browsers support (desktop and mobile) More multiparty video layouts Widget - more Spark client mimics And your open source contributions! We want your feature requests! https://developer.ciscospark.com/sdkaccess/ DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 66

Spark Ambassadors Sign up today! Get Started with integration possibilities Direct access to our developer evangelists & product teams Brainstorm ideas & use cases that your customer needs Showcase your integrations to Cisco for exposure https://ambassador.ciscospark.com/ DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 67 31

Open source SDKs Easy to start and stop Rapid prototype before procurement Secured 3rd party can check Anyone can contribute under MIT license Royalty free Cisco pays for open H264 We open source the SDK and the sample app DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 68

Spark SDKs and Widgets Ordering All Spark subscribers can use Spark SDKs and widgets! No add-on! Enjoy business messaging with M1 and + Single Sign-On, Exchange directory integration, Admin portal, Spaces moderation, M1 available online DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 69

Developer Resources

Cisco Spark SDK & Widget Developer Resources Cisco Spark API / SDK Docs: https://developer.ciscospark.com Cisco DevNet Spark Resources: https://developer.cisco.com/site/spark/ https://learninglabs.cisco.com/labs/tags/spark/page/1 GitHub Resources: https://github.com/ciscodevnet/awesome-ciscospark Cisco Spark Developer Support: https://developer.ciscospark.com/support.html DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 71

Please complete your Online Session Evaluations after each session Complete 4 Session Evaluations & the Overall Conference Evaluation (available from Thursday) to receive your Cisco Live T-shirt All surveys can be completed via the Cisco Live Mobile App or the Communication Stations Complete Your Online Session Evaluation Don t forget: Cisco Live sessions will be available for viewing on-demand after the event at www.ciscolive.com/global/on-demand-library/. 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public

Continue Your Education in the DevNetZone Over 148 Devnet / Spark Sessions! Click here: CLEUR Session Catalog + DevNet + Spark DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 74

Continue Your Education Demos in the Cisco campus Walk-in Self-Paced Labs Tech Circle Meet the Engineer 1:1 meetings Related sessions DEVNET-3609 2018 Cisco and/or its affiliates. All rights reserved. Cisco Public 75

Thank you