Skip to main content

​
Who this guide is for

This guide is written for instructional designers and L&D teams who build courses in tools like Articulate Rise, Cornerstone, Moodle, or Canvas. You do not need to be a developer to embed a roleplay. Most of the work is copy-paste from Real Talk Studio into your course. If you need scores to flow automatically into your LMS gradebook, your IT or LMS administrator (or a tool like Zapier) will handle that part — we explain what to ask them for below.

​
The big picture

Real Talk Studio does not replace your SCORM course. You keep your existing slides, videos, and quizzes. You add AI roleplay practice at the points where learners need to apply what they have learned. How it appears in the course: Real Talk Studio opens inside a page in your LMS — like embedding a YouTube video, but interactive. Learners stay in your course; they do not need a separate Real Talk Studio login for embedded sessions.
There is no standalone SCORM file for the roleplay itself. You paste an embed code (provided by Real Talk Studio) into an Embed or HTML block in your authoring tool. Enterprise customers can discuss custom SCORM packaging with their account team.

​
Quick start: add a roleplay to your course

1

Create the roleplay in Real Talk Studio

Build your scenario, personas, and skills in your studio as usual. Name skills clearly — they appear in feedback and exports (e.g. “Active listening”, “Handling objections”).
2

Copy the embed code

Open the roleplay in your studio → Embed Code tab → choose LMS / Rise → copy the iframe code.
3

Paste into your course

In Rise: add an Embed block. In other tools: use Custom HTML or iFrame where available. Paste the code. Set the block height to at least 800px (900–1000px works well on some themes).
4

Add a short intro for learners

On the slide before the roleplay, tell learners they will need microphone access (and camera if your scenario uses video). Link to Troubleshooting if your organisation uses strict corporate networks.
5

Publish and test

Publish the course and complete a test run yourself. Confirm the avatar loads, audio works, and feedback appears at the end.
In Articulate Rise, use the Embed block type — do not paste the URL alone. The full iframe code is required.

​
Where to place roleplays in a programme

You can embed roleplays anywhere it helps learning:
  • Before training — diagnostic conversation to see where someone starts
  • After a module — short practice applying one skill
  • At the end — summative assessment using the same scenario as the start (to measure improvement)
Align the skills you configure in Real Talk Studio with the learning objectives on each module. When skill names match your curriculum, reporting and any future automation are much easier. Rough timing: diagnostic or summative roleplays often need 8–15 minutes. Short practice sessions can be 5–8 minutes with fewer skills.

​
Getting results out: two ways

Every session is saved in Real Talk Studio. You choose how to use that data.

​
Option 1 — Download a spreadsheet (easiest)

Best for: pilots, manager reviews, compliance records, programmes where the LMS does not need live scores. No technical setup. Anyone with admin access can:
  1. Open your studio in the Real Talk Studio admin portal
  2. Go to Session history
  3. Filter by date or roleplay
  4. Click Download CSV
The file includes date, roleplay name, score, skill ratings, session length, and learner email (when available). If your IT team added a learner reference ID (see below), it appears as External Customer ID. You can open the CSV in Excel, share it with stakeholders, or import it into your LMS reporting on a schedule that suits you.

​
Option 2 — Automatic delivery (webhook)

Best for: updating an LMS gradebook automatically, routing learners to different modules based on scores, or pushing results into another system without manual exports. A webhook is an automatic notification Real Talk Studio sends to a web address when someone finishes a roleplay. That address is usually set up by your IT team or using a no-code tool like Zapier or Make. What you need to do in Real Talk Studio admin:
  1. Open your studio → Settings
  2. Paste the webhook address your IT team gives you into Webhook URL
  3. Save
Full technical details (what data is sent, example setups) are in Webhook config — share that page with your IT contact.
You do not need a webhook for most programmes. CSV export is enough unless you specifically need scores in the LMS the moment a session ends.

​
Linking results to the right learner

If many people use the same embed link, you may want each completion tied to a specific learner in your LMS. Your IT or LMS team can add a learner reference to the embed link when the course launches. In Real Talk Studio this is called extCustId (external customer ID). It is usually the LMS user ID or enrolment ID — not the learner’s email in plain text. You will see the same reference in:
  • The External Customer ID column when you download CSV
  • Automatic webhook deliveries (if configured)
