Skip to content

Telegram

Telegram Telegram Integration

Connect a Cavuer AI agent to your Telegram bot and automate customer communication 24/7.

⚡ Quick Start

Get your agent up and running in four steps.

Step 1 — Create a Telegram Bot

Before creating an agent, set up a bot in Telegram:

  1. Open Telegram and find @BotFather
  2. Send the /newbot command
  3. Enter a bot name — it will be displayed in chats (e.g. "MyCompany Support")
  4. Enter a bot username — a unique identifier ending with bot (e.g. mycompany_support_bot)
  5. Copy the bot token sent by BotFather

Detailed Guide

Creating a bot takes just a couple of minutes. For a step-by-step guide with screenshots, check out our article.

How to Create a Telegram Bot →

Step 2 — Create an Agent in Cavuer

An agent is an AI profile that manages your channels. You can connect multiple channels to a single agent.

  1. Sign up at console.cavuer.com

  2. On the main page, click "Create Agent", enter a name and select a language model

    Create Agent

  3. After creating the agent, open its settings and add an instruction — rules for how the agent should interact with customers

Instruction Example

You are a polite support assistant for "MyCompany".
Always address the customer by name.
Only answer questions related to our services.
If you don't know the answer — suggest contacting a live operator.

Choosing a Language Model

Each model differs in speed, accuracy, and cost. For most support tasks, GPT-4 and Claude Haiku models work great. For complex analytical tasks, consider GPT-5, Claude Sonnet, or Claude Opus models.

Step 3 — Connect the Telegram Channel

  1. On the main page, click "Add Channel" next to your agent and select Telegram

    Create Channel

  2. Fill in the field:

    Field Description
    Bot Token The token obtained from BotFather in Step 1

  3. Click "Create"

Step 4 — Enable the Channel and Start

  1. Go to the channel settings
  2. Toggle the switch in the "Status" section

  3. Click "Save"

    Enable Channel

🥳 Done! Your AI agent is created, configured, and running. All incoming messages to your Telegram bot will be processed automatically based on the agent's instructions and knowledge base.

⚙ Advanced Setup

Agent Settings in Cavuer Dashboard

Configure the agent's behavior at console.cavuer.com:

Parameter Description
Name Rename the agent and channel for easier management in the Cavuer dashboard
Model Select a language model
Instruction Agent behavior rules: greeting, company description, operator transfer conditions, language settings. Specify whether the agent should respond in the customer's language or only in a specific language
Response Delay Delay before responding. Useful when customers send multiple messages in a row — the agent will wait and process all messages together
Process Images Allows the agent to view and analyze image content
Process Audio Enables the agent to recognize voice messages
Knowledge Base Upload .txt, .pdf, or .docx files and connect them in the agent settings

Full parameter reference: Agent and Channel Setup

Knowledge Base Setup

Go to Knowledge Base → click Upload Data → enter the article title and select a file.

Knowledge Base

Then, in the agent settings, check the box next to the uploaded articles and save your changes. For more details, see Knowledge Base.

Knowledge Base Best Practices

  • Use keywords in titles — e.g. "Pricing, cost, payment, plan" instead of just "Pricing"
  • Break up large texts — create smaller articles for specific topics (e.g. separate articles for "Delivery", "Payment", "Returns")
  • Titles cannot be changed — article content can be updated, but the title remains permanent
  • Link to documentation — upload key information and include a link to the full documentation

Usage in Groups

The agent can work not only in direct messages but also in Telegram group chats. Learn more: Usage in Groups.

Need Help?

If you have any questions about setting up your agent or connecting a Telegram channel, please contact our support team.