Extend the Contact Verification card

The Contact Verification card is displayed to agents only for known customers.

The UI includes a Verify button for agents to confirm whether the customer information is correct. With Contact Verification extensibility, we can extend the Contact Verification UI in our application to add or remove standard or custom fields to the layout. You can also mark a standard or custom field required. You can display fields conditionally and make them required conditionally. You can configure a conditional Contact Verification UI layout based on attributes such as Application Classification, Channel, and Communication Direction.

Note: You can't remove the Notes field from the Wrap Up layout.

Navigate to the Wrap Up layout

  1. In Visual Builder, create a new project or open an existing project.
  2. Click the Dependencies tab, and add the required dependencies.
  3. Click the Layouts tab.
  4. From the Dependencies list, click WrapUps.
  5. In the Dynamic Form list, select the wrapup dynamic layout.
  6. In the Rule Sets properties area, click the Parameters tab.
  7. The Wrapup component has the following three contexts:
    • appClassification
    • callDirection
    • channelType
  8. Hover over each context to highlight it, then hover over the ? symbol to view possible values for each component context.
  9. Possible values are:
    • appClassification: Possible Values: ORA_SALES, ORA_SERVICE, ORA_HRHD
    • callDirection: Possible Values: ORA_SVC_INBOUND, ORA_SVC_OUTBOUND
    • channelType: Possible Values: ORA_SVC_PHONE, ORA_SVC_CHAT

Navigate to the Wrap Up layout

  1. In the Display Logic workspace, click the Duplicate Rule icon to clone the default rule.
  2. Click the Layouts tab.
  3. From the Dependencies list, click WrapUps.
  4. In the Dynamic Form list, select the wrapup dynamic layout.
  5. In the Rule Sets properties area, click the Parameters tab.
  6. The Wrap up component has the following three contexts:
    • appClassification
    • callDirection
    • channelType
  7. Hover over each context to highlight it, then hover over the ? symbol to view possible values for each component context.
  8. Possible values are:
    • appClassification: Possible Values: ORA_SALES, ORA_SERVICE, ORA_HRHD
    • callDirection: Possible Values: ORA_SVC_INBOUND, ORA_SVC_OUTBOUND
    • channelType: Possible Values: ORA_SVC_PHONE, ORA_SVC_CHAT

Add standard fields to the Contact Verification card

  1. Click your newly created layout.
  2. From the All Fields list, view the ready-go-use fields.
  3. You can add new fields to the list by selecting the checkbox from the list.

Add custom fields to the Contact Verification card

  1. Create a custom field from Application Composer for the Contacts object and publish it.
  2. In Visual Builder, open the Contact Verification header.
  3. From the All Fields list, find your custom field and select it to add it to the Select field to display list.

Add data from the chat launch form or IVR to the Contact Verification card

The data entered in chat launch form or collected in IVR will be available in engagement indata/outdata of the processevent API which can be accessed in this form using:componentContext.inData or componentContext.outData. For example: to see interaction ID in the call or chat header, use: [[ $componentContext.outData.SVCMCA_INTERACTION_ID ]] as the Value.

  1. In the Contacts layouts, click the Fields tab.
  2. Click the + Custom field.
  3. Enter an ID and label, and then click Create.
  4. Select the newly created field from the Fields list.
  5. In the Properties area, click the Value field.

    Say you want to have the contact's job title to be seen. For example: [[ $componentContext.inData.SVCMCA_CONTACT_JOB_TITLE ]].

  6. Select the variable that you want to see as this field or use function to write custom code
  7. Now click the Rule Sets tab and add this field to your layout.
  8. Preview or publish to see the newly created field and tagged values.

Delete a field from the Contact Verification card

  1. In the Layout workspace, note the list of fields.
  2. To delete a field, hover over the field, and click the Delete button.

Conditionally display a field in the Contact Verification card

  1. In the Layout workspace, note the list of fields.
  2. Select the checkbox of the desired field from the All Fields list
  3. Click the added field, and expand the properties panel
  4. In the properties panel, select Show Field and select Always.
  5. Update the condition, then save to view the updated Show Field condition.

Mark a field required in the Contact Verification card

  1. In the Layout workspace, note the list of fields.
  2. Select the checkbox of the desired field from the All Fields list
  3. Click the added field, and expand the properties panel
  4. In the properties panel, select Required checkbox.

Make fields conditionally required in the Contact Verification card

  1. In the Layout workspace, note the list of fields.
  2. Select the checkbox of the desired field from the All Fields list
  3. Click the added field, and expand the properties panel
  4. In the properties panel, hover over the Expression Editor icon (fx)
  5. Enter a condition in editor, then enter the required key and value.

    Here are some examples:
    • [[ $componentContext.callDirection == 'ORA_SVC_OUTBOUND' ]]
    • [[ $user.userName == 'ctiautouisvr3' ]]

After making changes you can publish the changes and start using the updated Contact Verification card.