How to Configure Alias in Broadcasts?

Alias (entry point) is needed to transition to the bot scenario and display buttons in the broadcast. Configuring alias allows directing users to the needed scenario block after receiving the broadcast.

When Needed

  • You need to add buttons to the broadcast for transition to the bot scenario.
  • You need to direct users to a specific scenario block after receiving the message.
  • You need to create an interactive broadcast with interaction capability.

What's Important to Know

  • Alias — identifier of the entry point in the bot scenario, used in broadcasts.
  • Alias must be written in Latin.
  • Initial characters cannot be digits.
  • If alias is missing in the bot scenario at the time of sending, this may lead to incorrect message sending.
  • After completing the broadcast, make sure there is a block with buttons for further actions in the scenario.

Prerequisites

  • You are logged in with integrator or administrator rights.
  • You have access to the scenario constructor.
  • You have a broadcast template or are creating a new one.
  • You know which scenario block to direct users to.

Step-by-Step Instructions

Configuring Alias in Scenario

  1. Go to the bot's scenario constructor.
  2. Add a "Connection Between Points (Entry Point)" block to the scenario.
  3. In the block settings, specify the "Action Name" (for example, welcome_message or promo_offer).
    • Name must be written in Latin
    • Cannot start with digits
  4. Connect the entry point block to a "Message with Keyboard" block.
  5. In the message block, add buttons that will be displayed in the broadcast.
  6. Save changes in the scenario.

Using Alias in Broadcast Template

  1. In the Broadcast module, open the broadcast template for editing or create a new one.
  2. In the "Scenario Alias Action" field, enter the action name you specified in the scenario (for example, welcome_message).
  3. Make sure the alias exactly matches the name in the scenario (case-sensitive).
  4. Save the template.

Important Alias Requirements

  • ✅ Alias must be written in Latin.
  • ✅ Initial characters cannot be digits.
  • ❌ If alias is missing in the bot scenario at the time of sending, this may lead to incorrect message sending.

Examples of correct aliases:

  • welcome_message
  • promo_offer_2024
  • support_chat

Examples of incorrect aliases:

  • 123welcome (starts with digits)
  • привітання (Cyrillic)
  • welcome message (spaces)

What Happens After

After receiving the broadcast, users will see buttons (if they are added in the message block) and can transition to the corresponding scenario block by clicking the button. The system will direct the user to the block with the specified alias.

⚠️ Important: After completing the broadcast, make sure there is a block with buttons for further actions in the scenario. The entry point must contain the Scenario Alias Action specified when filling out the broadcast.

How to Verify It Worked

  • Check that alias is specified correctly in the broadcast template.
  • Make sure alias exists in the bot scenario and is connected to the message block.
  • Create a test broadcast and check that buttons display and work correctly.
  • Check that the user reaches the needed scenario block after clicking the button.