When the widget option is used, the Agent Application is directly embedded into a host application (e.g., Jacada WorkSpace). The source code of the widget is included in the host page.
The first step of integration involves constructing an iframe element that will create an embedded widget suitable for the application. The parameters that define the widget's settings are passed in the src property of the iframe. Available parameters are listed in the following table.

Parameter NameDescriptionDefault Value
The location of the widget, which is also the location
of the Jacada Interaction Server. For example:
showSearch Determines whether the Search tool is shown or hidden. false
Indicates whether the application's settings are based on an embedded or a standalone design. In the embedded design, some application features (e.g., the search box) are hidden. false
The absolute or relative name of the theme
or jQueryUI theme file. If another theme is defined
for the application in the Admin Console, the theme parameter will be overridden.
Unique identifier for the application. This parameter is required.  
Identifier for the tenant's account. This parameter is required.  
Determines whether Interactions are openedin new tabs. true
Determines whether the area showing data relevant to the customer or the system is shown or hidden.  false
showAddNote Determines whether the Add Note link that enables the agent to insert notes is shown or hidden.  
interaction The Designer ID of the Interaction that starts running when the client is loaded. If this parameter is not provided, a list of Interactions is displayed.  
The authentication token passed by the Authentication Server, for access to secured Interactions.  
lang Language locale. This parameter overrides the default language of the browser.  

The following example shows an iframe element that will create an embedded widget suitable for the Agent application:

<iframe type="text/html" width="100%" height="100%" 
&lang=en wmarginheight="0" marginwidth="0" frameborder="0" style="border: none;”>

For details about embedding the widget in the host application, refer to Creating the Host Page.