> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/ai-agents/creating-ai-agents-in-botpenguin/social-media-widgets/instagram-widget.md).

# Instagram Widget

This section contains essential information and usage guidelines for managing Widgets inside BotPenguin.

### What is Widgets?

Widgets are routing tools that redirect users directly to your Instagram bot with a single click or scan. They allow you to connect Instagram automation with external touchpoints like websites, emails, and print materials, and help you increase bot usage while reducing friction to start a conversation.

***

### When should you use this?

Use this feature when:

* You want to drive users from external channels (website, email, print, social bios) straight into an Instagram bot conversation
* You need a low-friction way for offline audiences to start chatting with your bot
* You are trying to connect Instagram automation with marketing touchpoints like ads, landing pages, or physical assets

***

### Benefits of Widgets

* 🚀 Helps you increase Instagram bot engagement
* ⏱️ Reduces the number of steps users take to start a conversation
* 🎯 Improves conversion from external channels into active chats
* 🔄 Ensures a consistent entry point across online and offline touchpoints
* 📈 Enhances overall reach of your Instagram automation

***

### Expected Outcome

After setting this up:

* Your Instagram bot will be reachable via a chatbot icon, direct link, or scannable QR code
* You will notice more conversations started from external sources like websites, emails, or printed material
* Users will experience instant, one-click access to your bot instead of manually searching for your account

{% hint style="info" %}
**Tip**: Place the widget where users are most likely to need instant support or information.
{% endhint %}

***

### Before You Begin

The Instagram channel must be installed for your agent before you can generate any Instagram widget.

* If Instagram isn't installed yet, the Widgets page will show **"Instagram Integration Required"** with an **"Install Instagram"** button instead of the widget options.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FfWBI2XLfZFM3yMKzHp6a%2Fimage%20(7).png?alt=media&amp;token=437d5ea2-e8ab-4521-8b26-fb5ce58ed15f" alt=""><figcaption></figcaption></figure>

* Clicking **"Install Instagram"** takes you to the **"Install Agent"** screen, where you can choose **"Instagram"** under Social Platforms and complete the connection.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FU2GF00PBN0N5qnIkjwGC%2Fimage%20(8).png?alt=media&amp;token=34fed0d9-5d5e-485d-a70d-32c0c12c8756" alt=""><figcaption></figcaption></figure>

***

### How to Access Widgets

1. Go to the **"AI Agents"** section from the left sidebar.
2. Select your agent, then scroll to **"Other Tools"** and click **"Social Media Widgets."**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FDbef3A4I2OzkTQAxYH7D%2Fimage%20(9).png?alt=media&amp;token=8ac44f45-5375-4691-94e9-4c109ade40c6" alt=""><figcaption></figcaption></figure>

***

### Available Widgets

#### 1. Agent Icon Widget

The Agent Icon Widget installs a chatbot icon directly on your website that opens a conversation with your Instagram bot when clicked.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FJFaQzwE3iMbkHG7wRefC%2Fimage%20(10).png?alt=media&amp;token=50fcb9c5-60d1-4699-b9df-907d8ecf2365" alt=""><figcaption></figcaption></figure>

**How It Works**

* The icon is added to your website via a code snippet
* Visitors click the icon on your site
* A chat with your bot opens instantly

**How to Use the Agent Icon Widget**

1. Expand the **"Agent Icon"** section and click **"Copy Agent Code."**
2. Add the code to your website header file and deploy it.
3. Click **"Edit Icon"** if you want to make changes to how the icon looks or behaves.

**Customization Options**

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FoNR5cVgJJcqLOW1Grp1w%2Fimage%20(12).png?alt=media&amp;token=4e81bd7a-c449-409d-b281-3e4c4f624cae" alt=""><figcaption></figcaption></figure>

* **Icon Size** — Adjusts the size of the icon (e.g., Medium)
* **Icon Text** — Sets the label shown next to the icon (e.g., "Send Message")
* **Icon Placement** — Sets where the icon appears on your website (e.g., Right Middle)

Click **"Update Widgets"** to save changes, or **"Discard"** to cancel.

***

#### 2. Link Widget

The Link Widget generates a shareable Instagram link that opens a direct conversation with your bot.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FMxqa2EATAh3fvtJGUgBu%2Fimage%20(14).png?alt=media&amp;token=8f36911b-97b3-48c1-a929-3a68fcc85a8c" alt=""><figcaption></figcaption></figure>

**How It Works**

* Users click the link
* They are redirected to Instagram
* A chat with your bot opens instantly

**How to Use the Link Widget**

1. Expand the **"Link"** section.
2. Click **"Copy Link"** to copy and start sharing it.
3. Click **"Need Help?"** if you want guidance on how to use it.

**Where You Can Share It**

* Website buttons (e.g., "Chat with us on Instagram")
* Email campaigns
* Social media bios
* Ads and landing pages

> 💡 Tip: Place the link where users are most likely to need instant support or information.

***

#### 3. QR Code Widget

The QR Code Widget lets users start a chat with your Instagram bot by scanning a QR code.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fktvr4DEOHgx0dkxKr8AC%2Fimage%20(15).png?alt=media&amp;token=088859bb-cca3-4d34-ad3f-1b0149b20482" alt=""><figcaption></figcaption></figure>

**How It Works**

* User scans the QR code using their phone
* Instagram opens automatically
* The bot conversation starts

**How to Use the QR Code Widget**

1. Expand the **"QR Code"** section.
2. Click **"Download QR Code"** to download and start sharing it.
3. Click **"Need Help?"** if you want guidance on how to use it.

**Common Use Cases**

* Storefront posters
* Product packaging
* Flyers and brochures
* Event booths
* Business cards

***

### Troubleshooting

<details>

<summary>"Instagram Integration Required" message won't go away</summary>

Complete the Instagram installation via "Install Instagram" → choose "Instagram" under Social Platforms → finish the connection steps.

</details>

<details>

<summary>QR code doesn't open the bot conversation when scanned</summary>

Confirm the QR code was generated from the current Widgets section and hasn't expired or been regenerated since printing.

</details>

<details>

<summary>Link Widget redirects to Instagram but doesn't open the bot chat</summary>

Confirm the Instagram automation is active and the bot is correctly linked to the connected Instagram account.

</details>

<details>

<summary>Agent Icon doesn't appear on the website after adding the code</summary>

Confirm the code was added to the website header file (not body) and that the site was redeployed after adding it.

</details>

### FAQs

<details>

<summary>Do I need a paid plan to use Widgets?</summary>

Availability depends on your BotPenguin plan and whether Instagram automation is enabled — check the Widgets section under Instagram Automation to confirm.

</details>

<details>

<summary>Can I customize the QR code design?</summary>

This depends on current product capability — verify in the Widgets section whether styling options are available.

</details>

<details>

<summary>Does the Link Widget work on mobile and desktop?</summary>

Yes, since it redirects through Instagram's own app or web experience, it works wherever Instagram itself is accessible.

</details>

<details>

<summary>Will the widget still work if I change my Instagram bot's flow?</summary>

Yes, the widget only routes users into the conversation — it isn't tied to a specific flow, so changes to your bot's automation won't break it.

</details>

<details>

<summary>Can I use the Agent Icon, Link, and QR Code widgets at the same time?</summary>

Yes, all three widgets are independent tools and can be used together across different channels.

</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.