# Bloquear ou desbloquear contato

`POST /chat/block`

Pasta: **Bloqueios**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Bloquear ou desbloquear contato

Altera a blocklist do WhatsApp para um contato. Contato bloqueado não envia nem recebe mensagens com a instância.

## Endpoint

`POST {{baseUrl}}/chat/block`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `number` | string | Condicional | Telefone do contato. Informe `number` ou `chatid`. |
| `chatid` | string | Condicional | JID do contato (`5511...@s.whatsapp.net`). |
| `action` | string | Condicional | `block` ou `unblock`. Se omitido e sem `block`, o padrão é `block`. |
| `block` | boolean | Condicional | Atalho: `true` → block, `false` → unblock (sobrescreve `action`). |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/chat/block' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "number": "5511999999999",
  "block": true
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "blocklist": {
    "DHash": "abcdef",
    "JIDs": [
      "5511999999999@s.whatsapp.net",
      "5511888888888@s.whatsapp.net"
    ]
  }
}
```

## Erros comuns

- `400 Bad Request`: JSON inválido.
- `500 Internal Server Error`: número/JID inválido ou instância desconectada.
- `401 Unauthorized`: token inválido.

## Observações

- A resposta devolve a blocklist atualizada (`DHash` + `JIDs`), não apenas uma mensagem.
- Bloquear não apaga o histórico de conversa.

## Corpo (exemplo)

```json
{
  "number": "5511999999999",
  "block": true
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/chat/block" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "number": "5511999999999",
  "block": true
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=bloqueios/bloquear-ou-desbloquear-contato)