---
title: Neurons Bots Integration for ITSM
slug: neurons-for-itsm/admin-user-help/enu/latest/neurons-bots-integration-for-itsm
createdAt: 2026-07-14T19:16:45.871Z
---

The Ivanti Neurons Bots integration allows Neurons Bots defined on an Ivanti Neurons tenant to be executed from within Neurons for ITSM. This integration is provided in the form of a new Quick Action that enables users to configure the inputs required by the Neurons Bot, so that they are automatically populated from the current business object context at run time.

## Prerequisites

The following prerequisites are required before you can configure an Ivanti Neurons Bot for use within Neurons for ITSM:

- **Request that feature flags be enabled:** The Neurons Bot and Action Service are disabled by default. Contact the Ivanti Cloud Operations team and request that these two feature flags are enabled. Refer to [More Information](docId\:XmVzlfcwDKUPKfFlHopic).
- **Enable the Action Service global constant**: To use Neurons Bots, the **EnableActionService** must be set to **True**. If **EnableActionService** is not available in the global constants list (this may be the case for upgraded instances), Administrators can manually add the global constant. Refer to [Working with Global Constants](docId\:mirDh_rHcg0jeI2i56fMm).
- **Define an App Registration in&#x20;**&#x49;vanti Neuron&#x73;**:** The app registration parameters are required for your Neurons Bot client registration within ITSM. You can skip this prerequisite step if you already have a suitable app registration defined in Ivanti Neurons. You need the **Neurons Auth URL**, **Client ID** and **Client Secret** details of the app registation when configuring your client registration in ITSM. For infomation on creating an app registration in Ivanti Neurons, refer to [App Registrations](https://help.ivanti.com/ht/help/en_US/CLOUD/vNow/app-registrations.htm).
- **Define a&#x20;**&#x4E;eurons Bot in Ivanti Neuron&#x73;**:** You must either define a new Neurons Bot, or have a suitable existing Neurons Bot defined in your Ivanti Neurons tenant. For information on creating a Neurons Bot, refer to [Neurons Bots creation](https://help.ivanti.com/ht/help/en_US/CLOUD/vNow/neurons-bots-creation.htm).
- Contact the Ivanti Cloud Operations team and request that the **EnableContextForNeuronsBots** feature flag is enabled.

## Configure a Client Registration for your Neurons Bot

:::hint{type="info"}
Configuring a client registration only needs to be done if it has not already been setup previously for other integrations. Only a single client registration should ever be created.
:::

To configure the client registration:

1. From ITSM, open the **Client Registration** workspace.
2. Enter the following details:
   - **Name:** Enter a contextual name.
   - **Is On premise:** Clear the check box, this is not supported for on-premises installations.
   - **Client Registration URL:** Enter the Neurons Auth URL from the Ivanti Neurons app registration.
   - **Client ID** and **Client Secret:** Enter the Client ID and Client Secret from the Ivanti Neurons app registration.

     ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/H68gSHrK73JIRRrcDemx0_clientregistrationscreenshot.png" alt="screenshot of the client registration configuration form" position="flex-start" size="40" initialPath="../../Resources/Images/help-images/client_registration_screenshot.png" githubPath="Content/Resources/Images/help-images/client_registration_screenshot.png" showCaption="false" width="1245" height="583" darkWidth="1245" darkHeight="583"}
   3. Click **Save**.

## Add the Neurons Bot Results Child Panel to the CI Business Object Layouts

If you are upgrading from a Neurons for ITSM version earlier than 2024.2, you need to add the **Neurons Bot Results** child panel to the **CI** business object layouts.

The **Neurons Bot Results** child panel enables you to monitor the progress of a Neurons Bot when invoked.

For more information on layouts, refer to [Creating a Layout](docId\:RQt5uPm8WnvU2TbRgbPX_).

1. Navigate to the **Computer** form view for the **CI** business object.

:::Paragraph{indent="1"}
a. Open the Configuration console, and then select **Build&#x20;**>**&#x20;Business Objects**.
:::

:::Paragraph{indent="1"}
b. Open the **CI** business object, and then select **Layouts**.
:::

:::Paragraph{indent="1"}
c. Select the layout you want to add the panel to.
&#x20;    For new setups this is typically added to the **AMC.CI** layout.
:::

:::Paragraph{indent="1"}
d. From **View in this layout**, select the view that you want to add the child panel to. For example, select **Computer**.
:::

2. Add the **Neurons Bot Results** child panel.

:::Paragraph{indent="1"}
a. Scroll to the bottom of the **Child Panels** table, and click **Add Child Panel**.
:::

:::Paragraph{indent="1"}
b. Click **\<Not set>** in the **Display Name** column, and enter Neurons Bot Results .
:::

