Install CXone Agent Embedded in Oracle

This is the first step of setting up CXone Agent Embedded in Oracle.

This page explains how to install CXone Agent Embedded in Oracle. Once it's installed, agents can use it to handle interactions directly inside Oracle.

CXone Agent Embedded appears inside Oracle when the phone icon on the left is clicked.

Complete each of these tasks in the order given.

Download and Configure CXone Agent Embedded

First, download CXone Agent Embedded from CXone and configure it for use within Oracle.

  1. In CXone, click your initials Icon of your initials in a white circle. in the right corner of the CXone top navigation bar.

  2. Click Support & Downloads.

  3. Scroll down to Agent Applications. Find CXone Agent for Oracle Extension. Click Download.

  4. Open the downloaded cxa_oracle_extension.zip folder.

  5. Open the property.json file. In the defaultValue field, find the section of the CXone Agent Embedded URL that's in curly brackets.

    An example image. The defaultValue property has been changed to include the customer's Oracle instance domain in the URL.

  6. Replace that section with your Oracle instance domain. To find your Oracle instance domain, open your instance of Oracle and copy and paste the URL from the address bar in your browser. You only need the section of the URL between https:// and .com.

    For example, for an Oracle instance domain of company.oracle, the value of the defaultValue field would be https://cxagent.nicecxone.com/?app=cxa_osc&base=https://company.oracle.com.

  7. Save property.json.

Upload CXone Agent Embedded to Oracle B2C Service

Then, upload CXone Agent Embedded to Oracle B2C Service, also known as Oracle Service Cloud.

  1. Open Oracle B2C Service (Oracle Service Cloud).

  2. In the navigation menu, go to Configuration > Site Configuration > Add-In Manager.

  3. In the toolbar at the top, click New > Agent Browser UI Extension.

    In Oracle B2C, the New button at the top has been clicked. A drop-down appears under it, and the cursor hovers over Agent Browser UI Extension.

  4. Select the cxa_oracle_extension.zip folder and click Open.

  5. In the Add-In Details editor, give the add-in a Name of cxa-oracle-extension. This must be the name of the add-in when uploading it to Oracle. If you use a different name, CXone Agent Embedded will not appear to agents.

  6. For Extension Type, select Console.

  7. In the Extension Files table, check the box for Init File in the row for extensionLoader.js. Check the box for Configuration in the row for properties.json.

    The Add-In Details editor. Fields, including Name, Notes, and Extension Type appear at the top. The Extension Files table is under that.

  8. Click Save in the toolbar at the top.

Enable CXone Agent Embedded for Agent Profiles

Next, enable agents to use CXone Agent Embedded in Oracle by allowing it for their Oracle profile.

  1. With the cxa-oracle-extension add-in open, click the Profile Access tab.

  2. In the Profiles Allowed to Access section, select the profile of the agents who will use CXone Agent Embedded.

  3. In the Allowed Interfaces section, select the Oracle interface where you want agents to see CXone Agent Embedded. To add it to all Oracle interfaces, select the checkbox for Select All.

  4. Click Save in the toolbar at the top.

Configure Click-to-Call

Follow these steps to set up Click-to-Call for CXone Agent Embedded in Oracle.

  1. Open Oracle B2C Service (Oracle Service Cloud).

  2. In the navigation menu, go to Configuration > Application Appearance > Workspaces/Workflows.

  3. Double-click the contact workspace for the agents' Oracle profile.

  4. If the phone field is in the workspace, delete the Office Phone field.

    The cursor hovers over Delete next to Office Phone.

  5. Drag and drop the table from the Insert Control ribbon into the contact workspace. By default, the table is created with two rows. Delete the second row.

  6. Drag and drop the Phone Numbers field from the Insert Field ribbon into the first column of the table.

  7. Drag and drop the Button control from the Insert Control ribbon into the second column of the table.

  8. Click the Button control, then click the Design tab in the ribbon. In the Text field, enter the text you want to display on the button; for example, Click to call.

  9. Align the Office Phone field and Click-to-Call button:

    1. Drag and drop a spacer from the Insert Control ribbon. Make sure to add the spacer vertically.

    2. Click the Design tab in the ribbon. Use the Increase Column Span option in Table Cell to increase the width of the Office Phone field.

  10. Add a rule to the Click-to-Call button:

    1. Click the Click-to-Call button, then click the Rules tab.

    2. In the window that opens, set the Trigger as A button is clicked.

    3. Click Next, then skip the Conditions tab.

    4. On the Then Actions tab, select Fire a named event.

    5. Click Named Event Hyperlink and name the event as cxone-click-to-dial. This is case-sensitive.

    6. Click Next. In the Properties tab, enter a Rule Name for this rule and click Finish.

    7. Save the workspace.

  11. Clear your cache and refresh your browser, then test the Click-to-Call button in CXone Agent Embedded in Oracle.

The next step of setting up CXone Agent Embedded in Oracle is to set up a CRM configuration.