Telegram Bot

The Telegram Bot agent serves as an AI assistant for your Telegram chats. It automatically replies to users in your brand’s voice, utilizing your custom knowledge base and context-aware memory to handle conversations, answer FAQs, and provide support instantly.

Setup (Step-by-Step)

1. Create your bot in Telegram

   • In Telegram, search for @BotFather.

   • Send the command /newbot and follow the instructions to name your bot.

   • Copy the Bot Token and the bot link (e.g., t.me/YourBotUsername).

2. Paste your Bot Token

   • Paste the token you just copied into the Bot Token input on this page.

3. Write your Agent Prompt

   • Use the prompt editor (up to 10,000 characters) to define your tone (e.g., “friendly, concise, professional”), style rules, dos/don’ts, and safety limits.

   • Tip: Provide example dialogues for tricky cases.

4. Add Company Knowledge

   • Paste product info, pricing guidance, hours/locations, refund policy, contact details, sales scripts, and known FAQs into the knowledge base section.

5. Test the Output

   • In the right-side tester, type a Comment and click Test Output (costs 1 credit).

   • Iterate on your prompt and knowledge until the answers look perfect.

6. Go Live

   • Click Start Agent.

   • Your Telegram bot is now live with the webhook automatically connected.

7. Share Your Bot

   • Share the t.me/YourBotUsername link directly, or tell users to search @YourBotUsername in Telegram and tap Start.

Configuration

These are the settings located on the left side of the Agent Builder.

Bot Token

To connect your agent, you must provide a Telegram Bot Token.

1. Open Telegram and search for @BotFather.

2. Send the command /newbot and follow the instructions to name your bot.

3. Copy the API Token provided and paste it here.

Note: Once saved, we automatically register the webhook to start "listening" for new messages.

Agent Prompt

This is the "brain" of your agent. You can write up to 10,000 characters defining your persona, tone, and rules.

• Style: Define if the bot should be friendly, professional, or concise.

• Constraints: List any topics the bot should avoid or escalation rules (e.g., "If a user asks for a refund, direct them to email support").

Company Knowledge

Paste your core business details here. This acts as the bot's reference manual.

• Content to include: Product pricing, business hours, refund policies, and sales scripts.

• Function: The bot combines this knowledge with your Agent Prompt to ensure answers are factually accurate and grounded.

Testing Your Agent

The panel on the right side allows you to simulate a user message to see how your prompt handles it before you go live.

• User Message: Type a sample question a user might ask (e.g., "How much does the premium plan cost?" or "Are you open on Sundays?").

• Test Output: Clicking this allows you to tweak your prompt and knowledge base until the tone and accuracy are perfect.

• Note: Testing costs 1 credit per output.

Important Notes & Limitations

Context-Aware Memory

Unlike simple auto-responders, this agent remembers the entire current conversation history. It can reference previous questions, clarifications, and user preferences within the chat to provide consistent answers.

Rate Limits

To prevent abuse, the agent is capped at 500 messages per day per organization.

• If you need a higher volume for legitimate use cases, please contact support.

Typing Indicators

To improve user trust and perceived speed, the agent displays a "typing..." status in Telegram while generating a response. Replies are typically sent within 2–5 seconds.

Privacy & Security

We process user messages and conversation history solely to generate the reply. Tokens are stored securely, and context is not shared across unrelated chats.

Managing Sessions

New conversations clear the entire history from memory. The bot's memory is scoped strictly to the current active conversation thread.