The link library¶
Links are the destinations your menu buttons point to. They live in one shared library (Telegram → Links) and can be reused across any bot's menus. Every tap on a link button is tracked.
Create a link¶
- Go to Telegram → Links → Create.
- Fill in the fields:
| Field | What it does |
|---|---|
| Title | The default button label (you can override it per menu). |
| URL | Where the button sends the user (https://… or a t.me/… Telegram link). |
| Type | Website, TG Group, or TG Channel — used for grouping and reporting. |
| Status | Active links can appear in menus; Inactive ones are hidden. |
| Description | Internal note about the destination. |
| CTA Label | Optional call-to-action text. |
| Brand / Badge | Optional labels (e.g. a brand name, or a "HOT" / "NEW" badge). |
| Target Countries / Languages | Optional — restrict who sees this link (see below). |
- Save.
Targeting (who sees a link)¶
A link with no target countries or languages shows to everyone. Add one or more and the link button only appears for users who match.
- Country is determined by the user picking one via the
/countrycommand (or inferred from their Telegram language). - Language comes from the user's Telegram app language.
Targeted buttons can silently disappear
A user who hasn't set a country won't see country-targeted buttons. While you're setting things up, leave targeting empty so everything is visible, then add it once the basics work.
Edit, deactivate, or remove a link¶
- Edit — open a link from the list to change any field.
- Deactivate — set Status to Inactive to hide it from menus without deleting it (its history stays).
- Delete / restore — links are soft-deleted, so a removed link can be restored from the list.
Tip
Because links are shared, editing a link's URL updates it everywhere that link is used — across every bot and menu.
How link buttons behave for users¶
When a user taps a link button, they're sent through a tracked redirect to the destination. This is invisible to them (it just opens the site or Telegram link) and is what powers the click numbers in Subscribers & analytics.