#CiscoLive

Automating Migration to
Webex Calling

Scott Anderson (Product Manager for Webex Calling)

DEVNET-2100

#CiscoLive
Cisco Webex App

Questions?
Use Cisco Webex App to chat
with the speaker after the session

How
1 Find this session in the Cisco Live Mobile App
2 Click “Join the Discussion”
3 Install the Webex App or go directly to the Webex space Enter your personal notes here

4 Enter messages/questions in the Webex space

Webex spaces will be moderated https://ciscolive.ciscoevents.com/ciscolivebot/#DEVNET-2100

by the speaker until June 17, 2022.

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 3
 • Paths for Provisioning Webex Calling
• APIs for Webex Calling
• Documentation & API Demo
Agenda • CSVs for Webex Calling
• CSV Demo
• Questions?

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 4
 Introduction
Covering:
Provisioning Options for Webex Calling
Demos: Documentation, API, and CSV
Q&A

Not covering:
Gathering business requirements
Exporting data ….

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 5
Introduction
Methods of Provisioning Webex Calling

Control Hub CSV API

Ease of Use

Speed

Customization

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 6
Webex Calling
APIs
Poll:
Used provisioning APIs?
Webex Calling Provisioning APIs

6 Months Ago…
Users (Part I)
Devices*
Workspaces*
Locations*

* Read-Only APIs

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 9
Webex Calling Provisioning APIs

Today
Users (20+) Call Pickup (6) Auto Attendant (10)
(call forwarding, voicemail, dnd, ..) (create, update, list, delete, get agents, …) (create, update, list, delete, get agents, …)
Locations** (5) Call Park ( 9) Workspaces** (19)
(update, list, …) (create, update, list, delete, get agents, …) (update, list, …)
Call Queues (14) Location Schedules (8) Devices* ( 5)
(create, update, forwarding, rules, …) (create, update, list, delete, create event, …)
Hunt Groups (12) Paging Group ( 5) Numbers* ( 1)
(create, update, forwarding, rules, …) (create, update, list, delete, …)
Schedules (8) Call Park Extension (1)
(create, update, list, delete, create event, …)(create, update, list, delete, get agents, …)

120+ NEW APIs

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 10
APIs Coming Soon??

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 11
Api shout outs….

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 12
Calls API
v1/telephony/calls API /calls retrieval
• Click to Dial • Get Call Logs -missed, placed and
• Answer a call received calls (user scope)
• Divert a call (voicemail) • Get Active Call Details with a call id
• Reject or Hangup
• Hold and Resume
• Transfer (connected call)
• Park connected call and Retrieve.
• Group Park
• Recording (Start, Stop, Pause,
Resume) on a call

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 13
Call Control Event APIs
/v1/webhooks

Real time event via Webhooks

User Level Events

originating originated received

answered held resumed

disconnected recordingStarting recordingStarted

recordingPaused recordingResume recordingStoppe

d d

transferred bargedIn Retrieved

pickedUp forwarded updated

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 14
Calling Analytics APIs
v1/reports v1/report/templates
• Run report • List Report templates
• Get Data from report • (Calling Detailed Call History, Quality reports)
• List (previously ran reports)
• Delete report

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 15
Demo: Documentation
Demo: API
Postman Collections

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 18
Webex Calling Provisioning SDK - Python
• PyPi: https://pypi.org/project/wxc-sdk/

• Documentation: https://wxc-sdk.readthedocs.io/en/latest/

• Simple SDK to work with Webex APIs

• Focus on Webex Calling specific endpoints

• Takes care of all the “ugly” stuff

• JSON (de-)serialization, authentication, 429 retries,
• Pagination, …

• Python objects for all API objects

• Tab completion → efficient coding

• Actively maintained
• New API endpoints will be added

• Foundation for your migration/provisioning automation and other projects around Webex Calling

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 19
Webex Calling API References
• Webex API documentation • Zeep documentation
https://developer.webex.com/ https://docs.python-zeep.org/en/master/

• Postman Collection - Provisioning • Zeep examples

https://github.com/webex/postman-webex- https://github.com/CiscoDevNet/axl-python-
calling zeep-samples

• Postman Collection – Call Control • csv module

https://github.com/webex/postman-webex- https://docs.python.org/3/library/csv.html
calling
• Pandas
• Webex Calling provisioning SDK https://pandas.pydata.org/
https://github.com/jeokrohn/wxc_sdk
• Set up your Webex Calling features
• TME Video Library (Webex Calling playlist) https://help.webex.com/en-us/article/0r7a2z/Set-
https://www.youtube.com/c/CiscoCollaborationTe up-your-Webex-Calling-features
chnicalMarketing

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 20
Webex Calling
CSV
Poll: CSV Usage?
Webex Calling Provisioning CSVs

6 Months Ago…
Users (Basic)
Devices*
Workspaces*

* Read-Only

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 23
Webex Calling Provisioning CSVs

Today
Users (Basic)
Devices*
Workspaces*
Call Queues
Hunt Groups
Auto Attendant

* Read-Only

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 24
Demo: CSV
CSVs Coming Soon??

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 26
Questions?
Technical Session Surveys
• Attendees who fill out a minimum of four session
surveys and the overall event survey will get Cisco Live
branded socks!

• Attendees will also earn 100 points

in the Cisco Live Game for every
survey completed.

• These points help you get on the leaderboard and

increase your chances of winning daily and grand
prizes.

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 28
 Pay for Learning with
Cisco Learning Credits
Cisco Learning and Certifications (CLCs) are prepaid training
vouchers redeemed directly
From technology training and team development to Cisco certifications and learning with Cisco.
plans, let us help you empower your business and career. www.cisco.com/go/certs

Learn Train Certify

Cisco U. Cisco Training Bootcamps Cisco Certifications and
IT learning hub that guides teams Intensive team & individual automation Specialist Certifications
and learners toward their goals and technology training programs Award-winning certification
program empowers students
Cisco Digital Learning Cisco Learning Partner Program and IT Professionals to advance
Subscription-based product, technology, Authorized training partners supporting their technical careers
and certification training Cisco technology and career certifications
Cisco Guided Study Groups
Cisco Modeling Labs Cisco Instructor-led and 180-day certification prep program
Network simulation platform for design, Virtual Instructor-led training with learning and support
testing, and troubleshooting Accelerated curriculum of product,
technology, and certification courses Cisco Continuing
Cisco Learning Network Education Program
Resource community portal for Recertification training options
certifications and learning for Cisco certified individuals

Here at the event? Visit us at The Learning and Certifications lounge at the World of Solutions

#CiscoLive DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 29
 • Visit the Cisco Showcase
for related demos

• Book your one-on-one

Meet the Engineer meeting
Continue Attend the interactive education
your education
•
with DevNet, Capture the Flag,
and Walk-in Labs

• Visit the On-Demand Library

for more sessions at
www.CiscoLive.com/on-demand

DEVNET-2100 © 2022 Cisco and/or its affiliates. All rights reserved. Cisco Public 30
Thank you

#CiscoLive
#CiscoLive