Skip to content

WebexSamples/webex-contact-center-api-samples

Repository files navigation

Webex Contact Center API Samples

License Contributors Stars

Looking for something?

Please take a look at the Index of all the Samples Below πŸ‘‡πŸ‘‡

These basic samples will help you understand the Webex Contact Center APIs available today on the Webex Contact Center Developer Portal

Getting Started

To get started, create an App Integration on the Developer Portal: ( This will help you obtain your Client ID and Client Secret ).

  • Sign into developer.webex-cx.com with a valid Webex Control Hub Account.
  • Create an Application Integration by going to your Profile > Manage My Apps.
  • Creating an Application Integration will give you a set of Client ID and Client Secret that you will need for this sample.
  • Note: While entering the Redirect URI, ensure it has the right URL. For example, for postman, it is : https://oauth.pstmn.io/v1/callback
  • For your local app, it will be in the format: http://localhost:{port}/{path}

Using the API Samples

Samples - Index

The API samples are divided into several folders. It would be great to follow the samples in the following order. Each sample has a supporting ReadMe and/or a supporting video on how to get started.

# Folder Name Domain Variant Comments Link
0 postman-sample API Fundamentals Postman Getting Started with the Webex Contact Center APIs and how to create a pair of Client ID or Client Secret for OAuth2 etc. Postman Sample
1 app-auth-sample API Fundamentals JavaScript This is a sample application that shows you how to obtain an access token. It also has sample GET calls for Tasks, Agent Stats, Queue Stats, Users, Sites, etc. OAuth2 Sample
2 configuration-app-sample Configuration API JavaScript This is a sample frontend application that shows you how to use the Configuration APIs for EPs, Queues, Teams, and expose the capabilities on the front-end Configuration App Sample
3 configuration-extraction-sample Configuration API Java This is a sample application written in Java that has example Configuration REST API calls to extract and export WebexCC configuration data to a CSV. This app is extensible and customizable based on what data needs to be extracted. Configuration Extractor in Java
4 graphql-sample Data & Reporting API GraphQL This is a sample application that has example calls for the new /search endpoint that is powered by GraphQL. One can formulate multiple request types that support the GraphQL syntax. Both Tasks and Agent Sessions are supported. GraphQL /search API Sample
5 graphql-wallboard-sample Data & Reporting API GraphQL + JavaScript This is a sample wallboard application that has examples for Realtime and Historical API calls using the new /search endpoint that is powered by GraphQL. This example contains a few sample cards that can be extended based on requirements. GraphQL Wallboard Sample
6 graphql-powerbi-sample Reporting API (GraphQL + Search) Java This is a sample application written in Java that shows you how to build a Microsoft Power BI connector for Webex Contact Center Reporting. The app uses Webex Contact Center's "/search" API powered by GraphQL. GraphQL Power BI Reporting Connector Sample
7 webhook-email-notify-sample Webhooks JavaScript This is a sample application that shows you how to use Webhooks and send an email notification using webhooks. Webhook Sample with Email Notifications
8 call-recording-download-sample Recording Download API JavaScript This is a sample application that shows you how to use Webhooks - the capture:created Webhook allows you to download a new call recording on the system, to a local file. Call Recording Download Sample
9 token-app-sample API Fundamentals JavaScript This is a sample application that shows you how to build a scheduler service that obtains a new access token every 10 hours from Webex and persist this onto your local datastore. The example uses a simple SQLite DB as an example. Token Management Service Sample
10 callback-sample Webcallback API JavaScript This is a sample application that shows you how to build a front end Form to Leverage our brand new Webcallback API that injects a callback call into Webex Contact Center. The example uses a simple javaScript injection technique to inject the form in any webpage of your choice. Web Callback API Sample
11 widget-sample-101 Desktop Widgets Desktop Layout This is a sample web component widget that shows you how to build a web component widget from scratch. It also covers how you can read the Desktop STORE to retrieve information and pass these values into the widget via the layout. Web component Widget Sample & 101
12 iframe-widget Desktop Widgets Desktop Layout Basic iFrame widget to understand how to bring a widget in the desktop - iFrame a Reporting widget from Analyzer into the Desktop iFrame Widgets
13 header-widget Desktop Widgets Desktop Layout This is a sample project to demonstrate a custom RSS header widget built using LitElement for use as a Webex Contact Center Header Desktop Widget. RSS Header Widget Sample
14 desktop-js-sdk-sample Desktop Widgets Desktop Layout + JavaScript SDK This is a sample web component widget that shows you how to use the Desktop Javascript SDK inside a widget to automate actions. The widgets can have a UI, or can be entirely headless. Desktop JS SDK Web Component Widget
15 addressbook-widget-sample Desktop Widgets Desktop Layout + JavaScript SDK This is a sample web component widget that shows you how to build a customized Address Book with Click to dial, Transfer, Consult and other functionalities using a web component widget. Address Book Widget
16 desktop-js-sdk-callcontrol-sample Desktop Widgets Desktop Layout + JavaScript SDK This is a sample web component widget that shows you how to use the Call Control Methods available on the JS SDK to enable the following functionalities: Transfer, Click to dial, Consult, Pause, Resume, Hold, Unhold and more, using a web component widget. Desktop Call Control Widget
17 desktop-api-sample Desktop REST API & Websockets Postman collection + JavaScript App This postman collection and sample application helps you understand the Desktop REST APIs available today on Webex Contact Center Desktop REST API Sample
18 audio-widget-sample Desktop Widgets Desktop Layout + JavaScript SDK This is a sample web component widget that shows you how to bring in Audio recording into a Widget on the Webex Contact Center Desktop Audio Widget sample

Disclaimer

These samples are meant to be used, as "samples", for demos, and to understand how to interact with the WebexCC APIs. When building a production grade solution, please consider the overall architecture and design with a security first approach. Also, please consider how you would extend this app for multiple orgs, manage tokens for the orgs, etc. These samples are only meant to provide working, starter code and many layers have been simplified and abstracted away to focus on the Webex Contact Center use cases.

Support

For dedicated Developer Support on the APIs - Please open a ticket with the team using this link: Webex Contact Center Developer Support

For discussions on the samples, feel free to participate in our Developer Community:

Webex Contact Center APIs Developer Community

Refer: How to Ask a Question or Initiate a Discussion