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.

Setting up the LTI Integration

Step 1: Create a Developer Key

  1. Within Canvas, navigate to the Admin panel
  2. Go to Developer Keys > + Developer Key > + LTI Key
  3. Select Method > Paste JSON. Remove the default brackets and enter the JSON code:
  1. Click Save
  2. Edit the key you’ve just created, and input the following information:
    • Key Name: Nectir AI - Key
    • LTI Advantage Services: Ensure you select all services
    • Additional Settings > Custom Fields: workspaceId=YOUR_WORKSPACE_ID Important: only replace YOUR_WORKSPACE_ID with your actual Workspace ID. Keep workspaceId= at the front. To find your Workspace ID: go to Workspace Settings in your Nectir AI account. If you don’t have access to Nectir AI yet, contact support@nectir.io for your Workspace ID.
  3. Save the key and enable it with the State toggle

Step 2: Configure Nectir AI into an Account

Access control: as the LMS administrator, you can choose which Canvas accounts to configure Nectir AI into. This controls who can add Nectir AI to their course navigation. Only users within the selected account can use Nectir AI in their courses. This is how you manage and restrict access to Nectir AI across your institution.
  1. Copy the Client ID under the Details column (for example, “532080000000000615”)
  2. With the copied key, go to Admin > Settings > Apps > View App Configurations
  3. Select + App and then select Configuration Type > By Client ID
  4. Paste the Client ID of your configured developer key for Nectir
  5. Select Install

Step 3: Share Client ID with Nectir Team

Send the Client ID to your Nectir team contact so they can complete the integration setup on their end.

Step 4: Test the Integration

Once the Nectir team confirms they have enabled the integration, test it in a Canvas course by following the Linking Nectir AI to Your Canvas Course instructions below.
If you receive the error {"error":"LTI 1.3 Error - getPlatform: unregistered or invalid LTI platform"}, please make sure a Nectir Staff member has enabled the integration.

Linking Nectir AI to Your Canvas Course

Important: The linking process must start in Canvas, not in Nectir AI. You need to access Nectir AI through Canvas first to establish the connection between your Canvas course and your Nectir AI Group.
1

Access Course Settings

In your Canvas course, navigate to Settings in the left sidebar
2

Open Navigation Settings

Select the Navigation tab at the top of the settings page
3

Locate Nectir AI

Scroll down to the bottom section (disabled items) and find the Nectir AI app
4

Enable Nectir AI

Click the three-dot menu next to Nectir AI and select EnableAlternatively, you can click and drag the Nectir AI item up to the active navigation items section
5

Save Your Changes

Click the Save button at the bottom of the page
6

Launch Nectir AI

Nectir AI will now appear in your course navigation menu in the left sidebarClick on Nectir AI in the sidebar to launch the application
7

Link Your Canvas Course

When accessing Nectir AI for the first time, you’ll need to link your Canvas course to a Nectir AI Group
Canvas course linking

Linking your Canvas course to a Nectir AI Group

8

Choose Your Linking Option

You’ll see three options for connecting your Canvas course to Nectir AI:Create a Group: Creates a brand new Nectir AI Group specifically for this Canvas course. Choose this if you’re setting up your first Assistant or want a completely fresh start for this course.Duplicate a Group: Makes a copy of an existing Group (including all Assistants, settings, and knowledge) for this Canvas course. Perfect for teachers who want to reuse successful Assistants from previous semesters while keeping student access separate.Link to an Existing Group: Connects this Canvas course to an existing Group you already have. Students from this Canvas course will join the existing Group and can interact with Assistants that may already have other students. Useful for:
  • Cross-listed courses that should share the same Assistants
  • Multi-section courses where you want all students in one Group
  • Continuing courses where you want to maintain chat history and Assistant improvements
Most teachers use “Duplicate a Group” at the start of each semester to reuse their successful Assistants while keeping each semester’s students separate.

LMS Role Mapping

As the LMS administrator, you may want to configure how Canvas roles (Student, Teacher, TA, etc.) map to Nectir AI roles. This controls what permissions different users have within your Nectir AI Workspace. For complete information on configuring LMS role mapping, see LMS Role Mapping (LTI Only) in Workspace Settings.

Troubleshooting

If you’re experiencing issues with your Canvas integration: For Canvas-specific problems: go to Canvas Integration Issues for help with:
  • Assistant doesn’t appear in Canvas course
  • Login prompts when accessing through Canvas
  • Connection confirmation issues
  • Course linking problems
For general browser problems: go to Browser & Display Issues for help with:
  • Pages not loading correctly
  • Broken layouts or missing buttons
  • Cache and cookie issues
  • Browser compatibility problems
For other issues: contact support at support@nectir.io