# Bloquear

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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/bloquear.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.