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.

Configuring Nectir AI

  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 found at the bottom of this document
  4. Click Save
  5. Edit the key you’ve just created, and input the following information:
    • Key Name: Nectir AI - Key

    • LTI Advantage Services: Ensure all services are selected

    • Additional Settings > Custom Fields: workspaceId=YOUR_WORKSPACE_ID

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

  6. Save the key and enable it with the State toggle
  7. Copy the Client ID under the Details column (for example, “532080000000000615”)

Please share this client key with the Nectir Staff member helping you implement your integration

  1. With the copied key, go to Admin > Settings > Apps > View App Configurations
  2. Select + App and then select Configuration Type > By Client ID
  3. Paste the Client ID of your configured developer key for Nectir
  4. Select Install
  5. Done. Now a Nectir Staff member has to enable the integration

Linking Nectir AI to Your Canvas course

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 Enable

Alternatively, 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

After saving, you may need to refresh your page to see the changes

6

Launch Nectir AI

Nectir AI will now appear in your course navigation menu in the left sidebar

Click 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

Linking your Canvas course to a Nectir AI Group

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.

Troubleshooting

If the Nectir AI tool doesn’t appear in your course navigation:

  • Verify that the Developer Key is set to “On” in the admin panel
  • Reload the page
  • Check that the correct Client ID was used when adding the app to your course
  • Contact your Nectir AI account manager for additional support at support@nectir.io

JSON 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",
  "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"
      }
    ]
  }
}