Lab 4. Integrate WxCC API to third parties applications.

Objective

In the labs, you'll create Webex App in order to exicute Webex Contact Center API from a third-party application.

Task 1. Create Webex app in https://developer.webex-cx.com/ portal

Step 1. Login to https://developer.webex-cx.com/ using the customer administrator account for your tenant.

Step 2. Click on your avatar on top right and select "My Webex Apps" from the drop-down menu.

You will be taken to New App Integration page if you don't have any existing Apps

Step 3. Click on Create a New App.

Step 4. Provide the Name, Description for your App and add following two Redirect URLs as shown in the screnshot below for Postman Application: https://oauth.pstmn.io/v1/callback and https://oauth.pstmn.io/v1/browser-callback.

Step 5. Select the scope: cjp:config; cjp:config_write; cjp:config_read, accept the Terms of Service and click on Add Integration.

Step 6. Save Client ID and Client Secret somewhere in your notepad.

Task 2. Create OAuth 2.0 Authentication in the Postman app.

Step 1. Use a browser window to open Postman (https://www.postman.com.) Alternatively, you may launch Postman application on your local machine if it's installed.

Step 2. If you have an account, then log in. If you don't have an account, please sign up for free using your work or personal email.

Step 3. Once logged in, select the Workspace that you are working on. By default, there is one Workspace called "My Workspace" that you can use.

Step 4. Create new Blank Collection.

Step 5. Rename it as TS_Summit_2024.

Step 6. Under Authorization tab, click on Auth Type and select OAuth 2.0

Step 7. Scroll down to "Configure New Token" section and provide necessary information for OAuth 2.0 that was generated in Task 1 above:

Token Name: Test Auth URL: https://webexapis.com/v1/authorize Access Token URL: https://webexapis.com/v1/access_token Client ID: (The one generated and saved from Task 1) Client Secret: (The one generated and saved from Task 1) Scope: cjp:config cjp:config_read cjp:config_write

Step 8. Click on Get New Access Token.

Step 9. Enter the User Name and Password of the customer administrator user with Contact Center Administrator license.

Step 10. Once the Authentication is complete you will receive Token, Refresh token and other information related to the OAuth 2.0 Authoriztion. Click on Use the token.

Task 3. Make API calls using the OAuth 2.0 Authorization.

Step 1. Create a new API request.

Step 2. Go to Developer Portal and find the API request to list all Address Books.

Step 3. Copy cURL version of the call example.

Step 4. In the Postman App click on the Import option.

Step 5. Paste the cURL call example.

Step 6. Confirm the collection from the list and complete the import.

Step 7. Update the URL with your OrgID and remove the Search parameter.

Step 8. Click on Headers, add the token that you generated in the previous Task, and send the API call. You should see status code 200 and information about address bookes in the body.

Thank you for completing this lab