Introduction
This guide will walk you through how to use the Setup Wizard to integrate FeedbackFruits with your learning management system, Canvas. This guide is intended for site admins and IT personnel - if you do not have the permissions to access your LMS admin environment, you will not be able to use the Wizard, so please ensure you have the appropriate permissions before starting the setup process.
It’s important that you reach out to your Partner/Pilot Manager at FeedbackFruits before using this Wizard so they can support your implementation.
Getting Started
To begin, please select your LMS from the list:
If your LMS is not listed here, please refer to our other setup guides in our Help Centre: Integrating FeedbackFruits With Your LMS
Step 1: Setup LTI Integration
Each step in the Wizard has the appropriate instructions added - please read the given instructions carefully as you proceed through the steps.
Select which registration type to follow, whether Inherited key or Dynamic.
Please follow the instructions in the Wizard to turn on the corresponding FeedbackFruits developer key in your Canvas environment.
Add the new application to your Canvas environment within the admin tab.
Set configuration type by clicking copy client ID - once copied, please insert it in the corresponding field in your Canvas environment.
Within the Canvas environment, hit submit.
In Canvas environment copy the Deployment ID as shown at the screenshot and paste it into the Deployment ID field.
Within the environment, fill in the required information to register:
Environment Name: The distinct designation of your institution, along with any additional identifiers that will help distinguish this environment from others, especially if you manage multiple environments.
Canvas URL: The primary domain URL where you access your institution's resources and services.
Contact Information: The name and email address of the designated representative who can be reached for any technical inquiries related to your integration.
Important:
If you have multiple roles in the Canvas course (e.g., both "Teacher" and "Student"), this can cause unexpected issues when setting up or testing FeedbackFruits tools. We recommend using a single role, ideally the Teacher role, when configuring the tool to ensure everything functions correctly.
Step 2: Verify LTI Integration
This step aims to confirm a successful integration between FeedbackFruits and LTI. The most effective way to verify this is by adding a FeedbackFruits item to a course within your Canvas environment. You can use an existing sandbox course to test or create a new one as needed.
For detailed instructions on how to add a FeedbackFruits tool, please refer to the following guide: Adding a FeedbackFruits Tool in Canvas.
Once you have successfully added the FeedbackFruits item to your course, please follow the instructions provided in screenshot below and use the Detect Launch button to complete the verification process.
This step checks the API integration with your LMS; it is important that this step is completed to provide a better experience for teachers.
To learn more about why we check the API integration, please read the following article: API Primer
Please select your registration type (this is the same as you selected in step 1):
Within your Canvas environment, enable Developer Key following the instructions from the screenshot below:
Once you’ve completed the previous step, click Enable API.
If API was enabled successfully, you will see a confirmation message (shown in the below screenshot). If you don’t see this confirmation message, or run into any other issues, please contact FeedbackFruits support team via integrations@feedbackfruits.com.
Step 4: Verify API Integration
This step is necessary to connect your FeedbackFruits account with the correct permissions within your Canvas account.
When you click Continue to Permission you will be redirected to the Canvas environment to grant these permissions - you can see the required permissions in the below screenshot.
Click Authorize here to grant the required permissions.
Congratulations - at this point, your setup is successfully completed and you can start using FeedbackFruits within your Canvas integration!