Skip to main content
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:
{
  "title": "Nectir AI",
  "description": "Nectir AI gives educators the power to create personalized AI Assistants tailored to their curriculum, providing 24/7 guidance to students through interactive conversations. Seamlessly integrated into your LMS class page, your AI Assistants will offer instant feedback, clarify concepts, and identify knowledge gaps, all based on your own materials – elevating learning outcomes for students while reducing workload.",
  "public_jwk_url": "https://ai.nectir.io/api/lti13/keys",
  "target_link_uri": "https://ai.nectir.io/api/lti13/validate",
  "oidc_initiation_url": "https://ai.nectir.io/api/lti13/login",
  "application_type": "web",
  "response_types": ["id_token"],
  "grant_types": ["implicit", "client_credentials"],
  "initiate_login_uri": "/api/lti13/login",
  "redirect_uris": ["https://ai.nectir.io/api/lti13/validate"],
  "client_name": "Nectir",
  "jwks_uri": "https://ai.nectir.io/api/lti13/keys",
  "logo_uri": "https://app.nectir.io/images/logo/logo.svg",
  "token_endpoint_auth_method": "private_key_jwt",
  "scope": [
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem",
    "https://purl.imsglobal.org/spec/lti-ags/scope/lineitem.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/result.readonly",
    "https://purl.imsglobal.org/spec/lti-ags/scope/score",
    "https://purl.imsglobal.org/spec/lti-nrps/scope/contextmembership.readonly",
    "https://canvas.instructure.com/lti/public_jwk/scope/update",
    "https://canvas.instructure.com/lti/account_lookup/scope/show",
    "https://canvas.instructure.com/lti-ags/progress/scope/show"
  ],
  "extensions": [
    {
      "platform": "canvas.instructure.com",
      "settings": {
        "default": "disabled",
        "platform": "canvas.instructure.com",
        "placements": [
          {
            "placement": "account_navigation",
            "message_type": "LtiResourceLinkRequest",
            "display_type": "full_width_in_context",
            "target_link_uri": "https://ai.nectir.io/api/lti13/validate"
          },
          {
            "placement": "course_navigation",
            "message_type": "LtiResourceLinkRequest",
            "display_type": "full_width_in_context",
            "target_link_uri": "https://ai.nectir.io/api/lti13/validate"
          }
        ]
      },
      "privacy_level": "public"
    }
  ],
  "custom_fields": {
    "workspaceId": ""
  },
  "public_jwk": {},
  "https://purl.imsglobal.org/spec/lti-tool-configuration": {
    "title": "Nectir AI",
    "description": "Nectir is an instant messaging tool built for classroom communication. With this app, Nectir will auto-create all of your class channels and auto-add all of your students and TAs. Easily disseminate info to everyone at once and reduce your email inbox load, while allowing students to ask and answer their own questions. Nectir creates a powerful network effect across your campus by placing all created channels in one workspace so students have all their classes in one place.",
    "public_jwk_url": "https://ai.nectir.io/api/lti13/keys",
    "target_link_uri": "https://ai.nectir.io/api/lti13/validate",
    "display_type": "full_width_in_context",
    "oidc_initiation_url": "https://ai.nectir.io/api/lti13/login",
    "domain": "https://ai.nectir.io",
    "custom_parameters": {},
    "messages": [
      {
        "type": "LtiDeepLinkingRequest"
      },
      {
        "type": "LtiResourceLink"
      }
    ]
  }
}
  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.
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.

Instructor Setup Guide

After completing the LTI integration setup in the preceding section, instructors can follow the Canvas Workspace Setup guide to:
  • Link their Canvas courses to Nectir Groups
  • Configure role mapping
  • Set up roster sync
  • Manage courses across terms

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