Account Mapping

Required permissions to map accounts: General > Account Mapping Create

Map an external platform to CXone so they can share information back and forth. For example, mapping Microsoft Teams to CXone lets you sync the agent states between the two platforms. When an agent's CXone state changes to Busy when answering a call, the Teams state would also change to Busy. After mapping CXone to your external platform, you can sync agent states.

Before You Begin

Part of this process is selecting an access key user. This user's access key is used to validate communicate between CXone and the external platform. Your CXone system may already have this type of user created, especially if your organization uses CXone APIs. This user must not be deactivated, or the account mapping will stop functioning. If you do not have this type of user set up and you do not want to use an existing CXone account, create a user with the following permissions:

• Agent Session Control Via API On

• Security Profile View

• Presence Sync > User Mapping Map

• Presence Sync > Rules All

Map CXone to RingCentral and Atos

1. Click the app selector and select Adapters.

2. Click Account Mapping.

3. If you have multiple business units High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment registered, click the business unit that you want to map the account with RingCentral.

4. Click RingCentral.

5. Click Map Account.

6. In the Adapter Version section, select the correct versions for the Presence Sync Adapter Version and Directory Sync Adapter Version drop-downs.

7. In the ACD Business unit Details section, enter the details about the tenant.

   Learn more about the fields in this step

   Field	Details
   Tenant ID	Enter your tenant ID. Displays your tenant ID.
   Tenant Name	Enter the name of your tenant. Displays your tenant name.
   User For Access Key	From the User For Access Key drop-down, select the user for whom you want to generate an access key. This user is used for various Directory Sync operations. When you select the user, the access key is generated and stored in the system. It is recommended to create a separate system user in CXone that is active all the time.
   Email ID	The email address of the tenant that you enter receives critical notifications about any issues in the agent state sync process. For instance, when an authentication failure happens for your tenant. If there's an authentication failure, check the credentials entered in the ACD BU Details tab and [Partner] Account Details tab. In case of authentication failure, the agent state synchronization will not happen.

8. Under the Email Notification Members section, add any email addresses which you want to receive notifications for adapter health, authentication failures, and exceptions.

9. Click Next and add your RingCentral account and authentication details.

   Learn more about the fields in this step

   Field	Details
   Account ID	Enter the account ID of your RingCentral tenant. This field is required.
   Username	Enter a valid username for the Admin account in the partner platform. This field is required.
   Password	Enter a password for your account. This field is required.

10. Click Map & Register.

Map CXone to Microsoft Teams

You can map up to 8 Microsoft tenants to your CXone account.

1. Click the app selector and select Adapters.

2. Click Account Mapping.

3. If you have multiple business units High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment registered, click the business unit that you want to map the account with RingCentral.

4. Click Microsoft Teams.

5. Click Map Account.

6. Under ACD Business unit Details, enter the details about your business unit.

   Learn more about the fields in this step

   Field	Details
   Business Unit ID	Enter your business unit ID. This field is required.
   Business Unit Name	Enter the name of your business unit. This field is required.
   User For Access Key	From the User For Access Key drop-down, select the user you want to generate an access key for. This user is used for various Directory Sync operations. When you select the user, the access key is generated and stored in the system. It is recommended to create a separate system user in CXone that is active all the time.

7. Click Next.
8. From the Microsoft Teams Platform Version drop-down under Adapter Version, select Microsoft - Version 1.

9. Enter your Account ID, Access Key ID, Secret, and Domain. The domain is only required for users that were created programmatically.

   Learn more about the fields in this step

   Field	Details
   Account ID	Enter your Microsoft Teams Directory (tenant) ID. You get this ID when you create the Microsoft Teams app for access credentials.
   Access Key ID	Enter your Microsoft Teams Application (client) ID. You get this ID when you create the Microsoft Teams app for access credentials.
   Secret	Enter the secret key generated when you created an app in the Microsoft Teams directory.
   Domain	Enter the domain name for the system users. Programmatically-created system users have a configurable domain name. A domain name is required only for this type of users.

