> For the complete documentation index, see [llms.txt](https://speaking-test-docs.speechace.com/speechace-speaking-test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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/custom-assessments.md). Let's say, I created a new Call center LV-426 test as shown below.

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

\
b. Now click on the Share Assessment icon

<figure><img src="/files/NU7r5a1rPc9hWQbZu29m" 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/0GHHWLyCsTNNlxMcIB0d" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
