> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insighto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Widget

In this guide, you’ll learn how to set up the Telegram tool on Insighto and deploy your AI-powered chat assistant to a Telegram bot, enabling it to respond to user messages in real time. This integration allows your assistant to handle text-based queries from Telegram users just like any other messaging platform.

***

## Telegram Tool Setup

1. **Select Tools & Integration from the Sidebar**

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW1.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=b3dbec26b5e37c56a8c9c59b7cd93bf8" alt="Go to Tools & Integration" width="1526" height="962" data-path="images/TW/TW1.png" />

2. **Click Set Up Next to Telegram Tool**

In the Tools & Integration section, locate Telegram from the list of available tools. Click the Set Up button.

Click Set Up Next to Telegram Tool

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW2.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=ca831d9309a5f540bc5c2aaad096ada7" alt="Click Set Up Next to Telegram Tool" width="1526" height="962" data-path="images/TW/TW2.png" />

3. **Click on Start new**

Click the Start New button to initiate the configuration

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW3.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=be126ea0933728f54ebb56bbb4084711" alt="Click on Start new" width="1526" height="962" data-path="images/TW/TW3.png" />

4. **Enter Tool Name and Telegram Bot Token**

In this step, you need to:

* Give your Telegram tool integration a name
* Paste your Telegram Bot API token

This token is required to connect your Telegram bot with Insighto.

> 🔑 **How to Get Your Telegram Bot Token**\
> Open the Telegram app on your device.
>
> Search for BotFather (@BotFather) and start a conversation.
>
> Use the command `/newbot` to create a new bot.
>
> Follow the prompts:
>
> * Enter a name for your bot.
> * Enter a username (must end with "bot"—e.g., MyShopBot).
>
> Once done, BotFather will generate a unique API token for your bot.
>
> Copy the token—it will be used in this step.
>
> Paste the token into the Access Token field in Insighto, then click **Create** to continue.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW4.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=439115a014d3167d2c63e26e483b67a7" alt="Enter Tool Name and Token" width="1526" height="962" data-path="images/TW/TW4.png" />

5. **Finalize Setup by Clicking Save**

On the next page, you may see a message that says “Nothing to set up here” — this is expected. The tool doesn’t require additional configuration at this stage because it serves as a simple integration point.

> 💡 **Why This Happens:**\
> Telegram tool is used solely to link your telegram bot with Insighto. The actual deployment of your AI chat assistant will be handled separately via Widget during the agent setup process.

To complete the integration, simply click **Save**.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW5.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=122cbce365920aa5811598994c59e183" alt="Click Save" width="1526" height="962" data-path="images/TW/TW5.png" />

***

## Create Telegram Widget

6. **Click on Widgets from the Left Panel**

In the Assistants section on the left panel, click **Widgets**. This opens the widget setup page for deploying your AI assistant.

> 🔔 **Note:**\
> Ensure you’ve already created an AI assistant before proceeding. If not, follow the assistant creation guide first.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW6.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=9599df3170c6bb33b44d9bea1ac4fae2" alt="Go to Widgets" width="1526" height="962" data-path="images/TW/TW6.png" />

7. **Create a New Widget**

Click on **Create New Widget** to start the setup process.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW7.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=3a2bbdb8840b32e8f49964ed3cc16018" alt="Create New Widget" width="1526" height="962" data-path="images/TW/TW7.png" />

8. **Select Telegram as the Provider Type**

In the setup screen:

* Set **Provider Type** to Telegram
* Click **Next** to proceed

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW8.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=90ab7e1c09bd16ec79b0e169586cb50c" alt="Select Telegram as Provider" width="1526" height="962" data-path="images/TW/TW8.png" />

9. **Select Widget Type, Name, and Describe Your Widget**

Fill in the widget details:

* **Widget Type**: Choose appropriate type
* **Name**: e.g., Customer Support Chat
* **Description**: e.g., Handles customer support inquiries via Telegram

Click **Next** when done.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW9.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=432a442179acefd07a2ed01f84dc5964" alt="Widget Details" width="1526" height="962" data-path="images/TW/TW9.png" />

10. **Select Your Chat Assistant**

Choose the assistant you created earlier from the dropdown list.

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW10.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=e05c3062e96c26fd8ea0f673bfaebc82" alt="Select Assistant" width="1526" height="962" data-path="images/TW/TW10.png" />

11. **Select Telegram configuration and Click Finish**

Select the Telegram tool configuration from the dropdown list

<img src="https://mintcdn.com/insightoai-bc61fe99/DGKULXE1KuQ0xw_r/images/TW/TW11.png?fit=max&auto=format&n=DGKULXE1KuQ0xw_r&q=85&s=93b969ebaa03b7ec15cd56183f97245e" alt="Select Telegram Config and Finish" width="1526" height="962" data-path="images/TW/TW11.png" />
