> ## Documentation Index
> Fetch the complete documentation index at: https://support.nectir.io/llms.txt
> Use this file to discover all available pages before exploring further.

# LTI Manual Registration

> How to manually integrate Nectir AI in Blackboard

export const entity_0 = "Workspace"

<Note>
  This guide is intended for LMS administrators. If you encounter any issues during the integration process, please contact [support@nectir.io](mailto:support@nectir.io).
</Note>

## For the LMS Administrator

Follow these steps to integrate Nectir AI with your Blackboard Learning Management System.

### Register the LTI Tool

1. Navigate to the **System Admin** panel
2. Go to **Integrations** > **LTI Tool Providers** > **Register LTI 1.3/Advantage Tool**
3. Enter the following information:
   * **Client ID**: `818b9df6-d847-4613-bce4-721800571dc3`
4. Click **Submit**
5. After submitting, copy the **Default Deployment ID** and send it to your Nectir AI representative

<Warning>
  The Default Deployment ID is required for Nectir to complete the integration
  setup on their side. Please make sure to share this with your Nectir AI
  representative.
</Warning>

### Configure Tool Settings

1. Configure the following settings for the tool provider:
   * **Tool Provider Custom Parameters**:
     * `workspaceId=YOUR_WORKSPACE_ID`

       <Tip>
         You can find your {entity_0} ID by going to **Nectir AI** > **{entity_0} settings** <Icon icon="gear" iconType="solid" color="black" /> > Copy and paste the **{entity_0} ID** field
       </Tip>
   * **User Fields to Send**:
     * Check all available fields
   * **Allow Grade Service Access**:
     * Select "Yes"
2. Click **Submit**

### Create a Deployment

1. Locate the newly created tool ("Nectir AI") in the **LTI Tool Providers** list
   * Click the dropdown menu next to it and select **Manage Deployments**
   * Click **Create Deployment** and fill in the following details:
     * **Name**: Nectir AI
     * **Add Node**:
       1. Click **Find Node**. A new window opens with node details
       2. In the search bar, set the following:
          * **Search By**: Name
          * **Condition**: Contains
          * **Value**: Root
       3. Click **Go**
       4. Select the appropriate node from the results and click **Submit**. This returns you to the deployment setup window
   * Click **Submit**

### Create a Placement

<Note>
  After creating the deployment, Blackboard may have automatically created a placement for you. Check **Manage Placements** before proceeding. If a placement already exists, skip this section to avoid creating a duplicate.
</Note>

1. Go back to the **LTI Tool Providers** list and locate "Nectir AI"
   * Click the dropdown menu and select **Manage Placements**
   * Click **Create Placement** and fill in the following details:
     * **Label**: Nectir AI
     * **Handle**: nectir-ai-group
     * **Type**: Select **Course Tool** and check **Allow student access**
     * **Launch in New Window**: Check this option
     * **Target Link URI**: [https://ai.nectir.io/api/lti13/validate](https://ai.nectir.io/api/lti13/validate)
   * Click **Submit**

<Tip>
  If you want to link directly to a specific Assistant, you can add a custom
  parameter to the placement. Edit the placement and add the parameter
  `assistantId=YOUR_ASSISTANT_ID` in the custom parameters section.
</Tip>

## Adding Nectir AI to a Course

1. Navigate to your course in Blackboard
2. From the course menu, click the **Tools** area
3. Click **Nectir AI**
4. Wait for the Nectir AI integration to load in a new tab
5. Students access Nectir AI the same way through the **Tools** area once they're enrolled in your course

## Troubleshooting

If you encounter issues with the Nectir AI integration:

* Verify that you entered the Client ID correctly
* Ensure that you shared the Default Deployment ID with your Nectir AI representative
* Check that the system sends all user fields to the tool
* Confirm that you deployed the tool to the correct node
* Make sure you set up the placement as a Course Tool with student access allowed
* Contact your Nectir AI representative for support at [support@nectir.io](mailto:support@nectir.io)