Skip to content

JDS Identity Management and Progressive Profiles. 📲 📧

Lab 2.1 Identity Management

Instructions
  1. In the previous lab, we sent an event to JDS using a fake email as the identity. However, we did not create this identity in JDS ahead of time. Let's check what is the current view of this "person" within JDS. Go to the "Person Details" request, enter the fake email you used on the identities section and send the request:

    Empty Identity IMG

    Empty Identity

  2. In the response, you can see that there's no name, phone or customer id. JDS automatically created this profile when you sent the previous event, let's use the merge API to add more details to this person profile. Select the Merge Identity API in Bruno and fill out the fields in the body section of the request. Send the request to push this data to the existing identity:

    Merge Identity IMG

    Merge Identity

  3. In the response, you will see how the aliases include the fake email and the phone number setup in the Collection variables. Now click on the JDS Purchase POST request and send the event to the JDS tape.

    Purchase Post IMG

    Purchase POST

  4. Click on the “Get History Stream by identity” call and replace the identity with the phone number variable. Send the request and you should see the JDS events matching both the email and phone number coming up in the history.

    Note

    There are other ways to create and edit Identities in JDS. You can create identities in bulk from Control Hub or create person profiles programmatically by using the Create Person API.

Lab 2.2 Adding JDS to the Navigation page of the Agent Desktop.

The JDS widget is now included in the Default Desktop Layout, but for this lab we would like to see the JDS widget without an active interaction. In order to do this, you have to add the JDS widget to the navigation pane section of the Desktop Layout.

Instructions
  1. In Control Hub, go to the Desktop Layouts menu. Click the option "Create Desktop Layout", a menu to configure your template will come up, enter the name POD-XX_Layout and select the Team associated to your POD number.
  2. Download the JDS_LAB_Layout and open it using Notepad++. Find the Navigation section and replace the existing data with the following widget information:

    {
      "nav": {
        "label": "Journey Data Services",
        "icon": "accessories",
        "iconType": "momentum",
        "navigateTo": "customerJourneyWidget",
        "align": "top"
      },
      "page": {
        "id": "customerJourneyWidget",
        "widgets": {
          "right": {
            "comp": "customer-journey-widget",
            "script": "https://journey-widget.webex.com",
            "attributes": {
              "show-alias-icon": "true",
              "condensed-view": "true",
              "enable-user-search": "true"
            },
            "properties": {
              "bearerToken": "$STORE.auth.accessToken",
              "organizationId": "$STORE.agent.orgId",
              "dataCenter": "$STORE.app.datacenter"
            },
            "wrapper": {
              "title": "Customer Journey Widget",
              "maximizeAreaName": "app-maximize-area"
            }
          }
        },
        "layout": {
          "areas": [
            [
              "right"
            ]
          ],
          "size": {
            "cols": [
              1
            ],
            "rows": [
              1
            ]
          }
        }
      }
    }
    
    Use the following picture to confirm you modified the JSON file correctly:

    JDS Navigation Section

    JDS Navigation Section

  3. Save the changes in the file and select the option "Replace file" back in the Desktop Layout menu. Select the modified file and then click the "Create" option.

  4. In an incognito window, navigate to the WxCC Agent Desktop and use your Agent credentials provided by a lab proctor to login.
  5. Set your "Station Credentials" to Desktop telephony option.
  6. You should now see the JDS widget in the navigation page, select it and do a search for your identity.
  7. The JDS widget should show the events you previously sent and the default profile template metrics in the JDS widget header.

Now let's create your own Profile Template to modify the metrics.

Lab 2.3 Profile Templates

Administrators can use profile templates to customize the data presented to the Agent in the JDS widget header, in this lab section you will create a profile that displays the amount of Page Visit events in the last 120 minutes.

Profile Template

Instructions
  1. Using Bruno, select the API called "Create Profile Template". You can add multiple metrics to a profile, modify the first entry in the API JSON to match the following:
    "name": "PageVisits_PODXX",
    "attributes": [
        {
            "version": "1.0",
            "event": "task:new",
            "metaDataType": "string",
            "metaData": "channelType",
            "limit": 100,
            "displayName": "Page Visits within 2 hours",
            "lookBackDurationType": "minutes",
            "lookBackPeriod": 120,
            "aggregationMode": "Count",
            "rules": {
                "logic": "SINGLE",
                "condition": "task:new,channelType,string,Value EQ Website"
            },
            "widgetAttributes": {
                "type": "table"
            },
            "verbose": false
        },
    
  2. Confirm that the other metrics for "Contacts within 10 days" and "Contacts within 24 hours" are included in the JSON body.
  3. Send the POST API call to create the profile.
  4. Select the GET Profiles API and run it to confirm you see both the default profile template and your new profile template. Copy the id of your profile template.
  5. Open the Desktop Layout you previously modified, you need to configure your template ID into it so that the JDS widget know what information to show.
  6. In the Desktop Layout, you need to modify the JDS widget that comes up when calls or digital tasks are active, and the JDS widget in the navigation pane. Add the line "template-id": "" to the attributes section, Here's an example:
    Navigation pane:
    "page": {
            "id": "customerJourneyWidget",
            "widgets": {
              "right": {
                "comp": "customer-journey-widget",
                "script": "https://journey-widget.webex.com",
                "attributes": {
                  "condensed-view": "true",
                  "show-alias-icon": "true",
                  "template-id": "68d627030750c0634702a46e"
                },
    
    Widget for Active Calls:
    {
            "comp": "md-tab-panel",
            "attributes": {
              "slot": "panel",
              "class": "widget-pane"
            },
            "children": [
              {
                "comp": "customer-journey-widget",
                "script": "https://journey-widget.webex.com",
                "attributes": {
                  "show-alias-icon": "true",
                  "condensed-view": "true",
                  "template-id": "68d627030750c0634702a46e"
                }
    
  7. Save and upload the new desktop layout file.
  8. Reload the agent desktop and confirm that the new profile template value is coming up.

Congratulations! You have completed this section of the lab.