Skip to main content
Updated in 2026.21
Copilot HTML Tile Node configuration panel

Description

This Node displays HTML content in the Agent Copilot workspace. You can design custom layouts to present information to a human agent. HTML content may include text, images, videos, links, and scripts. The Set HTML Tile Node is useful for displaying complex information. Technically, the HTML content will be injected into an iFrame on the workspace side, so any general restrictions on iFrames also apply to this case.

Parameters

Using React or Angular

In the Copilot: HTML Tile Node, you can enhance your HTML content by utilizing the React or Angular libraries. These libraries allow you to seamlessly display dynamic widgets within your workspace. To use these libraries in the Copilot: HTML Tile Node, you need to include them in your HTML code.

Receiving JSON Data from the Flow

When you use a Copilot: HTML Tile, JSON data is passed into the HTML code using the postMessage method. To receive and process the passed JSON in your widget, add an event listener into the Copilot: HTML Tile Node and handle the data accordingly.

Send JSON Data Back to the Flow

You can send data back to the Flow by using the Postback feature.
The Postback feature allows you to send data either back to the Flow or chat, or directly to the widget interface. This feature can be useful for updating the state of your widget based on human agent interactions. These interactions can include actions such as submitting forms, updating display elements, or notifying the system of changes made by the human agent.The Postback feature can be configured in the following ways:
  • Using SDK.postback
  • Using the Copilot: Send Data Node
Using SDK.postbackFollow these steps to implement postback for your widget:
  1. Add the SDK.postback function to the HTML page. Make sure this code is included after the SDK script is loaded:
  1. Click the button in the widget in the Agent Copilot workspace. Triggering this action will send an injected message formatted as follows:
To allow human agents to view this object, add {{ input.data._cognigy._agentAssist }} to the Text field in the Say Node of your Agent Copilot Flow. This Node should be placed below the Node with the SDK.postback function. The output will be available in the chat message and visible only to human agents.ExampleIn this example, the SDK.postback function sends the value of name back to the user. If name is falsy, meaning the user did not enter a name, the else block is executed, and the function calls setMessage('Please enter your name.');. This message will appear in the widget, prompting the user to provide their name and reminding them of the required input.
Using the Copilot: Send Data NodeIn the Agent Copilot Flow, below the Copilot: HTML Tile Node, add a Copilot: Send Data Node. In the JSON field of the Copilot: Send Data Node, specify the parameters you want to pass as metadata to the Copilot: HTML Tile Node to update the content.

End Agent Copilot Session

Use the SDK.endSession function to end an Agent Copilot session that stays open after the human agent resolves the conversation.
The SDK.endSession function applies only when End Session On Handover Close is deactivated in the Copilot section of the Endpoint settings.The function takes no arguments. If you call it while the handover is still active, the session isn’t ended.ExampleIn this example, the Submit button sends the entered text to the Agent Copilot Flow with SDK.postback, and the End session button ends the open session with SDK.endSession. The function returns a Promise, so the widget can show whether the Agent Copilot workspace accepted or rejected the request.
To display a reply from the Agent Copilot Flow in the widget, use a Copilot: Send Data Node below the Copilot: HTML Tile Node.

More Information

Last modified on October 12, 2026