Instructors want course evaluations without leaving your LMS. Give them a survey tool for every course.

1. Step 1

   Instructors get a workspace for their course

   When an instructor opens the course’s surveys tab, your backend signs the course as the subject, together with the instructor and what they may do. Everything they create is filed under that course.

   server/course-surveys.ts

   const res = await fetch('https://api.responsedock.com/api/v1/auth/embed-token', {
     method: 'POST',
     headers: {
       Authorization: `Bearer ${process.env.RESPONSEDOCK_SECRET_KEY}`,
       'Content-Type': 'application/json',
     },
     body: JSON.stringify({
       workspaceId: process.env.RESPONSEDOCK_WORKSPACE_ID,
       role: 'admin',
       mode: 'workspace',
       allowedOrigin: 'https://lms.yourplatform.com',
       tenant: { id: school.id, name: school.name },
       user: { id: instructor.id, name: instructor.name },
       capabilities: ['questionnaire:create', 'questionnaire:edit',
         'questionnaire:publish', 'results:view'],
       subject: { type: 'course', id: course.id, label: course.title },
       theme, // parsed from your version-controlled theme file
     }),
   });
   const { embedUrl } = await res.json(); // { token, expiresIn: 300, embedUrl }
   // In the iframe page, file each new survey (blank or from a template)
   // under the course: 'responsedock.survey.created' → event.data.survey.id

2. Step 2

   Learners answer on the last course page

   At the end of the course, request a respondent embed signed with the learner’s ID; with the “one per external user ID” rule, each learner answers once. Or send track('course_completed') with the browser SDK and let a trigger rule open the survey in a modal, or email the cohort from your dashboard.

   server/course-complete.ts

   const { embedUrl } = await fetch('https://api.responsedock.com/api/v1/auth/embed-token', {
     method: 'POST',
     headers,
     body: JSON.stringify({
       workspaceId,
       role: 'respondent',
       surveyId: course.evaluationSurveyId,
       allowedSurveyIds: [course.evaluationSurveyId],
       externalUserId: learner.id,
       allowedOrigin: 'https://lms.yourplatform.com',
     }),
   }).then((res) => res.json());

3. Step 3

   A signed webhook reports each completed response

   Subscribe a webhook to survey.response.completed. Verify the signature and timestamp, then mark the evaluation or knowledge check as done for that learner. The payload carries the learner’s ID, the answer count and, for quizzes, the score and pass result, never the answers themselves.

   server/responsedock-webhook.ts

   import { createHmac, timingSafeEqual } from 'node:crypto';
   
   const secret = process.env.RESPONSEDOCK_WEBHOOK_SECRET;
   const ts = Number(req.headers['x-responsedock-timestamp']);
   const expected = 'sha256=' + createHmac('sha256', secret)
     .update(`${ts}.${rawBody}`).digest('hex');
   const received = String(req.headers['x-responsedock-signature-v2'] ?? '');
   if (Math.abs(Date.now() - ts) > 5 * 60_000 || received.length !== expected.length
     || !timingSafeEqual(Buffer.from(received), Buffer.from(expected))) {
     return res.status(401).end();
   }
   
   const { event, data } = JSON.parse(rawBody);
   if (event === 'survey.response.completed' && data.externalUserId) {
     await markCourseTaskDone({
       learnerId: data.externalUserId,
       surveyId: data.surveyId,
       completedAt: data.completedAt,
     });
   }

Read the course evaluations guide →