Embed a Live App

This guide outlines the process for embedding a WisdomAI Live App into your application. Before proceeding, make sure you’ve reviewed the Embeddings Overview for authentication setup and security requirements.

​

Construct the embed URL

Construct the embed URL for your Live App and append the JWT you generated in the authentication stage.

1. Take your original Live App URL and insert /embed/ before the app’s name and ID.
2. Append the JWT as a token query parameter. The URL should look like the following:
   • Original URL: https://<customer>.wisdom.ai/apps/name-id
   • Final embed URL: https://<customer>.wisdom.ai/apps/embed/name-id?token=<JWT>
3. Use this URL as the src for an <iframe> in your application:
   <iframe
     src="https://<customer>.wisdom.ai/apps/embed/name-id?token=<JWT>"
     allow="microphone; camera; clipboard-write"
     style="width: 100%; height: 100%; border: 0;"
   ></iframe>
   

The allow attribute enables voice input, camera, and clipboard features in the embedded interface. See Embedding Modes for details.

​

Controlling edit permissions with RBAC

Embedded Live Apps reflect the user’s RBAC role. To hide edit controls and prevent modifications in your embedded view, assign the user the Viewer role when creating them. There is no separate embed-specific parameter for this. See RBAC for Embedded Users for instructions on assigning roles and a full breakdown of what each role controls in the embedded interface.

​

Validation

To validate that the process worked, open the final embed URL in your browser. The Live App should load without prompting for a login. If you encounter an error, see Error Handling.

​

Next steps