# Install Embedded Chatbot

The **Embedded Chatbot** allows you to place your chatbot directly inside any webpage using a simple HTML `<iframe>` snippet. This is ideal for dashboards, support pages, or custom layouts where you want the chatbot to appear inline.

### Access the Embedded Chatbot Installation

1. Log in to your **BotPenguin Dashboard**.
2. Click on Bots from left menu then Select the bot.

<figure><img src="/files/oa0b9xkyL2dQTEpvmNQK" alt=""><figcaption></figcaption></figure>

3. Now click on **“Install Your Chatbot.”**

<figure><img src="/files/217TVNbAGYBDZ983OBsj" alt=""><figcaption></figcaption></figure>

4. Select the **Embedded Chatbot** tab from the top menu.

<figure><img src="/files/EGDBJiX5g27YFVnoHdVE" alt=""><figcaption></figcaption></figure>

You will see the installation options for embedding your chatbot into a website.

***

### Get the Installation Code

In the **Get Chatbot Installation Code** section:

1. Copy the iframe code provided.
2. This code is unique to your chatbot.

Example:

```html
<iframe 
  src="https://page.botpenguin.com/XXXXXXXXXXXX" 
  width="100%" 
  height="600" 
  frameborder="0">
</iframe>
```

> 💡 **Tip:** You can adjust the `width` and `height` values to match your page layout.

***

### Add the Code to Your Website

Paste the copied iframe code into the HTML of every page where you want the chatbot to appear.

**Common placements include:**

* Inside the `<body>` tag
* Within a specific container or section
* Embedded inside CMS editors (WordPress, Webflow, etc.)

> ⚠️ Make sure the page allows iframes and does not block third-party embeds.

***

### Share Installation Code with Your Developer (Optional)

If a developer manages your website:

1. Enter their email address in the **Share Installation Code** section.
2. Click **Send Email**.

The developer will receive the installation instructions directly.

***

### Request BotPenguin Installation Support

If you prefer hands-on assistance:

1. Click **Help me in Installing ChatBot**.
2. The BotPenguin support team will handle the installation for you.

***

### Verify the Installation

Once added:

* Reload your webpage
* Confirm the chatbot appears correctly
* Test a conversation to ensure it responds as expected

***

### Troubleshooting

If the chatbot does not appear:

* Confirm the iframe code is pasted correctly
* Check that your website allows external embeds
* Ensure no ad blockers or CSP rules are blocking the iframe

### FAQ's

Here are some common questions asked regarding training with FAQ's:

<details>

<summary>Do I need coding knowledge to install it?</summary>

No. If you can copy and paste HTML code, you can install the embedded chatbot. For advanced customization or CMS setups, a developer may help

</details>

<details>

<summary>Where can I embed the chatbot?</summary>

You can embed the chatbot on:

* Any HTML webpage
* Dashboards or internal tools
* CMS platforms like WordPress, Webflow, or Wix
* Customer support or help pages

</details>

<details>

<summary>Can I change the size of the embedded chatbot?</summary>

Yes. You can modify the `width` and `height` values in the iframe code to fit your page layout.

</details>

<details>

<summary>Will the chatbot work on mobile devices?</summary>

Yes. The embedded chatbot is responsive and works on mobile devices as long as the iframe is placed inside a responsive container.

</details>

<details>

<summary>Can I embed the chatbot on multiple pages?</summary>

Absolutely. You can use the same iframe code on as many pages as you want.

</details>

<details>

<summary>Can I send the installation code to my developer?</summary>

Yes. Use the **Share Installation Code** option to email the iframe code directly to your developer.

</details>

### Support

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.botpenguin.com/bots/website-mobile-app-bot/bot-setup-and-installation/install-your-chatbot/install-embedded-chatbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
