--- title: Create the Agentic AI Bot slug: neurons-for-itsm/admin-user-help/enu/latest/create-the-agentic-ai-bot createdAt: 2026-08-26T10:27:44.000Z --- This section describes how to integrate Neurons for ITSM with Microsoft Teams Bot to create a custom Teams app. This enhanced integration improves user experience by streamlining ITSM interactions directly within Microsoft Teams. ::::ExpandableHeading ## Prerequisites - Enable the Global Constant from the Configuration console > **Global Constants** > **IntelligentBotIntegrationEnabled** > set it to **True**. For more information, refer to [List of Global Constants](docId\:dgB4V84eDR0Axvy7MLnNF). - Enable theNeurons for ITSM Chat feature if you plan to enable Live Agent Transfer for any agent on the **AI Configuration Hub** > **Agentic AI** > **Agent Settings** page. This allows the Microsoft Teams Bot users to interact with Analysts who respond via WebChat. To learn how to enable the chat feature, refer to [Configuring the Chat Feature](docId\:ek9NI60X4ZYJksOB1ocq6). - Ensure Microsoft Teams application is installed on your computer with Admin credentials. :::hint{type="info"} It is recommended to set up the chat application first, followed by the Teams Bot application. ::: :::: ::::ExpandableHeading ## Creating the Teams app from Microsoft Teams App Studio 1. Log in to your Microsoft Teams account and open the [Microsoft Teams Developer Portal](https://dev.teams.microsoft.com/home). Clients must have an account for the Teams Bot to function. :::hint{type="info" indent="1"} In the **Microsoft Teams Developer Portal**, the new user interface opens by default when customers access it, without requiring any additional configuration. ::: 2. Go to **Home**, click **Create a new app**. 3. In the **Create a new app** window, provide a name for the app and select **Latest Stable** as manifest version and click **Create**. 4. In the Configuration page, click **Basic Information**. 5. Enter the following details: | **Fields** | | **Description** | | ----------------------------------------------- | -------------------------------------- | ------------------------------------------------------------ | | App Details





