Skip to main content

Set up the integration for ServiceNow in Genesys Cloud

Before creating the integration, obtain the following information from ServiceNow:

  • ServiceNow Instance Domain – In the URL of the ServiceNow instance, https://<instance_domain>.service-now.com, <instance_domain> is the unique domain name that identifies the instance.
  • ServiceNow Instance Base URL – The URL of the ServiceNow instance, https://<instance_domain>.service-now.com, used to access your specific ServiceNow instance.
  • ServiceNow Openframe Configuration ID – Navigate to All > OpenFrame Configuration and select the specific configuration from the list. Right-click and select Copy sys_id. The sys_id is the OpenFrame Configuration ID.
  • ServiceNow Integration User ID – The user ID integration of the dedicated user account created for managing Genesys Cloud as an external application in ServiceNow. For more information, see . Navigate to All > User Administration > Users and select the integration user. Right-click and select Copy sys_id.

To create the integration for ServiceNow:

  1. Click Admin.
  2. Under Integrations, click Integrations.
  3. Click Menu > IT and Integrations > Integrations.
  4. Click Add integrations in the upper right corner.
  5. Search for the Unified Experience from Genesys and ServiceNow integration and click Install.
  6. (Optional) Genesys Cloud provides a default name. If you modify the name, ensure that the name is unique.
  7. Click the Configuration tab.
  8. Under Properties, fill in the following mandatory property values about ServiceNow:
    • ServiceNow Instance Domain
    • ServiceNow Instance Base URL
    • ServiceNow Openframe Configuration ID
    • Group Filtering
  9. On the Advanced tab, provide the status mapping configuration between Genesys and ServiceNow in JSON format. For more information, see .
  10. On the Credentials tab, click Configure. The Configure Credentials window opens and enter the following details:
    • Private key for the ServiceNow integration. Copy the server.key created during the key pair creation. For more information, see .
    • ServiceNow Integration User ID. Use the sys_id of the integration user created in the ServiceNow platform. For more information, see .
    • Unified Experience from Genesys and ServiceNow Client ID
    • Unified Experience from Genesys and ServiceNow Client Secret
  11. Click OK and then Save.
  12. To activate your new integration, set the Status switch to Active.
  13. Click Yes.