# iframe integration for Speechace speaking test

### Overview

[Speechace's speaking test](https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/embedding-assessments-in-other-apps-and-websites/www.speechace.com/speaking-test) 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. *<mark style="color:red;">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.</mark>* 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 [cloning](/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/clone-assessments.md) or creating a [custom assessment](/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/creating-assessments/create-new-custom-assessments.md). Let's say, I created a new Call center LV-426 test as shown below.

<figure><img src="/files/DFazAO3XB7nZCeSVrzQh" alt="" width="375"><figcaption></figcaption></figure>

b. Now click on the Share Assessment icon

<figure><img src="/files/rLTwifhY5szD7WfViKvX" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/cAoo9quTmTwHECtAyt7K" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/mCA7vl18hdmLbUAGARKV" alt="" width="375"><figcaption></figcaption></figure>

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

{% code overflow="wrap" %}

```html
<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>
```

{% endcode %}

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

<figure><img src="/files/Ssavbdt5wBQgHdyIjieY" alt="" width="375"><figcaption></figcaption></figure>

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:

<figure><img src="/files/eNG5xOhu7VziZkFi8Dvy" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://speaking-test-docs.speechace.com/speechace-speaking-test/speechace-workspaces-create-manage-and-share-speaking-assessments/embedding-assessments-in-other-apps-and-websites/iframe-integration-for-speechace-speaking-test.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
