This guide is intended for LMS administrators. If you encounter any issues during the integration process, please contact your Nectir AI account manager or email support@nectir.io.

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: c7fbffbb-5745-4b2a-97c9-7c5d8f3f4a0b
  4. Click Submit
  5. After submitting, copy the Default Deployment ID and send it to your Nectir AI representative

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.

Configure tool settings

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

        You can find your ID by going to Nectir AI > settings > Copy and paste the ID field

    • 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 will open 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. You will be redirected back to the deployment setup window
    • Click Submit

Create a placement

  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-course
      • 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
    • Click Submit

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.

Adding Nectir AI to a course

  1. Navigate to your course in Blackboard
  2. From the course menu, click on the Tools area
  3. Click on Nectir AI
  4. The Nectir AI integration will load in a new window or tab
  5. Students can 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 the Client ID was entered correctly
  • Ensure that the Default Deployment ID was shared with your Nectir AI representative
  • Check that all user fields are being sent to the tool
  • Confirm that the tool is properly deployed to the correct node
  • Make sure the placement is configured as a Course Tool with student access allowed
  • Contact your Nectir AI representative for additional support at support@nectir.io