Getting Started

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 and keeps everything in two permanent volumes — /apps/telegram (database, media, sessions) and /project/apps/telegram (settings as readable files). The database is built in and works out of the box. A step-by-step guide is in the Installation 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 section.

The interface

The product opens on the Home screen — a summary across all your channels at once: tiles with the totals — how many channels and subscribers (and how much the subscriber count grew during the day), views in 24 hours, average weekly engagement and 30-day comments — a “Needs attention” list of the channels that have nothing scheduled, and a “Sections” grid with every section of the product. The figures are shown as of the moment you sign in and come from the Channels section: there each channel has its own card with subscribers, views over the last 24 hours, engagement, the last published and the next scheduled post, and under the cards sits the Combined Timeline of all channels for the week. “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, grouped: Home first, then Marketing (Channels, Comments, Sources, Authors), Connections (Bots, Accounts) and System (Scripts). The panel can be resized by dragging and collapsed with a button in its header — the text then gets more room. At the very top of the sidebar is a search across the whole product: channels, posts, authors and comments are found from one box, as you type (details in the Search section). At the bottom of the sidebar are the Prompts button (the queue of tasks for the agent) and the Chats button (the Chats section appears when Xedant Agent is connected). The theme and the sounds switch with buttons in the header, and the gear button opens Settings — the API Keys section for the external API your scripts use to work with the product lives there too. The license status is in the footer of the Home 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 — the Telegram application data (api_id and api_hash from my.telegram.org), a phone number and a confirmation code will be needed. If two-step authentication is on, the application also asks for the cloud password — the one you set in the Telegram app under Settings → Privacy & Security → Two-Step Verification: it is not the login code, but a separate password;
  • 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_APP_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 section, writing posts in Publishing, the schedule in Scheduling. The pipeline from idea to publication is the Content Queue. Watching other channels starts with Sources, sorting the collected material with the Message Feed and Authors. Automatic content triage is in Routing, polite comments under other people’s posts in AI Comments, the numbers for your channels in Analytics, quickly finding what you need in Search, and the assistant inside the product in Agent.

← Back to the documentation index