# How TeleMax works

TeleMax is built on a few ideas. Keep them in mind and most "why does it work this way" questions answer themselves. This page covers them and shows how data travels from a channel to your alert.

## The path of one post

1. A **source** publishes a post: a Telegram channel post, a post in a VK community or an Odnoklassniki group, a MAX message, a Rutube video or an article on a website.
2. A **collector** picks it up. How often we check a source depends on how active it is: busy channels are checked every few minutes, quiet ones less often, up to every four hours. Priority sources are always checked every five minutes.
3. The **post** goes into the project archive: text, date, views, reactions and attachments.
4. **Story.** Posts about the same event from different sources are grouped together. Five channels wrote about a warehouse fire: that is one story, not five news items.
5. From there, posts and stories go to different parts of the service: the [feed](/docs/feed) and the [Daily Brief](/en/docs/day) show them, [Monitoring](/docs/monitoring) checks them for your keywords, [auto-publishing](/docs/autopublish) sends them to your channels, and [integrations](/en/docs/integrations) send them to your systems.

## Project

A project is a workspace: its own list of sources, its own monitoring keywords, its own publishing settings and its own integration keys. The project switcher is at the top of the side menu, under the logo.

Create a separate project when a task has its own set of sources and its own people: an agency client, a region, a topic. Within one subject, one project with several keywords is enough.

> **Why.** Projects do not share data. Sources, the archive, alerts and stories of one project are not visible in another, so you can run a client separately and export only their data.

## Source

A channel, community or website that your project reads. Supported platforms:

| Platform | What we read | What we count |
|---|---|---|
| Telegram | public channels | subscribers, views, emoji reactions, forwards, comments |
| VK | open communities | subscribers, views, likes, reposts |
| MAX | public channels | subscribers, views, reactions |
| Odnoklassniki | open groups | members, likes ("Klass"), comments, reposts |
| Rutube | public channels | subscribers, video views |
| Websites | RSS feed or news sitemap | traffic from a public counter, social media response |

The source limit of your plan applies to each project separately: two projects can each use the full limit.

## Story

A story (the interface sometimes also says "cluster") is several posts about one event. The system compares the meaning of texts, not matching words, so "fire at a warehouse in Khimki" and "a warehouse near Moscow caught fire" end up together.

A story appears when enough sources have written about it. You decide how many: in [project settings](/settings) this is the "story confirmation threshold". A higher threshold means fewer stories, each confirmed by several channels. A lower one shows everything at once, including rumours from a single source.

### Independent sources

Sources are counted as **independent**: all channels of one newsroom count as one source. If a local news outlet posts the same item in Telegram and VK, that is one confirmation, not two. Newsrooms are the outlets listed in the [Networks](/networks) section, with all their channels on all platforms.

The same text from different newsrooms counts as different sources. Breaking news without details ("airports have suspended operations") is often worded the same way by different outlets, and these are still independent confirmations.

This rule is used for the story threshold, the "N sources" figure in the feed, the Daily Brief and the story window, and for the auto-publishing threshold. The list of sources inside a story shows every channel, so there may be more avatars than the number of sources.

Each story also has a **geography**: regional, national or international, and, where we can tell, a region or country. The Daily Brief can be filtered by it.

## The whole service and your project

Besides your own sources, TeleMax reads a shared pool of hundreds of thousands of channels and websites. The [Catalog](/en/docs/catalog) is built from this pool. This matters in two places:

- The **Daily Brief** is built from the whole pool, so you see the main national stories even if your project is small.
- **Monitoring** searches for a keyword **everywhere** by default: in your sources and in the shared pool. The "In my sources" option in the "Where to search" column narrows the search to your own sources.

> **Tip.** If you track your own campaign, keep searching everywhere: mentions most often appear where you did not expect them and did not think to subscribe.

## What updates and how often

| What | How often |
|---|---|
| New posts in your sources | from 5 minutes to 4 hours, priority sources every 5 minutes |
| Monitoring keyword checks | every 30 seconds |
| Views and reactions on fresh posts | several times during the first day, then less often |
| Channel figures in the Catalog | every hour |
| Website traffic | once a day |
| Registers of foreign agents and banned organisations | once a week |
