Telegram, Website Widget & Training Data

Connect your Dala AI agent to Telegram, embed it into any website, or teach it domain-specific knowledge — no code required.

Before You Start

The Telegram, Widget, and Training Data features all require your agent to have a workflow attached. If your agent was just created and is still building, wait until the workflow is ready.

To check: open your agent → click Edit → if the CLIENT APPS, WIDGET, and TRAIN AGENT tabs are clickable (not grayed out), you are ready.

Part 1 — Telegram Integration

What Is It?

The Telegram integration lets your AI agent send and receive messages inside Telegram. Once connected, anyone who opens your Telegram bot can chat with your agent — just like a normal Telegram conversation.

Why Use It?

• Your users are already on Telegram — no new app to install.
• Ideal for customer support bots, FAQ bots, or personal assistant bots.
• The agent responds with the same intelligence as the web chat.

Step 1: Create a Telegram Bot with BotFather

1. Open Telegram and search for @BotFather (the official Telegram bot creator).
2. Start a conversation and send the command:

/newbot

3. BotFather will ask for a name for your bot (the display name, e.g. Gebeya Support Bot).
4. Then it will ask for a username — this must end in “bot” (e.g. GebeyaSupportBot or gebeya_support_bot).
5. Once created, BotFather will send you a confirmation message with your API token, similar to:

Done! Congratulations on your new bot. You will find it at t.me/YourBotName.Use this token to access the HTTP API: 7123456789:AAExxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx Keep your token secure and store it safely.

6. Copy the token — you will need it in the next step.

Note: Keep this token private. Anyone with it can control your bot. Never share it publicly or commit it to code repositories.

Step 2: Connect the Bot to Your Agent

7. Go to dala.gebeya.com and open the agent you want to connect.
8. Click the Edit button to open the Edit Agent panel.
9. Click the CLIENT APPS tab.
10. You will see the Telegram section. Click it to expand.
11. Toggle the switch to Enable the connection.
12. Fill in the fields:

Field	Description
Connection Name (Optional)	A label for your own reference, e.g. Customer Support Bot or Gebeya Nexus. Not shown to users.
Telegram Bot Token	Paste the token you received from BotFather in Step 1.

13. Click Save connection.

The platform will validate your token with Telegram before saving. If the token is incorrect, you will see an error — go back to BotFather and copy the token again.

Step 3: Test Your Bot

14. Open Telegram and search for your bot by its username (e.g. @GebeyaSupportBot).
15. Click Start or send /start.
16. Your agent should respond with its welcome message.

If the bot does not respond:

• Confirm the toggle in CLIENT APPS is enabled (not Disable).
• Check the token was saved correctly (try disconnecting and saving again).
• Make sure your agent’s workflow is active.

Disabling or Disconnecting

To temporarily pause the bot (without losing your token):

In the CLIENT APPS tab → Telegram section, toggle the switch to Disable. The bot will stop responding. Toggle it back to re-enable at any time.

To fully remove the connection:

Click the Disconnect button. This clears the token from your agent. You can reconnect later with the same or a different token.

Part 2 — Website Widget

What Is It?

The Widget tab generates a ready-to-use HTML snippet you can paste into any website to embed your agent as a live chat interface. No backend work needed — it works with static sites, WordPress, Shopify, custom React apps, or any HTML page.

Step 1: Open the Widget Tab

17. Open your agent and click Edit.
18. Click the WIDGET tab.

Note: If the WIDGET tab appears grayed out, your agent does not have an attached workflow yet. Wait for the agent build to complete.

Step 2: Choose a Widget Type

You have two options:

Chat Bubble (recommended for most sites)

A circular button appears in a corner of the page. When a visitor clicks it, a chat window opens as an overlay. The button floats over your existing content without taking up space.

Best for: landing pages, e-commerce stores, blogs, marketing sites.

iFrame Embed

A fixed-size chat panel is embedded directly into your page at the exact location where you paste the code.

Best for: dedicated support pages, internal tools, portals where you want the chat always visible.

Step 3: Customize the Widget

Use the controls in the WIDGET tab to configure how the widget looks:

Option	Description
Primary Color	The main accent color — used for the bubble button and highlights. Enter a hex value or use the color picker. Default: #ff5c00 (Dala orange).
Secondary Color	A secondary accent, used in gradients and hover effects. Default: #ff0099.
Bubble Position	(Bubble only) Choose where the button appears: bottom-right, bottom-left, top-right, or top-left. Default: bottom-right.
Width / Height	(iFrame only) Set the dimensions of the embedded chat panel (e.g. 400px x 600px).
Greeting Message	The first message the agent shows when a visitor opens the chat. Defaults to your agent’s welcome message.
Hide Header	Check this to remove the agent name header from the chat window for a cleaner look.

Step 4: Copy the Embed Code

Once you have configured the widget:

• Click View Code to preview the full generated snippet, or
• Click Copy Code to copy it directly to your clipboard.

Bubble widget example:

