> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/hablla-docs-en/hablla/settings/word-censorship.md).

# Word Censorship

The feature of **Word Censorship** allows you to define rules to automatically block the use of sensitive words, phrases, or terms in communications carried out by your team of users through Hablla.&#x20;

When a message contains a term that is part of the censorship list, sending is blocked and the system immediately asks the user to correct the message content before proceeding.

The feature can be applied both to the **messages sent by users** and to the **templates**, helping maintain a communication standard and avoiding the use of inappropriate or unauthorized terms in your operation.

## How to configure Word Censorship

### 1. Access the Workspace settings

Inside the **Hablla Studio**, click the **gear**icon, located in the upper-right corner of the screen. In the settings side menu, find and click the option **Word Censorship**.

<figure><img src="https://1592162275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FHsFRMQXhNGo9E0KCPjod%2Fcensura_palavras.png?alt=media&amp;token=4b2322a7-c53e-43d9-a0a3-729b28a999c6" alt=""><figcaption></figcaption></figure>

### 2. Enable Word Censorship

At the top of the screen, enable the switch **Enable censorship**. This setting is responsible for enabling the feature in the workspace. After enabling it, you will be able to define which censorship rules will be used.

<figure><img src="https://1592162275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FPA3uwo0e2QkdBgsBVEve%2Fativar_censura.png?alt=media&amp;token=5ba34712-564a-4cb6-b03a-af89331127cc" alt=""><figcaption></figcaption></figure>

### 3. Use Hablla's censorship list

In the **Settings**, you will find the option **Hablla Censorship**.

By enabling this option, the platform starts using a default list with **more than 1,000 sensitive words and terms**, which will be automatically blocked without the need to register them individually.

<figure><img src="https://1592162275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2Fzp0qXlGmNJZnVDtQLykf%2Fcensura_hablla.png?alt=media&amp;token=28f2e973-2de3-4c31-82bf-8b749ff75e28" alt=""><figcaption></figcaption></figure>

### 4. (Optional) Add custom words

In addition to Hablla's default list, you can also define specific words or phrases that should not be used in your workspace communications.

In the **Manage words**:

* Type the word or phrase you want to censor.
* Click **+ Add word**.
* Repeat the process to add other terms, if necessary.

The terms added will be displayed on the screen itself and will become part of the workspace censorship rules.

<figure><img src="https://1592162275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FYfSiHCPkMgnwzpjE6Zn4%2F%5BDOCS%5D%20-%20Como%20Adicionar%20Palavras%20na%20Censura.gif?alt=media&amp;token=263e9bb9-5753-4dee-8a03-ae3670fd9a94" alt=""><figcaption></figcaption></figure>

## What happens when a word is censored?

When a user tries to send a message containing a word or phrase blocked by the censorship rules, Hablla **will prevent the message from being sent**.

The user must then correct or remove the censored content before making a new sending attempt.

#### Example of how the Message Correction Request Modal appears to the User

<figure><img src="https://1592162275-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrmxWrIrMauHcIrsuqfGq%2Fuploads%2FtycPEF57kHzYkauHtouv%2Fmodal_block_palavras.png?alt=media&amp;token=0882f00e-40b6-41e3-93f0-e577ad15034c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can use the **Hablla Censorship** to apply the default list of sensitive terms and, at the same time, add specific terms from your operation through the section **Manage words**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-en/hablla/settings/word-censorship.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
