Welcome messages

Welcome template configuration.

Welcome messages are sent when a new member joins a connected group.

Where to Configure

Dashboard path:

/welcome_message_rules

Visible navigation label: Welcome or Welcome messages.

What Welcome Messages Do

When Telegram sends a new-member event for a connected group, GramGroupsBot checks the group's assigned active welcome message rule.

If a rule exists, the bot sends the configured message to the group.

The bot's own join event is ignored.

Fields

A welcome message rule has:

  • Name, max 100 characters.
  • Message text, 1 to 1000 characters.
  • Fallback for {first_name}, 1 to 80 characters.
  • Assigned groups.
  • Active flag.

Placeholder

Supported placeholder:

{first_name}

At runtime, {first_name} is replaced with the new member's Telegram first name.

If Telegram does not provide a first name, the fallback value is used.

Example Templates

Basic Welcome

Welcome, {first_name}. Read the pinned message before posting.

Community Rules Reminder

Hi {first_name}, welcome to the group.

Please keep discussion on topic, avoid spam, and do not post unauthorized links.

Support Intake

Welcome, {first_name}.

For support, start your message with #support and include the relevant order or account ID.

Assignment Behavior

Each group can have one active welcome message rule.

Assignments can be managed on the welcome message form or on the Groups page.

Runtime Events

Welcome delivery emits moderation events:

  • welcome_message_sent
  • welcome_message_failed

If Network logs are enabled, these events can be delivered to the configured Telegram log destination.

Limitations

Current welcome messages do not support:

  • Rich templating beyond {first_name}.
  • Buttons.
  • Media attachments.
  • Goodbye messages.
  • Per-language templates inside one rule.