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

# Capacidades e bloqueio

> Teto no Chat App, interruptor na conversa, silenciar e bloquear usuários.

<Tip>
  São **duas camadas**, no molde Stream/Sendbird: o app declara o teto; cada conversa liga um subconjunto. Bloquear e silenciar são da **pessoa**, não da sala.
</Tip>

## Teto no Chat App

O produto declara o que *pode* existir:

| Campo                                                    | Default                          | O que é                                               |
| -------------------------------------------------------- | -------------------------------- | ----------------------------------------------------- |
| `allowedMessageTypes`                                    | `text`, `image`, `audio`, `file` | Tipos que uma conversa pode ligar                     |
| `allowEdit`                                              | `false`                          | Teto para editar mensagem (a v1 só persiste a flag)   |
| `allowDeleteForEveryone`                                 | `false`                          | Teto para apagar para todos (a v1 só persiste a flag) |
| `allowUserManageCapabilities`                            | `false`                          | Se um `USER` em DIRECT pode mudar a sala              |
| `defaultEnabledMessageTypes`                             | copia o teto                     | O que **nasce ligado** em conversa nova               |
| `defaultEditEnabled` / `defaultDeleteForEveryoneEnabled` | `false`                          | Flags iniciais da conversa nova                       |

`PATCH /v1/chat/apps/{id}` (escopo `chat:apps:manage`) altera o teto. Não existe “a conversa ligou vídeo se o app não tem vídeo”.

## Interruptor na conversa

Serializado em GET/list:

```json theme={null}
{
  "capabilities": {
    "enabledMessageTypes": ["text"],
    "editEnabled": false,
    "deleteForEveryoneEnabled": false
  },
  "appCapabilities": {
    "allowedMessageTypes": ["text", "image", "audio", "file"],
    "allowEdit": false,
    "allowDeleteForEveryone": false,
    "allowUserManageCapabilities": false
  }
}
```

Create de conversa aplica o default do app; o body pode passar um subconjunto. `PATCH /v1/chat/conversations/{id}` muda o interruptor e emite `conversation.updated` (WebSocket) e `chat.conversation.updated` (webhook).

**Quem muda a conversa**

* API Key: sempre
* `AGENT`: sempre
* `GROUP` + `OWNER` (e `ADMIN`): sim
* `USER` em `DIRECT`: só se `allowUserManageCapabilities` estiver ligado

## Envio recusado

O composer do app do cliente **só esconde botão**. Quem manda é o servidor:

* Tipo fora da sala ou do teto → `CHAT_CAPABILITY_DISABLED` (403)
* DIRECT com block entre os `USER` → `CHAT_USER_BLOCKED` (403)

O agente também respeita a sala. O mesmo vale no REST e no WebSocket (`message.send` com `type` + `mediaUrl`). `recording.start` exige `audio` ligado.

Exemplo suporte: o app permite texto, imagem, áudio e arquivo. A conversa do pedido nasce **só texto**. O agente (ou a API Key) liga mídia naquela sala. Desligar depois volta a recusar `IMAGE` / `AUDIO` / `FILE`.

## Silenciar

`POST /v1/chat/conversations/{id}/mute`

* JWT: silencia **a si mesmo**
* API Key: informe `memberExternalUserId`

`mutedUntil` nulo ou `muted: false` desliga. Membro silenciado ainda envia e lê; o campo vai em `members[].mutedUntil`. Evento WebSocket: `member.updated`.

## Bloquear

Tabela por Chat App (`PUT` / `DELETE` / `GET /v1/chat/blocks/{externalUserId}`).

* Não cria DIRECT com o bloqueado
* Não adiciona o bloqueado em grupo (e o bloqueado não entra se `joinPolicy=OPEN`)
* DIRECT já existente: envio recusado nos dois sentidos
* Não apaga o histórico
* `USER` bloqueia `USER`. Não dá para bloquear um `AGENT`
* Com API Key, envie `chatAppId` e `blockerExternalUserId`

Eventos: WebSocket `user.blocked` / `user.unblocked` nas conversas DIRECT afetadas; webhooks `chat.user.blocked` / `chat.user.unblocked`.

Remover membro continua sendo “tirar da sala”, não block global.

## Próximos passos

* [Enviar mensagens](/chat-api/como-funciona/enviar-mensagens)
* [Eventos dos webhooks](/chat-api/como-funciona/eventos-do-webhooks)
* [Usuário e agente](/chat-api/como-funciona/usuario-e-agente)