> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bliper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Privacidade - Adição em Grupos

> Configura quem pode adicionar a instância em grupos

## Descrição

Configura quem pode adicionar a instância em grupos do WhatsApp.

## Request

### Headers

```
Client-Token: SEU_CLIENT_TOKEN
Content-Type: application/json
```

### Body

```json theme={null}
{
  "type": "CONTACT_BLACKLIST",
  "contactsBlacklist": [
    {"action": "add", "phone": "5511999999999"}
  ]
}
```

| Campo               | Tipo   | Obrigatório | Descrição                                             |
| ------------------- | ------ | ----------- | ----------------------------------------------------- |
| `type`              | string | Sim         | Quem pode adicionar em grupos (ver tabela abaixo)     |
| `contactsBlacklist` | array  | Não         | Lista de contatos com `action` (add/remove) e `phone` |

### Tipos de permissão

| Valor               | Descrição              |
| ------------------- | ---------------------- |
| `ALL`               | Todos podem adicionar  |
| `CONTACT`           | Apenas contatos        |
| `NONE`              | Ninguém pode adicionar |
| `CONTACT_BLACKLIST` | Todos exceto lista     |

## Response

### Sucesso (200)

```json theme={null}
{
  "success": true
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST 'https://api.bliper.io/instances/{INSTANCE_ID}/token/{INSTANCE_TOKEN}/privacy/group-add' \
  -H 'Client-Token: SEU_CLIENT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"type": "CONTACT_BLACKLIST", "contactsBlacklist": [{"action": "add", "phone": "5511999999999"}]}'
```