Setting Up Welcome Messages

Setting Up Welcome Messages

Welcome messages are configured separately for each group or channel in Messaging > Welcome messages. The same editor supports text, an optional image, buttons and dynamic variables.

Public welcome

Write the public message and save. In groups with topics, select the destination topic. Channels do not use topics: Metricgram publishes the welcome in the channel when Telegram reports a new subscriber joining. Everyone in the channel can see it. The bot must be an administrator with permission to post messages.

Leave both the public text and image empty to disable the public welcome. Public welcomes share a short cooldown to limit bursts, so not every simultaneous join produces a post.

Private welcome

Configure the private message in the second editor. Metricgram sends it before approving a supported join request: a Metricgram invitation or a trackable invite link for a group or channel, or a public group with new member approval enabled. Direct joins do not trigger a private welcome.

Delivery is not guaranteed. Telegram only allows temporary contact with an applicant; another administrator bot may contact them or approve the request first and close that window. If delivery fails, check the join path, the user’s bot contact or block status, and other administrator bots’ permissions.

Dynamic variables

• {FIRST_NAME} — the new member’s first name
• {USERNAME} — their Telegram username, or - if absent
• {ID} — their Telegram ID
• {CHAT_TITLE} — the group or channel name
• {USERNAME|FIRST_NAME} — username if present, otherwise first name

Availability and testing

Public and private welcomes are available during eligible trials and on Basic, Pro and Elite. There is one public and one private configuration per community. A later rejoin can trigger another public welcome; repeated deliveries of the same channel join event are suppressed.

Test public and private delivery separately with a test account. For private delivery, use one of the supported join-request paths above.