> For the complete documentation index, see [llms.txt](https://docs.borndigital.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.borndigital.ai/digital-agent/chat-bubble.md).

# Chat bubble

The DA Bubble – the chat window of your agent on a web page: design it, deploy the agent to it, embed it, and hand chats over to human operators.

The **DA Bubble** is the chat window your customers use on your website. It can also offer a voice conversation and a talking avatar. One bubble shows one deployed version of your project.

1. **Design the bubble** in **Organization** › **Bubble design** – modes, colours, texts and timers. See [Bubble design](https://docs.borndigital.ai/digital-agent/chat-bubble/bubble-design.md).
2. **Deploy the agent to it** – in the [Deploy dialog](https://docs.borndigital.ai/digital-agent/workspace/deploy-project.md), choose the bubble in **Assign Bubbles**.
3. **Embed it** – copy the **Deployment script** of the bubble and paste it into your web page.

The whole procedure, step by step, is in [Step 6 of the tutorial](https://docs.borndigital.ai/digital-agent/building-new-projects/step-6-put-the-agent-on-your-website.md).

## Embed the bubble

After the bubble is deployed, the **Set-up** tab of Bubble design shows the **Deployment script** section. Click **Copy** and paste the script into the HTML of your page, just before `</body>`:

```html
<script src="https://<your-studio-address>/da-bubble/bubble.js" type="module"
        id="born_digital.bubble-script" data-client-id="<your-bubble-id>"></script>
```

The script stays the same when you deploy a new version of the agent or change the design.

To try the bubble before you embed it, click **Test** in Bubble design – it opens the deployed bubble in a new tab.

## What the bubble can show

* **Formatted messages** – Markdown, links, images and videos. See [Customizing text output](https://docs.borndigital.ai/for-advanced-users/conversation-design-tips/customizing-text-output.md).
* **Chat buttons** – see [Implementing chat buttons](https://docs.borndigital.ai/for-advanced-users/conversation-design-tips/implementing-chat-buttons.md).
* **Widgets** – forms, ratings and more. See [Widgets](https://docs.borndigital.ai/digital-agent/advanced-functions/widgets.md).
* **File upload** – turn on **File upload** in the Answer node's **Chat features** and **Attachments** in Bubble design.

## Hand a chat over to a human

A chat can be handed over to a human operator in your contact-centre or chat platform. The integration – for example Sprinklr, Genesys Cloud, Daktela or mluvii – is set up by Born Digital for your organization, together with the variables your flow uses to start the handover.

* In the flow, lead the conversation to the node where the handover starts – for example with the **Redirect to human** tool of the [AI node](https://docs.borndigital.ai/digital-agent/conversation-flow/nodes-explained/ai-node/tools.md).
* In the bubble, the operator's messages are shown with a person icon instead of the assistant image, and the customer sees when the operator is typing.
* When the customer ends the conversation or the [conversation timeout](https://docs.borndigital.ai/digital-agent/chat-bubble/bubble-design.md#global-chat-timing) runs out, the live chat ends too. **Restart** starts a new conversation with the agent.