<!– My Agent Chat Bubble Widget –><script>(function() {  var config = {    agentId: ‘your-agent-id’,    widgetUrl: ‘https://dala.gebeya.com/agents/your-agent-id/embed?…’,    primaryColor: ‘#ff5c00’,    position: ‘bottom-right’,    agentName: ‘My Agent’  };  // … (auto-generated button + iframe code)})();</script>

iFrame embed example:

<!– My Agent Widget –><iframe  src=”https://dala.gebeya.com/agents/your-agent-id/embed?…”  width=”400px”  height=”600px”  frameborder=”0″  style=”border-radius: 12px; box-shadow: 0 4px 20px rgba(0,0,0,0.1); border: none;”></iframe>

Step 5: Paste into Your Website

Paste the copied code into your website’s HTML, just before the closing </body> tag. Examples for common platforms:

Plain HTML site:

<body>  <!– your existing content –>   <!– paste widget code here –></body>

WordPress:

Go to Appearance → Theme Editor → footer.php, and paste before </body>. Or use a plugin like Insert Headers and Footers to add the code without editing theme files.

Shopify:

Go to Online Store → Themes → Edit Code → theme.liquid, and paste before </body>.

Webflow:

Go to Project Settings → Custom Code → Footer Code, and paste the snippet.

Hosted Link

In addition to the embed code, the WIDGET tab shows a Hosted Link — a standalone URL like:

https://dala.gebeya.com/agents/your-agent-id/embed

You can share this link directly (e.g. in an email or social media bio) so users can chat with your agent without visiting your website. It opens as a full-page chat interface.

Part 3 — Training Data

What Is It?

Training data (also called the knowledge base) is information you give your agent so it can answer questions specific to your business, product, or domain. Without training data the agent only has its general AI knowledge. With it, the agent can answer questions like “What are your business hours?” or “How do I reset my password?” using the exact content you provide.

Why Use It?

• Ground your agent in your own content: FAQs, product docs, policies, price lists.
• Reduce hallucinations — the agent answers from your material, not guesswork.
• No need to rewrite your system prompt from scratch; just upload or paste what you already have.

Step 1: Open the Train Agent Tab

19. Open your agent and click Edit.
20. Click the TRAIN AGENT tab.

Note: If the Add Training Data button is disabled, your agent does not have an attached workflow yet. Wait for the build to complete.

Step 2: Add Training Data

Click Add Training Data. A panel opens with three ways to provide content:

Option A — Upload Files

Drag and drop files onto the upload area, or click it to browse your computer. You can upload multiple files at once. Each file becomes one training entry.

Supported file types: .txt  .md  .html  .docx  .pdf

Option B — Website URL

Enter a public URL. The platform fetches and indexes the content of that page.

• Must start with http:// or https://
• Must be a publicly accessible URL (no login required)
• One URL per entry

Good examples: your docs site, a product page, a public FAQ page, a pricing page.

Option C — Paste Text

Paste any text directly into the editor — copy-paste from a Word document, Google Doc, internal wiki, or anywhere else. The first line of your text becomes the entry title automatically.

Step 3: Save the Entry

After selecting a file, entering a URL, or pasting text, click Create. The entry will appear in your training data list with a status indicator:

Status	Meaning
Pending	The entry is queued and will be indexed shortly.
Ready / Active	The entry is indexed and the agent is using it.

Your agent starts using the new knowledge as soon as the entry status is active.

Editing or Deleting an Entry

Each training entry has a menu (three dots ···) on the right:

• Edit — Update the content (text or URL). File entries show the text extracted from the file, which you can modify.
• Delete — Permanently removes the entry. The agent will no longer use that knowledge.

Confirm the deletion when prompted — this cannot be undone.

Limits

Limit	Value
Maximum training entries per agent	3
Supported file types	.txt  .md  .html  .docx  .pdf

Tip: Make your entries count. A well-structured 500-word FAQ is more useful than a 50-page document full of irrelevant boilerplate. Aim for focused, high-signal content.

What to Upload — Practical Examples

Use Case	What to Add
Customer support bot	Your FAQ page, return policy, shipping info
Product assistant	Product spec sheet, feature list, pricing table
Internal HR bot	Leave policy, onboarding checklist, employee handbook
Booking bot	Service list, availability rules, pricing, contact info
E-commerce bot	Top product descriptions, size guides, delivery FAQ

Summary

Feature	Where to Set It	Requirement
Telegram Bot	Edit Agent → CLIENT APPS → Telegram	Agent workflow must be active
Website Bubble Widget	Edit Agent → WIDGET	Agent workflow must be active
Website iFrame Widget	Edit Agent → WIDGET	Agent workflow must be active
Hosted chat link	Edit Agent → WIDGET → Hosted Link	Agent workflow must be active
Training Data	Edit Agent → TRAIN AGENT	Agent workflow must be active

Frequently Asked Questions

Can I connect the same Telegram bot to multiple agents?

No. A single Telegram bot token can only be connected to one agent at a time. Create a separate bot in BotFather for each agent.

Can I change the colors after embedding?

Yes. Go back to the WIDGET tab, adjust the colors, copy the new code, and replace the snippet on your website.

The bubble button is hidden behind other elements on my site — what do I do?

The widget uses z-index: 9999. If something on your page uses a higher z-index, you may need to adjust your site’s CSS or move the widget position to a different corner.

Does the widget work on mobile?

Yes. The chat window is responsive and works on all modern mobile browsers.

What happens if I disconnect Telegram?

The bot stops responding immediately. Users who message it will get no reply. Your agent and all settings remain intact — you can reconnect any time.

Does training data affect the Telegram bot and the widget at the same time?

Yes. Training data is attached to the agent, not to a specific channel. Whatever the agent knows, it knows everywhere — Telegram, the widget, and the web chat all benefit from the same knowledge base.

Can I upload a PDF?

Yes. PDF is a supported file type. The platform extracts the text content and indexes it. Scanned PDFs (images with no selectable text) may not index correctly — use a text-based PDF when possible.

How quickly does new training data take effect?

Usually within a minute or two after the status changes from Pending to active. Refresh the chat and test with a relevant question.

My file isn’t showing up in the supported types — what can I do?

Convert it to a supported format first. For example: Word documents → save as .txt or copy-paste the content. Excel sheets → export as .csv. PowerPoint → save the key points as .txt or paste them manually.