Profanity filter

Set up in the Mini App#

Open Settings in your private chat with @defendy_bot, select the group under My groups and check its name at the top.

1. Open Profanity filter and enable it.
2. Choose the system dictionary, your custom dictionary, or both.
3. For a custom or combined dictionary, add your words. Add exceptions separately.
4. Choose whether to check media captions, delete matched messages and apply a member action. Edited messages are always checked; this is not a toggle.

Switches and selectors save when changed. In a separate form with a Save button, save before leaving. If a request fails, reopen the section to check its actual values.

Tip: change one option at a time and verify the result in the group so false positives are easy to spot.

In short#

The profanity filter combines a system dictionary with optional custom words and exceptions for group-specific language.

How it works#

1. The filter checks text and supported media captions against the selected dictionaries.
2. Exceptions and custom words change which matches are considered violations.
3. Edited messages are checked as well; a violation then triggers deletion and the selected action.

Every setting explained#

Enable filter#

Default: Off.

Turns profanity detection on for the group.

Dictionary mode#

Default: Combined.

System dictionary, custom dictionary or combined mode.

Filter media captions#

Default: On.

Applies checks to media captions.

Filter edits (always on)#

Default: On.

Checks edited messages after they change. The WebApp shows this as always on without a switch.

Delete message#

Default: On.

Deletes a message when profanity is detected.

Action#

Default: None.

What Defendy does after a violation: nothing, warn, notify, mute, kick or ban depending on the feature.

Action duration#

Initial value: 1 hour (3,600 seconds).

The mute or ban duration, when that action supports a time limit. Where supported, zero means no expiry. Check the duration again after changing the action.

Warning weight#

Default: 1.

How many warning points this violation adds to the warning system.

Exceptions#

Default: Empty.

Words or phrases that should not trigger the filter.

Practical example#

If the filter incorrectly matches a product name, add that name to exceptions. In a test group, try it in ordinary text, a media caption and an edited message: the allowed name should not trigger the filter. To issue warnings, separately choose Warning and weight 1; changing the weight alone does not enable warnings.

Recommendations#

• Use exceptions before switching to stricter actions.
• Custom dictionaries are useful for local slang, product names and false positives.

Troubleshooting#

• Check that Defendy is still an administrator in the group.
• Refresh the settings panel and make sure you are editing the correct group.
• If a setting is saved but does not work, check the bot permissions in Telegram.
• If logging is connected and the relevant category is enabled, check the event record. The log cannot show events that were not recorded.

Check the duration after changing an action#

Changing the punishment type can reset its duration to 0. Where supported, zero means an indefinite action, not a disabled punishment. A temporary mute lasts at least 60 seconds. Recheck the duration before leaving the form.