Documentation

Greeting Pop-up Settings

The Greeting Pop-up module allows you to display a welcome message when a user enters the chat. Messages can be configured separately for logged-in users and for guests (read-only users).

The Greeting Pop-up configuration is available in the Admin Panel under: Admin panel → Widgets → Greeting pop-up

Categories of Greeting Pop-ups

1. Greeting Pop-up for Logged-in Users

  • Displayed to: Users with full access (authorised).
  • Purpose: Encourage open conversation, provide support contact info, welcome the user, or announce a new feature.
  • Customisations: Headline, text, call-to-action button, toggle (enable/disable).
  • Multilingual: Localised content for supported languages (you need to add variants for different languages manually).

2. Greeting Pop-up for Read-Only Users

  • Displayed to: Guests or users in read-only mode.
  • Purpose: Highlight the benefits of logging in (e.g., to send messages or interact).
  • Customisations: Same as above.
  • Multilingual: Localised content for supported languages (you need to add variants for different languages manually).

Display Settings

Admins can configure how and when pop-ups appear using three key parameters:

Recurring Display

  • Once: Displayed one time per user.
  • Several times: Reappear based on frequency settings.

Frequency of Display

  • Daily: Once per day.
  • Every time a user joins a chat: Ensures frequent visibility.

Moment of Display

  • Immediately upon joining: Pop-up shows right after the user enters the chat.
  • With a delay: Pop-up is delayed by a preset time interval.
    • Delay options: 5 sec, 10 sec, 15 sec.
    • Useful for avoiding disruption and giving the user a moment to orient themselves in the interface.

Advice: Show a message to read-only users after 5 seconds, encouraging them to log in and unlock full features.

Optional Button in Greeting Pop-up

Each greeting pop-up can include an optional call-to-action button to engage users and guide them to specific actions or content.

Button Configuration Options

  • Button Text
    Customise the button label (max 30 characters). Example: "Read more...", "Join now", "See how it works"

  • Link
    Add a URL that will open when the button is clicked. You can choose one of two behaviours:

    • Open in a new window: Default behaviour, opens the target link in a new browser tab.
    • Send post message: Triggers a postMessage event to the parent application, allowing advanced custom logic (e.g., trigger login modal, open custom widget, etc.).

Example Use Cases

  • For read-only users:

    • Button text: "Log in"
    • Link: https://yourdomain.com/login
    • Behaviour: Open in a new window
  • For authorized users:

    • Button text: "See challenges"
    • Link: https://yourdomain.com/challenges
    • Behaviour: Send post message to open embedded widget or modal

Button in Preview

As you edit the button text and link, the live preview (top right) reflects the changes immediately, helping you visualise the final look of the message inside the chat interface.

Example Messages

Logged-in user message:

Welcome to the chat!
Feel free to share your thoughts, support others, and enjoy the power of community.

Read-only user message:

Welcome!
To join the conversation, please log in. Enjoy reading for now!