How to Configure IP Blocking Message?

Configure custom text for the blocking message displayed to users when chat access is restricted by IP address. You can configure text for different languages and add helpful information.

When It Will Be Useful

  • You need to adapt the blocking message to your company's style.
  • You need to add support contacts or instructions for users.
  • You need to configure messages for different languages supported by the widget.

What's Important to Know

  • Blocking message — text that the user sees when their IP address is blocked.
  • Multilingual — you can configure text for different languages (Ukrainian, Russian, English, and others).
  • Default text — if you don't specify custom text for a language, the default message is used.
  • Automatic selection — the system automatically selects text according to the user's language.

Before You Start

  • You are logged in with administrator or supervisor rights.
  • You have access to widget settings.
  • The widget is already configured in the system.

Step-by-Step Instructions

1. Open Widget Settings

  1. Go to the Settings module through the menu or directly at /settings-page.
  2. In the side menu, find the "Bots" section and expand it.
  3. Select the bot for which you need to configure the blocking message.
  4. Go to the "Widget" tab.

2. Find Message Configuration Section

  1. In widget settings, find the "IP Blocking Message" section.
  2. The section contains fields for entering text for different languages.

3. Enter Text for Languages

  1. For each language (Ukrainian, Russian, English), there is a separate field.
  2. Enter your custom blocking message text for each language, if needed.
  3. If you don't enter text for a language, the system will automatically use the default text for that language.

Example text with support contacts:

  • Ukrainian: "Access to chat from this IP address is restricted. If you believe this is an error, contact support at +380 XX XXX XX XX or email support@example.com."
  • Russian: "Access to chat from this IP address is restricted. If you believe this is an error, contact support at +380 XX XXX XX XX or email support@example.com."
  • English: "Chat access from this IP address is restricted. If you believe this is an error, please contact support at +380 XX XXX XX XX or email support@example.com."

4. Add New Language (Optional)

  1. If you need to add a message for an additional language, click the "+" or "Add Language" button.
  2. Select the language from the list of available languages.
  3. Enter the message text for the new language.
  4. Save changes.

5. Save Settings

  1. Check all entered texts for correctness and compliance with your company's style.
  2. Click the "Save" button.
  3. Wait for the success message.

How the Message Works

Display in Widget

  1. When a user from a blocked IP address tries to send a message in the widget chat.
  2. The system automatically determines the user's language (based on browser or widget settings).
  3. Your custom message is displayed (if entered for that language) or the default message.

Default Texts

If you don't enter custom text for a language, the system will use default messages:

  • Ukrainian: "Access to chat from this IP address is currently restricted due to unusual activity detected."
  • Russian: "Access to chat from this IP address is temporarily restricted due to suspicious activity detected."
  • English: "Chat access from this IP address is currently restricted due to unusual activity detected."

What Happens After

The blocking message is configured:

  • Users from blocked IP addresses see your custom text (if entered) or the default message.
  • Text is automatically selected according to the user's language.
  • You can update the text at any time through widget settings.

How to Verify Everything Worked

  • Check that the text is saved in widget settings.
  • Check that the text displays correctly for each language.
  • Check message display in the widget for a blocked IP address (if possible).
  • Verify that default messages work for languages for which custom text was not entered.

Important Notes

  • 💬 Personalization: You can adapt the message to your company's communication style and add helpful information (support contacts, instructions).
  • 🌍 Multilingual: Supporting different languages allows providing information to users in a convenient format.
  • 🔄 Flexibility: You can use default texts or create your own for each language.
  • 📝 Usefulness: It's recommended to add support contacts in the message so users can get help faster and reduce requests through other channels.