Skip to main content

ServiceNow

CloudCADI integrates with ServiceNow to send recommendations directly to your engineering team as tickets, using a single action button. Tickets are created in the default change_request table using a dedicated, least-privilege ServiceNow user.

Step 1 - Configure ServiceNow​

Target table​

  • By default, CloudCADI creates tickets in the native change_request table. No table or app setup is required.
  • If you prefer a custom table or any other table, that is also supported. The table only needs to contain the short_description and description fields.

Fields sent by CloudCADI​

CloudCADI sends only the following two fields when creating a ticket:

FieldContent
short_descriptionRecommendation title
descriptionRecommendation details

Create a dedicated integration user​

Create a dedicated user for CloudCADI instead of using an administrator account.

  • In ServiceNow, navigate to User Administration > Users and click New.

  • Enter a User ID such as cloudcadi_integration, and a First name and Last name such as CloudCADI and Integration.

  • Set Identity type to Machine so the user is used for API access only and cannot sign in through the ServiceNow UI. If your form has a Web service access only checkbox instead of Identity type, select that checkbox.

  • Click Submit.

    CloudCADI ServiceNow create integration user

  • Search for the new user in the Users list and open it.

    CloudCADI ServiceNow user list

  • Click Set Password, then click Generate or enter a strong password. Copy the password, click Save Password, and keep it safe. You will use it when configuring CloudCADI.

    CloudCADI ServiceNow set password

Assign minimal permissions​

The integration user only needs permission to create records in the target table and to authenticate to the REST API. Administrator roles are not required.

  • Open the integration user, go to the Roles tab, and click Edit.

    CloudCADI ServiceNow edit roles

  • Add the following roles and click Save:

    • itil - allows creating records in the change_request table. You can use a custom role that grants only create access on change_request instead.
    • snc_basic_auth_api_access - allows the user to authenticate to the REST API using a username and password.

    CloudCADI ServiceNow assign roles

  • If you use a custom table, create an ACL that grants the create operation on that table to the integration user's role.

Prepare the POST URL​

CloudCADI creates tickets using the ServiceNow Table API. Build the URL from your instance URL:

https://<your-instance>.service-now.com/api/now/table/change_request
  • Replace <your-instance> with your ServiceNow instance name.
  • If you use a custom table, replace change_request with the table name, for example u_cloudcadi_ticket.

Step 2 - Configure CloudCADI​

  • To integrate ServiceNow, navigate to Settings, select Integrations, and click Activate.

    CloudCADI ServiceNow activate

  • Enter the POST URL you prepared in Step 1.

  • Provide the Username and Password of the dedicated integration user created in Step 1.

  • Enter the URL, Username, and Password, then click Activate.

    CloudCADI ServiceNow activate form

  • To update the details, click Update, enter the new details, and click Update again.

    CloudCADI ServiceNow update CloudCADI ServiceNow update confirm

  • To deactivate the integration, click Deactivate.

    CloudCADI ServiceNow deactivate

  • To verify the ServiceNow integration, go to the CloudCADI Recommendation page and click Create Ticket.

    CloudCADI ServiceNow create ticket

  • A confirmation popup will appear indicating that a ticket has been created.

  • In ServiceNow, navigate to Change > All (the change_request table). The new ticket appears with the recommendation title in Short description and the details in Description. If you use a custom table, the ticket appears in that table instead.

    CloudCADI ServiceNow change request