---
title: "Getting Started"
id: "1810"
type: "page"
slug: "getting-started"
published_at: "2026-09-20T22:08:59+00:00"
modified_at: "2026-09-21T01:36:28+00:00"
url: "https://xedant.com/agents/telegram/docs/getting-started"
markdown_url: "https://xedant.com/agents/telegram/docs/getting-started.md"
excerpt: "Telegram Agent is one interface for all your Telegram marketing. Your own channels: posts in…"
---

# Getting Started

[https://xedant.com/agents/telegram/docs/getting-started.md](https://xedant.com/agents/telegram/docs/getting-started.md)

Telegram Agent is one interface for all your Telegram marketing. Your own channels: posts in a comfortable editor and publishing on a schedule, without the routine. Other people’s channels and chats: watching competitors and partners through sources. Sorting the collected material: the message feed, authors, tags — so nothing valuable gets lost. And AI commenting on other channels, which politely reminds people about your channel wherever your topic comes up.

## Who it is for

For channel owners, marketers and entrepreneurs who run Telegram without programmers. If you publish manually, follow competitors in the feed manually, and dream of one place that shows everything — from the post schedule to what other channels are saying — this is your tool.

## System requirements

Any Linux host with Docker: the application deploys as a single container, all data lives in the permanent `/data` storage, and the database is built in and works out of the box. A step-by-step guide is in the [Installation](/agents/telegram/install)
 section.

## First sign-in

Self-registration is open while the application has no users: the first person to register becomes the administrator. The alternative is to set the login and password with environment variables at startup (the password is passed as a SHA-256 hash). If nothing is set, the application issues a one-time password itself and prints it to the console. A sign-in session lasts 90 days — you will not have to sign in often. Details in the [Installation](/agents/telegram/install)
 section.

## The interface

The main screen is the Channels section: a card for each of your channels with subscribers, views over the last 24 hours, engagement, the last published and the next scheduled post — plus a combined week timeline of all channels. “Engagement” is the share of subscribers who opened the post: it shows how interesting the content is to the audience.

The product’s sections live in the sidebar: Home, Channels, Comments, Sources, Authors, Bots, Accounts and Chats (the Chats section appears when Xedant Agent is connected). At the bottom of the sidebar are the Prompts button (the queue of tasks for the agent) and the Chats button. Settings, the theme and sounds open from the main menu in the header. The license status is in the footer of the main screen: the license owner’s name, the key type, or “No license”.

## First steps

- **Create a bot** in @BotFather and paste its token into the Bots section. A token is the bot’s secret access key, issued by @BotFather; through the bot the application connects to channels. Or connect a personal Telegram account in the Accounts section — a phone number and a confirmation code will be needed;
- **Connect your channel** in the Channels section — through a bot (the bot must be an administrator of the channel) or from the list of your account’s channels;
- **Set up schedule slots** — the days of the week and times when you usually publish: from there, publishing dates are calculated automatically;
- **Write the first post** in the editor and publish it — right away or into the nearest schedule slot;
- **Add a source** — an RSS feed or another channel — and open the message feed: the collected material is already there.

## Language and theme

The interface language is set by the brand at installation (`TELEGRAM_AGENT_BRAND=xedant` — English, `pastukhov` — Russian). The theme — dark or light — switches in the interface with one button, same as the notification sounds.

## A desktop shortcut

The application can be installed as a PWA — an ordinary shortcut on the desktop or in the applications menu, straight from the browser, without app stores or installers. It opens as a separate window. Internet is still required: there is no offline mode.

## What is next

Connecting and configuring channels is in the [Channels](/agents/telegram/docs/channels)
 section, writing posts in [Publishing](/agents/telegram/docs/publishing)
, the schedule in [Scheduling](/agents/telegram/docs/scheduling)
. The pipeline from idea to publication is the [Content Queue](/agents/telegram/docs/queue)
. Watching other channels starts with [Sources](/agents/telegram/docs/sources)
, sorting the collected material with the [Message Feed](/agents/telegram/docs/messages)
 and [Authors](/agents/telegram/docs/authors)
. Automatic content triage is in [Routing](/agents/telegram/docs/routing)
, polite comments under other people’s posts in [AI Comments](/agents/telegram/docs/comments)
, the numbers for your channels in [Analytics](/agents/telegram/docs/analytics)
, and the assistant inside the product in [Agent](/agents/telegram/docs/agent)
.

[← Back to the documentation index](/agents/telegram/docs)