| Short Name and Long Name | Contextual names of the app. | | | App ID | This is auto-generated by Microsoft App Studio. | | | Version | Version number . | | | Short Description and Long Description | Contextual descriptions of your app. | | | Developer/Company Name | Your company name. | | | Website | Your company website URL. | | | Privacy statement | URL to the privacy statement of your organization. | | | Terms of use | URL to the terms of use or policy page of your organization. | :::hint{type="info" indent="1"} Ensure that you fill in the App Details (Short Name and Long Name) and the Description fields (Short Description and Long Description). If any of these fields are not filled in, the app upload might fail. ::: 6. Optionally, click **Branding** to add a branding logo or other elements of your organization. 7. Click **Save**. :::: ::::ExpandableHeading ## Create the Microsoft Teams Bot app You need to create, configure, generate client secret key and link a Bot to Microsoft Teams app. ### Create a Bot 1. Log in to [Microsoft Teams Developer Portal](https://dev.teams.microsoft.com/home) . 2. Go to **Apps**. Click the app you created from the app list. 3. Go to **App Features** and then click **Bot**. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/12eSTotf9Buu26AKBrcI7_image39.png" position="flex-start" size="80" width="1800" height="884" initialPath="../Resources/Images/image39.png" githubPath="Admin-User/Content/Resources/Images/image39.png" darkWidth="1800" darkHeight="884" showCaption="true" caption="App features page" indent="1"} 4. Select an existing Bot from the dropdown or click **Create a new bot**. 5. In the **Bot Management**, a list of existing bots is displayed. To create a new Bot, click **New bot** and enter a name for the Bot, then click **Create bot**. ### Configure the Bot Once the new bot is created, it automatically takes you to the **Configure** page. You need the Bot ID to complete the integration between Microsoft Teams andNeurons for ITSM. The Bot ID is displayed in the URL. 1. Copy and save the Bot ID from the URL, which is the value between **/bots/** and **/configure**. :::Paragraph{indent="1"} Example: *https\://dev.teams.microsoft.com/bots/your-bot-id/configure* ::: ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/xMeCObRahz9VcXsCtvmqm_botid2.png" position="flex-start" size="80" width="1236" height="590" initialPath="../Resources/Images/botid2.png" githubPath="Admin-User/Content/Resources/Images/botid2.png" darkWidth="1236" darkHeight="590" showCaption="true" caption="Masked Bot ID in the URL" indent="1"} 2. In the **Configure** page, enter the Bot endpoint address and click **Save**. :::Paragraph{indent="1"} The Bot endpoint address should be in the following format: ::: :::BlockQuote{indent="1"} https\://\{customer tenant ID}/IvantiBotService/intelligentbot/api/messages? ::: :::hint{type="danger" indent="1"} To maintain secure communication, restrict public access to the Bot endpoint address. Revealing the endpoint will result in unauthorized access or misuse of the Bot service. Only the ITSM tenant address should be publicly accessible. ::: ### Generate the Client Secret Key for the Bot 1. On the side panel, click **Client secrets** > **Create your first client secret** > **Create client secret**. 2. Copy and save the** Secret key** to use when configuring the integration between Neurons for ITSM and Microsoft Team app. 3. Click **Done**. :::hint{type="danger"} This **Client Secret Key** is displayed only once. Ensure you save it securely. ::: ### Link the Bot to the Microsoft Teams app Now that you have created the Bot, go through the following steps to link the Bot to the Microsoft Teams app. 1. In the [Microsoft Teams Developer Portal](https://dev.teams.microsoft.com/), go to the **App**, select your **App **from the list. 2. Click on **App Features** and click **Bot**. 3. Choose a **Bot** from the **Select an Existing Bot** dropdown or manually enter the **Bot ID**, you want to configure. 4. In the** What can your bot do?** section, select **Upload and Download files**. 5. Under **Scope**, select **Personal** checkbox, and click **Save**. :::: ::::ExpandableHeading ## Download the package for the Microsoft Teams 1. Go to **Publish** > **Publish to org**, and then click **Publish** on the upper-right corner of the page. :::hint{type="info" indent="1"} In the new UI of the Microsoft Teams Developer Portal, the **Distribute** button appears in the upper-right corner instead of **Publish**. ::: 2. Select the **Download the app package** from the pop-up to download the app package for the Microsoft Teams Bot app. :::hint{type="info" indent="1"} If this app is intended for organization‑wide use, share it with your IT administrator and publish it to your organization. For testing or demo purposes, download the app package and deploy it individually in your Teams instance. ::: 3. Upload the new package using one of the following methods: - Through the Teams Admin Center. - Directly in Microsoft Teams, depending on your deployment method. 4. Verify that the updated version is installed and available to users. :::hint{type="info" indent="1"} This step is required by Microsoft to ensure the app is properly packaged and ready for deployment within Microsoft Teams. ::: ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/Qi5z9bgf-bdtW947_cRQk_agentic-ai-download-app.png" position="flex-start" size="80" width="602" height="369" githubPath="Admin-User/Content/Resources/Images/Download App Package.png" darkWidth="602" darkHeight="369" showCaption="true" caption=" Download the App Package pop-up" indent="1"} :::: :::ExpandableHeading ## Uploading the App in Microsoft Teams You can upload the Teams app and make it available for employees in your organization to use. Only when the app is uploaded and available, users can add it to their Microsoft Teams client app and use it as a communication channel to chat with Agentic AI. 1. Log in to your Microsoft Teams account. 2. Go to **Apps** > **Manage your apps** > **Upload an app**. 3. Choose an option: - **Upload a custom app** – if the app is for individual or team use. - **Submit an app to your org** – if the app is for organization-wide use. ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/pc0P4ldtqA0DUgDCH0EIK_agentic-ai-upload-app.png" position="flex-start" size="80" width="702" height="425" githubPath="Admin-User/Content/Resources/Images/image9.png" darkWidth="702" darkHeight="425" showCaption="true" caption="Update domain details" indent="1"} The app you built is now available for employees in your organization or team to use. ::: ::::ExpandableHeading ## Configure Email Address for Microsoft Teams Bot Access To use the Microsoft Teams Bot with your ITSM account, ensure that your email address is correctly configured in the ITSM portal. These steps applicable only to ISM users. 1. Log in to Neurons for ITSM and go to the **Employee** workspace. 2. Create a new user record and enter the username and email address in the appropriate fields. 3. Ensure that the user has the role specified in the **DefaultAgenticAIUserRole **Global Constant, or the **Self Service User** role if the **DefaultAgenticAIUserRole** Global Constant is not defined. On the **Roles **tab, use the **Link **option to add the appropriate role. 4. Save the changes. :::Paragraph{indent="1"} By default, changes takes up to 30 minutes. To avoid this and to reflect changes in the Microsoft Teams Bot, clear the cache. ::: :::Paragraph{indent="1"} Perform the following: ::: :::Paragraph{listStyleType="decimal" indent="2"} Go to Settings > **Cache Management**. ::: :::Paragraph{listStyleType="decimal" listStart="2" listRestartPolite="2" indent="2"} Click on **Reset Teamsbot Objects**. ::: ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/ZVBKFo1pzcathj8vy1WrX_image35.png" position="flex-start" size="80" width="2532" height="1286" initialPath="../Resources/Images/image35.png" githubPath="Admin-User/Content/Resources/Images/image35.png" darkWidth="2532" darkHeight="1286" showCaption="false" indent="2"} :::hint{type="info" indent="2"} This configuration step is not required for non-ISM users. ::: ::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/Om_oh9Xav3jWfU_ULzktQ_teams-bot.png" position="flex-start" size="80" width="1155" height="876" initialPath="../Resources/Images/Teams Bot.png" githubPath="Admin-User/Content/Resources/Images/Teams Bot.png" darkWidth="1155" darkHeight="876" showCaption="true" caption="Configuring Bot with email address"} :::: To learn how to use the Agentic AI bot, refer to the [Sample use case](docId\:GINnTA2rklqRrVAJEbpqo).