> 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/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/bloquear.md).

# Bloquear

Com essa operação, você pode impedir que um contato continue interagindo dentro da sua automação.

A operação Bloquear Pessoa permite alterar o status de bloqueio de um contato. Uma pessoa bloqueada geralmente deixa de receber comunicações e pode ser excluída de certas automações, ajudando a manter sua base de contatos higienizada e respeitando as solicitações de privacidade.

Esta ação pode ser usada tanto para bloquear quanto para desbloquear uma pessoa, simplesmente alterando o valor do parâmetro.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Bloquear".
3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa cujo status de bloqueio você deseja alterar.
4. Defina o campo "Bloquear" como `true` para bloquear ou `false` para desbloquear.

***

### Parâmetros (Usando Campos)

| Campo                 | Tipo               | Obrigatório? | Descrição                                                                                                           |
| --------------------- | ------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------- |
| ID da Pessoa          | Texto              | ✅ Sim        | O ID único da pessoa a ser bloqueada ou desbloqueada.                                                               |
| Bloquear (`is_block`) | Booleano (Sim/Não) | ✅ Sim        | Define a ação a ser tomada. Selecione `true` (sim) para bloquear a pessoa ou `false` (não) para remover o bloqueio. |

Exportar para as Planilhas

***

### Estrutura (Usando JSON)

O corpo da requisição JSON é simples, contendo apenas a chave `is_block`.

Para bloquear uma pessoa:

JSON

```
{
  "is_block": true
}
```

Para desbloquear uma pessoa:

JSON

```
{
  "is_block": false
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Bloquear automaticamente um contato na Hablla quando um e-mail enviado para ele resulta em "hard bounce" (falha permanente na entrega).

1. Crie um fluxo que utilize um gatilho do seu serviço de e-mail (via Webhook) que dispara quando ocorre um "hard bounce".
2. O gatilho receberá o e-mail do destinatário que falhou.
3. Use a operação "Buscar Pessoa por E-mail" para encontrar o ID da pessoa correspondente a esse e-mail na Hablla.
4. Adicione o bloco "Pessoas" com a operação "Bloquear".
5. No campo "ID da Pessoa", insira a variável do ID encontrado no passo anterior (`{{steps.2.result.id}}`).
6. No campo "Bloquear", defina o valor como `true`.

Com esta automação, sua base de contatos se mantém limpa, evitando envios futuros para endereços de e-mail inválidos e melhorando a reputação do seu domínio de envio.


---

# 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/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/bloquear.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.
