Speak AI embeds are designed to work seamlessly within your existing pages. While they function independently, you can enhance their behavior and control their initial state using simple URL parameters. This allows you to tailor the playback experience directly from the page where the embed is hosted.

For more advanced control, such as pausing or playing the embed from your parent page, you can leverage JavaScript messaging. This provides a way to communicate with the embed and react to key events like when the player is ready or when playback has finished.

You can customize the initial state of a Speak AI embed by adding specific parameters to its URL. These parameters allow you to control aspects like automatic playback, starting at a particular time, or hiding the visual waveform.

For more dynamic control, the embed can send messages to its parent page using JavaScript's postMessage API. These messages inform your page when the player is ready or when playback has completed. To ensure these messages are received, your website's domain must be whitelisted in the recorder settings if security policies are active.

To access this feature, go to Side Navigation → Surveys in your dashboard.

You can append the following parameters to your embed URL to control its initial state:

The embed may emit the following postMessage events for advanced control:

Ready to get started?

Need help? Contact our support team or check out our other guides.