10. Select Create System Users Programmatically if you want to automatically create system users in your Azure Directory using the app credentials from the Microsoft Azure portal. If you enable this, Azure creates each system user with the name CXone_xxxxx.
11. If you want to add additional Microsoft Teams tenants:
    1. Click to add a new tab for each new tenant. You can double click the new tab name to rename it.
       View image

       
    2. Complete the information for the additional tenant as specified in the previous steps.
12. Click Next.
13. Enter the account credentials of your Microsoft Teams system users. You must have at least one Teams system user per 650 Azure Active Directory Sync or Presence Sync mapped users. You have two options:
    • If you select the Create System Users Programmatically checkbox, it automatically creates system users in Azure Directory using the app credentials from the Microsoft Azure portal.
    • If you clear the Create System Users Programmatically checkbox, you'd have to manually add the Teams account credentials. This may be necessary if your organization's policies do not allow these system users to be added programmatically. This option provides you independent system users for Microsoft Teams Presence Sync and Microsoft Teams Directory Sync
14. In the Email Notifications section, add any email addresses that you want to receive notifications for adapter health, authentication failures, and exceptions.
15. Click Map and Register.

You can map multiple CXone accounts to a Microsoft Azure account.

 

Map CXone to Zoom

1. In CXone, click the app selector and select Adapters.

2. Click Account Mapping.

3. If you have multiple business units High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment registered, click the business unit that you want to map the account with RingCentral.

4. Click Zoom.

5. Click Map Account.

6. In the Adapter Version section, select the correct version for the Presence Sync Adapter Version and Directory Sync Adapter Version drop-downs.

7. In the ACD Business unit Details section, enter the details about the business unit and your login information.

   Learn more about the fields in this step

   Field	Details
   Business Unit ID	Enter your business unit ID. Displays your business unit ID.
   Business Unit Name	Enter the name of your business unit. Displays your business unit name.
   User For Access Key	Select a user for whom you want to generate an access key. When you select the user, the access key is generated and stored internally in CXone. The access key is used for various operations. It is recommended to create a separate system user in CXone that is active all the time.
   Access Key ID	Enter your business unit access key ID, which was generated when you created a Zoom app. This field is required.

8. Click Next.

9. In the Adapter Version section, select the correct version for the Zoom Platform Version drop-down.

10. In the Zoom Account Details section, enter your Zoom account and authentication details.

    Learn more about the fields in this step.

    Field	Details
    Account ID	Enter your Zoom account ID.
    Account Name	Enter your Zoom Account Name.
    Access Key ID	Enter your Zoom application (client) ID. This field is required.
    Secret	Enter the secret for the access key ID you have entered. This field is required.
    Secret Token	Enter your Zoom application secret token. This field is required.

11. Enter email addresses to receive notifications for Adapter Health, Authentication Failures, and Exceptions. Use comma-separated values to enter multiple email IDs.

12. Click Map & Register.

Map CXone to Agent for Service Cloud Voice

1. Click the app selector and select Adapters.

2. Click Account Mapping.

3. If you have multiple business units High-level organizational grouping used to manage technical support, billing, and global settings for your CXone environment registered, click the business unit that you want to map the account with RingCentral.

4. Click Salesforce.

5. Click Map Account.

6. In the Adapter Version section, select the correct versions for the Presence Sync Adapter Version drop-down.

7. In the ACD Business unit Details section, enter the details about the tenant.

   Learn more about the fields in this step

   Field	Details
   Business Unit ID	Enter your tenant ID. Displays your tenant ID.
   Business Unit Name	Enter the name of your tenant. Displays your tenant name.
   User For Access Key	From the User For Access Key drop-down, select the user for whom you want to generate an access key. When you select the user, the access key is generated and stored in the system.

8. Click Next and add your Salesforce account and authentication details.

   Learn more about the fields in this step

   Field	Details
   Organization ID	Enter the Salesforce account ID. This field is required.
   Username	Enter a valid username for the Admin account in the partner platform. This field is required.
   Password	Enter a password for your account. This field is required.
   Client ID	Enter your public identifier for your Salesforce account. You use the client ID to identify yourself to Salesforce.
   Client Secret	Enter your client secret. This establishes you as the owner of the client ID.

9. Click Map & Register.

Map Omni-Channel Statuses once you are finished with account mapping.