Capacidades e bloqueio

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.

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:

{
  "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.

API Chat

Chat Apps

Chat Users

Conversas

Bloqueios

Mensagens

Capacidades e bloqueio

Teto no Chat App

Interruptor na conversa

Envio recusado

Silenciar

Bloquear

Próximos passos

​Teto no Chat App

​Interruptor na conversa

​Envio recusado

​Silenciar

​Bloquear

​Próximos passos

Teto no Chat App

Interruptor na conversa

Envio recusado

Silenciar

Bloquear

Próximos passos