Ask your IT team: “Can we pass our LMS learner ID into the Real Talk Studio embed URL as extCustId?” Details for them are in Webhook config.

​
Who does what

Share Firewall configuration with IT if learners on office networks have connection issues.

​
Platform tips

If your LMS must mark the activity complete in the gradebook when the roleplay finishes (not just when the learner clicks Continue), that usually requires extra setup by your IT team — see For your IT team below.

​
Checklist before launch

  • Roleplay skills match module learning objectives
  • Embed block is tall enough (800px+)
  • Intro slide mentions microphone (and camera if needed)
  • You completed a full test session in the published course
  • You know whether you are using CSV export or asked IT to set up a webhook
  • Corporate learners: IT has reviewed firewall requirements if needed

​
For your IT team

The sections below are for LMS administrators, developers, or integration partners. Instructional designers can share this page and point them here.
Each roleplay exposes an iframe embed from Embed Code → LMS / Rise. The iframe must include microphone and camera permissions:
Optional URL parameters: primaryColor, fontFamily, buttonRadius, language / lang, extCustId, parentDomain. Restrict embed domains under Studio → Security → Allowed domains. See Organization & studio permissions.
Configure Webhook URL in studio Settings. Real Talk Studio POSTs JSON on completion; all fields are nested under data. See Webhook config for the full payload, field reference, extCustId behaviour, and example receivers (Zapier, Node.js, Postgres).Webhooks are optional — session data is always available via Session history → Download CSV.
After feedback loads, the embed notifies the parent frame:
A SCORM wrapper can listen and set cmi.core.lesson_status to completed. Validate event.origin in production. postMessage signals completion only — scores travel via webhook or CSV, not postMessage.Some platforms (e.g. Evolve LMS) use MessageChannel; the embed also exposes window.notifyAssessmentCompleted().
Real Talk Studio does not assign LMS pathways directly. To route learners by weak skills, a webhook receiver should store skillsFeedback and extCustId, apply mapping rules, and write back via the LMS API.To compare pre- and post-training scores for the same learner, store the first completion keyed by extCustId + roleplaySlug and diff when the second arrives. Embedded sessions do not use the in-app “previous score” API — comparison happens in your systems.
  • Option A (recommended): iframe inside existing SCORM / Rise — instructional designer pastes embed code.
  • Option B: standalone LMS activity with the same iframe — roleplays updatable without republishing SCORM.
  • Option C: custom SCORM wrapper around the iframe for strict completion tracking — requires authoring/dev work.
xAPI and LTI are not standard today; webhooks + extCustId are the supported integration path. Enterprise custom integrations available on request.

Webhook config

For IT: automatic score delivery, learner ID (extCustId), and Zapier-style setups.

Firewall configuration

For IT: network requirements on corporate Wi‑Fi.

Troubleshooting

Microphone, browser, and connection issues inside the course.

Organization & studio permissions

Studio access, credits, and allowed embed domains.

​
FAQ

Not for a basic embed. If you paste the embed code and download CSV for reporting, you can launch without IT. Involve IT if you need learner IDs on every session, automatic gradebook updates, corporate firewall access, or SCORM completion to fire automatically.
No. Webhooks are optional. CSV export from Session history includes scores, skills, and session details. Use a webhook only when results must flow into another system immediately.
Not as a standard download. You embed Real Talk Studio inside your existing SCORM course. Enterprise customers can discuss custom SCORM packaging.
Not directly from Real Talk Studio. The roleplay shows feedback to the learner inside the embed. To change LMS pathways automatically, IT needs to receive scores (webhook or CSV import) and apply rules in the LMS.
They see full feedback for the session they just completed. Comparing an earlier diagnostic to a final assessment is something you build in reporting — export CSV or ask IT to store webhook history — unless you surface it in a custom LMS page.
Very short sessions may be flagged as too short to score. Treat these as incomplete and ask the learner to try again with a fuller conversation.