:::Paragraph{indent="1"}
c. Click **\<Not Set>** in the **Object** column (2nd column) to open the **Relationship Editor**, configure the following settings:
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/vHwpjxzeyVaR5kGcOan5L_childpanelrelationshipeditor.png" alt="Image of the relationship editor" position="flex-start" size="40" initialPath="images/child_panel_relationship_editor.png" githubPath="Content/Configure/Neurons/images/child_panel_relationship_editor.png" showCaption="false" width="740" height="312" darkWidth="740" darkHeight="312" indent="2"}

:::Paragraph{listStyleType="disc" indent="3"}
Select **Use only direct relationship to child object(s)**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Set **Direct Relationship** to **NeuronsBotInvocationCIResult (via ResultAssocCI)**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Click **Save**, and then click **Yes**.
:::

:::Paragraph{indent="1"}
d. Click **\<Not Set>** in the **List** column, and select **NeuronsBotInvocationCIResults**.
:::

:::Paragraph{indent="1"}
e. Click **\<Not Set>** in the **Form(s)** column, and select **NeuronsBotInvocationCIResult**.
:::

:::Paragraph{indent="1"}
f. Select the **Show Count in Title** checkbox.
:::

:::Paragraph{indent="1"}
g. Click **Save**.
:::

3. Add the **Neurons Bot Invocations** child panel.

:::Paragraph{indent="1"}
a. Scroll to the bottom of the **Child Panels** table, and click **Add Child Panel**.
:::

:::Paragraph{indent="1"}
b. Click **\<Not set>** in the **Display Name** column, and enter Neurons Bot Invocations.
:::

:::Paragraph{indent="1"}
c. Click **\<Not Set>** in the **Object** column (2nd column) to open the **Relationship Editor**, and configure the following settings:
:::

:::Paragraph{listStyleType="disc" indent="3"}
Select **Use only rollup relationship(s) to grandchild objects**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Set **Business Object** to **NeuronsBotInvocation**.
:::

:::Paragraph{indent="1"}
d. Click **Add New Rollup Sequence**, and configure the following settings.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Enter Invocations for the **Display Name**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Select the **Show rollup records by default** checkbox.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Click the plus :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/vG9JzqPCpRCGf1LDKURVP_plusicon.png" alt caption size="10" width="19" height="19"} icon next to rollup chain, and then click **\<Not Set>** under **no object selected**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Select **NeuronsBotInvocationCIResult** from the drop-down list.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Click the plus :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/vG9JzqPCpRCGf1LDKURVP_plusicon.png" alt caption size="10" width="19" height="19"} icon again, and then click **\<Not Set>** under **no object selected**.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Select **NeuronsBotInvocation** from the drop-down list.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Click **Save**, and then click **Save** again.
:::

:::Paragraph{listStyleType="disc" indent="3"}
Click **Yes**, and then click **OK**.
:::

:::Paragraph{indent="1"}
e. Click **\<Not Set>** in the **List** column and select **NeuronsBotInvocations**.
:::

:::Paragraph{indent="1"}
f. Click **\<Not Set>** in the **Form(s)** column, and select **NeuronsBotInvocation**.
:::

:::Paragraph{indent="1"}
g. Select the **Show Count in Title** checkbox.
:::

:::Paragraph{indent="1"}
h. Click **Save**.
:::

:::hint{type="info"}
Add the Neurons Bot Invocations child panel. You can add this child panel to any business object, not only to business objects that have a CI relationship. For the full procedure, refer to Adding Neurons Bot Invocations to a Business Object.
:::

## Verify the Child Panel Configuration

After you save, compare the child panel row against the following values.

| **Column**      | **Values**                                       |
| --------------- | ------------------------------------------------ |
| Display Name    | Neurons Bot Invocations, or the name you entered |
| Object          | NeuronsBotInvocation                             |
| Relationship(s) | \<business object>                               |
| Display         | List                                             |
| List            | NeuronsBotInvocations                            |
| Form(s)         | NeuronsBotInvocation                             |
| Placement       | Tab                                              |

## Assign Workspace to Business Object

Assign Workspace to Business Object

Perform the following steps only when adding a workspace to a new business object.

1. In the **Configuration Console**, go to **Configure** > **Users and Permissions** > **Roles and Permissions**.
2. In the **Roles and Permissions** list, select **Admin**.
3. Click on the **Top Level Tabs** tab.

![](https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/jAKANBXl1gLI_eQVfBPdU_image.png)

4. Click **ADD NEW TAB**, select **Object workspace** from the list.

## Configure a Neurons Bot Quick Action

You need to configure a Neurons Bot Quick Action in the Graphical Action Designer, which defines how a Neurons Bot is invoked within ITSM.

To open the Graphical Action Designer, refer to [Using the Graphical Action Designer (GAD)](docId:2Wq6ihUN2zxiR21eA3M7g).

For information on configuring a Neurons Bot Quick Action, refer to [Neurons Bot Quick Action](docId\:LMf9Sf0pRhqB6pt-XixTT).

## Invoke a Neurons Bot

Refer to [Invoking a Neurons Bot](docId\:B2hO_kDNfBQhQeJ-M5sEB)
