Tour the latest Cisco Spark API features

Transcription

1

2 DEVNET-3609 Tour the latest Cisco Spark API features Stève Sfartz, David Staudt, API Evangelists

3 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

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

5 Cisco Spark APIs and SDKs - Intro

6 Cisco Spark supports awesome collaboration today DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 6

7 Delightful Meeting Room Experiences DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 7

8 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 8

9 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 / CE In-Room Meetings UX new In-Room Controls, Node.js jsxapi, Macros (coming for Spark-registered) DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 9

10 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 10

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

12 Cisco Spark SDK Video Updates

13 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 13

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

15 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 DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 15

16 Cisco Spark Client to Widget Recents Space DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 16

17 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 17

18 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 , 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 - NEW DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 18

19 Salesforce / Spark Integration Demo

20 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 20

21 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 21

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

23 Guest Mode Deep Dive DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 24

24

25 Create a Guest token from code DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 26

26 Request an access token from the Guest token POST Authorization: Bearer <guest token> { } "token": "eyjhbgci.eynlx3r5cgu.i4zgvxatoh9y" "expiresin": DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 27

27 Guest token demo

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

29 Spark SDK for ios and Now Android Familiar Development Tools DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 30

30 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 31

31 Spark SDK for Android Oauth DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 32

32 Spark SDK for Android Oauth Java Code DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 33

33 Spark SDK for Android Make Call DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 34

34 Android SDK Demo

35 Cisco Spark Messaging API Updates

36 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 37

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 Cisco and/or its affiliates. All rights reserved. Cisco Public 38

38 Top Cisco Spark API Horizontal Use Cases Incident Management HR Onboarding Task Management Sales Pipeline Finance Operations Polling Scheduling Content Management Network Operations DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 39

39 Doorman Demo

40 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 41

41 Cisco Spark Control Hub DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 42

42 Cisco Spark Administrator Roles DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 43

43 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 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 44

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

45 JSON data reports 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 46

46 jq example to parse JSON data DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 47

47 DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 48

48 Events API 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 49

49 Compliance scopes DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 50

50 Admin Sandbox When you are not an administrator of your Cisco Spark Organization Send an from the address used on your existing Cisco Spark account to Ask for the creation of a separate Cisco Spark account : For a separate address: dev support will create a new Cisco Spark account for this address and assign it to the Admin Sandbox organization. This address cannot have been previously used for a Cisco Spark account. Using your home address or a web service is recommended. When your new admin account is created, you will receive an 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 51

51 To go further: import a Cisco Spark colllection DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 52

52 Cloudlock Demo

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

54 Accessing the WebUI of your Spark-registered Devices DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 55

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

56 In-Rooms Control Demo CLEUR agenda

57 Waking up your system (via WebUI and TSH) xcommand Standby Deactivate *s Standby State: Off Other Standby commands - xcommand Standby Activate - xcommand Standby Halfwake DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 58

58 Personalization: Custom text (awake) via Web UI & TSH xconfiguration UserInterface CustomMessage: Welcome to the DevNet Zone" DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 59

59 Personalization: Custom text (awake) via Postman DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 60

60 To go further: import the xapi collection DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 61

61 Personalization: Custom text (awake) via Node.js jsxapi DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 62

62 jsxapi Demo Counting participants at DevNet Workshops

63 Resources Room Devices on DevNet Postman collection for xapi Learning Lab: Introduction to xapi Macros & Controls samples DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 64

64 What s next?

65 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! DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 66

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 DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 67 31

67 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 Cisco and/or its affiliates. All rights reserved. Cisco Public 68

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 Cisco and/or its affiliates. All rights reserved. Cisco Public 69

69 Developer Resources

70 Cisco Spark SDK & Widget Developer Resources Cisco Spark API / SDK Docs: Cisco DevNet Spark Resources: GitHub Resources: Cisco Spark Developer Support: DEVNET Cisco and/or its affiliates. All rights reserved. Cisco Public 71

71 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

72 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 Cisco and/or its affiliates. All rights reserved. Cisco Public

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

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 Cisco and/or its affiliates. All rights reserved. Cisco Public 75

75 Thank you

76