Speechace Speaking Test
  • Speechace speaking test documentation
    • Use cases
    • Test development
    • Test reliability
    • Test customization
    • Audio/Video recording
    • Usage with children
    • Usage and demographics
  • Getting Started
    • Sign up and create a workspace
    • Invite team members
    • Create an assessment
      • Clone from Library
      • Assessment with custom questions
    • Invite test takers
    • Review Reports
  • Speechace Workspaces: create, manage, and share speaking assessments
    • Create multiple workspaces
    • Switch between workspaces
    • Collaborating in a Workspace
      • Invite team members to a workspace
        • Accept a workspace invitation
      • Role-based access
    • Creating Assessments
      • Clone Assessments
        • Cloning from the Library
        • Clone a single assessment
      • Create new custom assessments
        • Select avatar and language
        • Custom assessment configurations
          • Configuration panel
          • Types of questions
            • Open-ended
            • Read-aloud
            • Task Achievement
            • Record Only
            • Writing
              • Describe image
              • Essay Writing
          • Weights, Max Scores, Timers
      • Rubrics (supported+default)
      • Audio or video assessment
      • Score settings
    • Manage existing assessments
      • Invite test-takers to take an assessment
      • Review scores
      • Edit assessment configurations
      • Edit assessment questions
      • Set up email notifications for completed tests
      • Clone an existing assessment
      • Move an assessment
      • Delete an assessment
      • Add more activities within an existing assessment
    • Customize avatars
      • Edit Avatar
        • Versioning
        • Change avatar and language
        • Edit avatar narration
        • Change Avatar Background
        • Upload Custom Videos
      • Generate avatar
      • Apply avatar
    • Manage tags of assessment results
      • Add new tags
      • Edit or Delete tags
    • Sharing individual activities within an assessment with test-takers
    • Sharing assessments with candidates
    • Inviting candidates to take an assessment
    • Usage tracking
    • Upgrade your plan
    • Embedding assessments in other apps and websites
      • oEmbed integration for Speechace speaking test
        • Receiving test results on specified callback
          • Results callback to 3rd party application backend
            • Export report in json
          • Test completion notification to 3rd party app front-end
      • iframe integration for Speechace speaking test
  • Detailed test report
  • Test taker guide
    • Test-taker's view of Scores
Powered by GitBook
On this page
  • Overview
  • iframe integration steps
  1. Speechace Workspaces: create, manage, and share speaking assessments
  2. Embedding assessments in other apps and websites

iframe integration for Speechace speaking test

PreviousTest completion notification to 3rd party app front-endNextDetailed test report

Last updated 1 month ago

Overview

can be integrated in to existing websites, blogs or web-pages using simple iframe integration which requires no coding. This is very similar to how Youtube allows embedding video content in to other websites. However note that this is an insecure option and should only be used for piloting the speaking test with your audience. Once you expose the iframe, malicious users can copy the iframe and reuse it in their own websites, however any test usage will be accrued to your billing account. Therefore please be very careful as you use this option for piloting the speaking test.

iframe integration steps

a. First of all create an assessment in your workspace by either or creating a . Let's say, I created a new Call center LV-426 test as shown below.

b. Now click on the Share Assessment icon

c. Now, you should see the Share Assessment panel pop up as below. Once the popup is available, please click on the oEmbed tab:

d. Now click on the Get iframe HTML button and copy the iframe code:

e. Now you can create an HTML file and put the iframe code in the HTML as shown in the below sample:

<html>
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
  </head>
  <body style="margin: 0; overflow: hidden">
    <iframe width='100%' height='100%' allow='camera;microphone' src='https://speak.speechace.co/embed/ui/108?speechace_token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjb25zdW1lcktleSI6IklsWXExendwTXJDYVVBVzMiLCJ1c2VySUQiOiJhdXRvIiwiZXhwIjoxNjgzOTM4NzcxLCJpc3MiOiJzcGVlY2hhY2UiLCJjb3Vyc2VJZCI6MTA4LCJxdWl6SWQiOm51bGx9.imYdt7ShS-lKXCY0okAtfewKRX0zp7B2-f4S5HOMvrA'>
   </iframe>
  </body>
</html>

f. Now if you launch the HTML, you should see the test launch in an iframe as below:

g. Note that in this case, the user identity is not known so you will not be able to see any identifiable user details in the management pane. Instead once the test is complete, you should see an obscure user id in the management pane results as below:

Speechace's speaking test
cloning
custom assessment