The industry is all about Chat bots, Speech synthesis and recognition, Natural Language Processing... In this session, we'll detail how to build advanced interactions in Javascript with Cisco Spark and Tropo. We'll take the example of the Interactive Voice Responder that was setup for the CodeMotion Milan Conference this year. Last part of the session will be interactive so that we can share our various experiences with frameworks and industry gaps.

1. Build advanced
Voice Assistants and ChatBots
Stève SFARTZ
API Evangelist -Cisco DevNet
stsfartz@cisco.com, @SteveSfartz, github://ObjectIsadvantag

2. 2
• Experience the CodeMotion Milan 2016 Voice Machine
• Step by step guide
• Pick a Tropo phone number and connect it to a Javascript IVR
• Setup a SMS Bridge to onboard participants into a Spark room
• Check Tropo real-time activity via a ChatOps room
• Connect an interactive assistant to a Spark room as a Webhook (Bots)
• Considerations
Agenda

3. +39 051 042 1150
!create an account on
http://tropo.com to go
hands-on live!

4. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
CodeMotion Milan 2016 IVR
Interactive Voice Responder
• Call +39 051 042 1150 and listen…
• Dial 1 to receive more details by SMS, 2 for next, 3 for previous
• Check you session details on your mobile phone
• Text your email to the caller (+1 414 999 0205) /! you’re texting US !!!
• Launch CiscoSpark, and meet the bot…

5. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
dials #1
{CodeMotion} Milan 2016 - Tropo IVR -
+39 051 042 1150
« Welcome »
details via SMS
ack
texts email address
/now
current events
calls
texts
« sparks »
IVR
JS script
Events
BotCisco Spark
POST
membership
reachs Support room
SMSBridge
JS library
/email
texted
Log2Spark
JS library
/new
logs
POST
message
« ChatOps »
Room
« Support »
Room

6. Voice Machine Responder
with Tropo

7. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
What is Tropo ?
Cloud APIs enabling developers to quickly
and easily embed communication capabilities
into their applications and business processes.

8. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
+
• Ask
• Call
• Conference
• Hangup
• Record
• Reject
• Say
• Transfer
Tropo in a nutshell

9. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
say("hello world");

10. Play an Audio File
say(“http://www.phono.com/audio/tropor
ocks.mp3");

11. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
call("+14155550100");
say("Tag, you’re it!");
Outbound Voice Call

12. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Asking
a
Send a Text Message
call("+14155550100",
{network:"SMS"}
);
say("Tag, you’re it!");

13. Asking a Question
var result = ask("What's your favorite color?
Choose from red, blue or green.", {
choices:"red, blue, green"
});
say("You said " + result.value);
log("They said " + result.value);

14. Voicemail Application
record("Leave your message at the beep. Press pound
when finished.", {
beep:true,
timeout:10,
silenceTimeout:7,
maxTime:60,
terminator:'#',
recordFormat:"audio/mp3",
recordURI:"ftp://example.com/1.mp3",
recordUser:"tropocloud",
recordPassword:"password"
}
);

15. Record an Entire Call
startCallRecording("http://example.com/recording.js");
ask("What's your favorite color? Choose from red, blue or green.", {
choices:"red, blue, green"
});
stopCallRecording();

16. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Local Numbers
• Toll Free
• 42+ countries
• SIP Addresses
Numbers
• Inbound
• Outbound
• Trunking
included
Voice
• Inbound
• Outbound
• Two-way
Texting

17. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Transfer
• Conference
• Headers
Call Control
• Speech
Recognition
• Text to Speech
• Audio playback
• Recording
Rich Media
• Redundant
data centers
• Auto-scaling
• Usage-based
Cloud

18. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Account Types
• Free for testing
• Low-volume
• Restricted use
• No production
usage
Developer
• Pre-paid
• Credit Card
• Self-service
signup
• Shared Cloud
• one minute billing
increments
Production
• Post-paid
invoices
• Contract
• SLA
• Account
Manager
• Shorter billing
increments
• Training
Enterprise

19. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
24x7 support
All features
Monitored, Managed Cloud
Developer Production Enterprise

20. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Globally available
Global Outgoing Calls & Messages
Numbers in 42 countries
80 speech languages

21. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
How to setup a custom IVR
• The IVR is composed of :
• a local phone number
• a custom script executed by the Tropo Scripting platform
dials #1
+39 051 042 1150
« Welcome »
details via SMS
calls
IVR
script

22. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Hands-on: let’s setup the DevNet Quiz IVR
• Create a new Tropo application
on http://tropo.com
• Point to the IVR script:
http://bit.ly/MILAN2016-1
• Save the application
22

23. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Hands-on: setup the DevNet Quiz IVR
• Add a phone number
• note : pick a SMS-enabled phone number as we’ll leverage SMS later
• Call your IVR
23

24. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
IVR highlights
• Fork a new Tropo session to send a SMS
24

25. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
To go further…
• Personalize your IVR
• Modify the invites, play audio files
• Pick international voices
• Use SSML to enhance your User Experience
• Understand how the Tropo Scripting platform manages your files
• For development, host your scripts on an external URL for changes to reflect
instanlty
• As Tropo will fetch your script everytime it is invoked
• Host on Github gist, edit your favorite IDE
• https://www.tropo.com/2016/06/gists-can-help-tropo-scripting-development/
• When going live, host your scripts on Tropo Production File Servers
25

26. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Join the Cisco DevNet code labs
https://github.com/CiscoDevNet/codemotion-milan-2016

27. Cisco Spark ChatOps

28. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
What are ChatOps ?
• Step by step article to set this up
• https://www.tropo.com/2016/06/devops-follow-tropo-spark/
28
“Follow your
Tropo application
real-time activity
in Cisco Spark”

29. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
How to setup Cisco Spark ChatOps
To stream logs into CiscoSpark
and get instant view about Tropo
activity:
1. Create a ChatOps room
2. Add an Incoming Webhook
3. Post messages from Tropo
Quiz
script
Spark
Log2Spark
library
/new
logs
POST
message
« ChatOps »
Room
1
2
3

30. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Cisco Spark
Secure & Open
Complete & Simple
Spark for Developers
User Integrations, APIs/SDKs, etc.
Spark Hybrid Services
Cloud + Prem
Partner Services
Interconnect
Message Meeting Call
1:1 and team messaging in virtual rooms A Cloud-based phone systemAudio, video, and web meetings

31. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
What is so great about REST?
same concept, many Cisco APIs
Easy to Build
Web apps
Mobile apps
M2M, Bots…
REST API
31

32. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
‘Your App’
now with
Cisco Collab!
Spark APIs
Extend Cisco Collaboration Cloud
GET
POST
DELETE
PUT
/Rooms
/Memberships
/Messages
/Webhooks
/People
32
/Teams
https://developer.ciscospark.com/

33. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Cisco Spark API v1 (July 2016)
/People /Rooms /Membership /Messages /Teams /Webhooks
List People List Rooms List Memberships List Messages List Teams List Webhooks
Create a Room Create a Membership Create a Message Create a Team Create a Webhook
Get Person Details Get Room details Get Membership details Get Message details Get Team details Get Webhook details
Update a Room Update a Membership Update a Team Update a Webhook
Delete a Room Delete a Membership Delete a Message Delete a Team Delete a Webhook
GET
POST
DELETE
PUT
DELETE DELETE DELETE
PUT PUT
POST POST POST
GET GET GET
GET GET
GET
GET GETGET
33
DELETE
PUT
POST
GET
GET

34. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
• Create a new Cisco Spark room from the CiscoSpark Developer Portal
34
https://developer.ciscospark.com/endpoint-rooms-post.html

35. DevNet Events Bot
Check upcoming events

36. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
How to connect the ‘DevNet Quiz’ Bot
/now
event details« sparks »
DevNet
Events BotCisco Spark
reaches the Support room « Support »
Room

37. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Join the Cisco DevNet code labs
https://github.com/CiscoDevNet/codemotion-milan-2016

38. Further considerations

39. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
• from the CodeMotion Conference page
• to a json payload provided by Andrea Ferlito
• created a REST API out of a Sails.js template
• https://github.com/ObjectIsAdvantag/CodeMotionMilan2016
 Free your data, you cannot anticipate how much value is laying there, not
exploited.
 You may not have ideas, but be faithful: the community will have a lot !!!
A bit of history
39

40. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 40
Typical bot journey
• Built a few bot samples in NodeJS, starting with Express simple code
• https://github.com/CiscoDevNet/node-sparkbot/blob/master/tests/express-spark-
webhook.js
• THEN start a library to abstract:
• Express boilerplate,
• Notifications listener,
• Bot Commands interpreter,
• Bot Mentions detection & triming
 sounds familiar ?

41. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 41
Bot Frameworks survey

42. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 42
Typical bot journey
• Built a few bot samples, from Express simple code
• https://github.com/CiscoDevNet/node-sparkbot/blob/master/tests/express-
spark-webhook.js
• Created a bot framework to simplify repetitive tasks
• Express boilerplate, notifications listener, command interpreter, bot mentions
detection
• https://github.com/CiscoDevNet/node-sparkbot-
samples/blob/master/templates/onCommand.js
>> Time for choices Getting more opiniated
• Automation but not loose of control (no magic behind the scene)
• Metadata

43. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 43
Typical bot journey
• always gets more opiniated….
• NLP, Conversations, Contexts
• 3rd party services or DIY
• Howdy does a pretty good job about conversations & context storage
• others concerns
• OAUTH scopes, too large ?
• What is this Bot code of conduct ?
• All Web API classics apply: scalability, robustness, analytics, security

44. Let’s wrap it up

45. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
dials #1
DevNet Quiz Overview
+1 414-882-4782
« Welcome »
« DEVNET3002 details »
ack
subscribes via email
/challenge
plays the challenge
calls
texts
« sparks »
Quiz
script
Quiz Bot
Cisco Spark
POST
membership
joins Quiz room
CiscoSpark
Bridge
/email
texted
CiscoSpark
ChatOps
/new
logs
POST
message
« ChatOps »
Room
« Quiz »
Room

46. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 46
Key API Features and Use-Cases
• /rooms/people  automate room
creation and population
• /messages  app-driven
notifications and reports
• /teams  self-service rooms
• /webhooks  interactive assistants
(chat bots)
• TTS/Speech Recognition  voice
driven interactive customer service
• SMS  automated outbound
notifications, inbound SMS apps
• Recording/Transcription  voice
messaging and voice notes/records
• Telephony/Conferencing 
notifications and team voice comms

47. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public 47
« Sparkers » community at Cisco DevNet
https://developer.cisco.com/site/spark/
https://learninglabs.cisco.com/tracks/collab-cloud
https://github.com/CiscoDevNet/awesome-ciscospark

48. Developer Portal
• Dev Centers
• Support Centers
400,000 Members
Learning labs
Springboards & Sandbox
Hackathons, CodeCamps
DevNet Express
Standards & Open Source
DevNet Zone at Cisco Lives
DevNet Kids, IEEE
Women in
Engineering
API Documentation
Projet Showcases
Forums, Community blogs

49. © 2016 Cisco and/or its affiliates. All rights reserved. Cisco Public
Cisco's presence at CodeMotion 2016
Nov 25th
• 10:00: it's all about Developers, discover Cisco DevNet
• 11:30: from IoT to Human interactions (Drone Demo)
• 14:10: build advanced Voice Assistants and Chat Bots
• codelabs: build Chat Bots, create your own IVR (Voice Machine)
http://bit.ly/labs2511
Nov 26th
• 11:30: Embed Video and Messaging without being an expert
call +39-051-042-1150
to hear upcoming sessions

50. Thank you
@CiscoSparkDev
@CiscoDevNet
@SteveSfartz