# Mensagens

> O chat em tempo real entre os membros da comunidade, em conversas de duas pessoas. Abre pela sua foto no topo, num painel com o seu status (Disponível, Ausente, Ocupado ou Indisponível), Conversas e Pessoas, Livre ou Precisa adicionar (conexões com Adicionar, Aceitar e Recusar), o sino de notificações, digitando, Confirmação de leitura, apagar, bloquear, os avisos por e-mail e a privacidade: só as duas pessoas leem a conversa, a equipe nunca. Em todos os planos.

**Mensagens** é o chat em tempo real entre os membros da comunidade: conversas de **duas pessoas**, que chegam na hora, sem recarregar a página. Vem **ligado** em toda comunidade, em **todos os planos**, e qualquer papel usa: membro, moderador, financeiro, administrador e proprietário.

Só as duas pessoas de uma conversa leem o que foi escrito. **A equipe da comunidade não tem acesso às mensagens**: não há tela, relatório ou fila de moderação com elas (ver [Privacidade](#privacidade)).

## Onde fica

O chat não tem item no menu nem espaço próprio. Ele abre pela **sua foto, no topo à direita**: um clique abre o painel lateral **Mensagens e conta**, e outro clique na foto fecha (**Esc**, um clique fora do painel ou deslizar o dedo para a direita também fecham). O número vermelho em cima da foto é o total de mensagens não lidas, e a bolinha embaixo, à direita, é o seu [status no chat](#seu-status-no-chat). Não há mais ícone de chat no topo nem barra **Mensagens** no rodapé.

O painel tem, de cima para baixo:

- uma linha com a engrenagem **Configurações do chat** (com **Confirmação de leitura**, **Mostrar quando estive online por último**, **Sons** e **Pessoas bloqueadas**), o botão **Minha Conta** (com o nome escrito) e **Sair**. Não há mais o ícone **Meu Perfil**: a sua [página do membro](/membros/seu-perfil) abre por **Ver meu perfil**, em **Minha Conta**;
- conforme o seu papel, uma linha com **Minha empresa** (quem está na equipe de uma [empresa](/membros/empresas)), **Eventos que organizo** (quem organiza eventos) e **Engajamento geral** (quando a comunidade tem o engajamento geral ligado). Eles saíram do menu lateral, que agora termina com a comunidade;
- **Buscar conversas**;
- as abas **Conversas** (com o número de não lidas) e **Pessoas** (com o número de pessoas online), sublinhadas como as abas do Feed, com o seletor do seu **status** na mesma linha, à direita. Numa tela estreita, o seletor encolhe para a bolinha e a seta (o nome do status aparece ao passar o mouse). O painel abre em **Conversas** quando há mensagens não lidas e em **Pessoas** quando não há.

Com o chat desligado na comunidade, a foto abre só a linha da conta (**Minha Conta** e **Sair**) e a dos itens do seu papel. O menu lateral não tem mais **Minha Conta**, **Sair**, **Faturamento** (agora em **Minha Conta › Faturamento**) nem **Reportar problema** (o ícone de inseto no topo).

O painel abre **logo abaixo do topo**, e a foto não sai do lugar. A partir de 600 px de largura, ele é uma lateral de 380 px à direita, sobre um fundo escuro; **no celular** (abaixo de 600 px), ocupa a largura inteira, abaixo do topo.

**Ao abrir uma conversa:** em telas abaixo de 1024 px, ela ocupa a tela, com **Voltar** para o painel. **No computador (a partir de 1024 px)**, ela abre numa **janela de 330 px** no canto inferior direito, com **Minimizar** (fica só a faixa do topo) e **Fechar**; cabem quantas couberem sem passar por cima do menu lateral (uma numa tela de 1280 px com o menu aberto, duas numa de 1920 px), e uma nova substitui a mais antiga. Uma conversa minimizada vira uma aba pequena com a foto, o nome e o número de não lidas; as que não cabem ficam em **+N** (*"Mais N conversas"*). As janelas abertas ficam guardadas neste navegador.

O sino, à esquerda da sua foto, traz os pedidos de conexão e os aceites (ver [Notificações](#notificacoes)). Com mensagens não lidas, o título da aba do navegador mostra o total. Cada pessoa pode ter até **10 abas ou aparelhos** conectados ao chat ao mesmo tempo; ao abrir mais um, o mais antigo deixa de receber em tempo real.

## Seu status no chat

O status fica no painel da foto, na linha das abas **Conversas | Pessoas**, à direita, no botão com a bolinha colorida (**Seu status no chat**). Três você escolhe; o quarto, **Ausente**, é automático:

| Status | Cor | O que é |
|---|---|---|
| **Disponível** (padrão) | Verde | *"Aparece em Pessoas e recebe avisos"*. Recebe conversa nova e pedido de conexão, com som, janela que abre sozinha e e-mail |
| **Ausente** | Amarelo | Automático: depois de **10 minutos sem atividade**. Tudo continua chegando como em Disponível. Não está no seletor e nunca aparece por cima de Ocupado ou Indisponível |
| **Ocupado** | Vermelho | *"Aparece como ocupado; mensagens chegam sem som"*. Continua recebendo conversa nova, pedido de conexão e e-mail, mas **sem som** e **sem a janela abrir sozinha** |
| **Indisponível** | Cinza | *"Ninguém vê você; sem avisos"*. **Impede conversa nova** e pedido de conexão; as conversas que já existem continuam |

**Todo mundo começa Disponível**, inclusive quem já era membro antes de o chat chegar: o chat funciona sem ninguém configurar nada. Cada pessoa muda quando quiser, e a escolha nunca é sobrescrita. A mudança vale na hora em todas as suas abas; se não der certo, o status volta ao anterior com *"Não foi possível mudar o status. Tente de novo."*

**Ausente** vem sozinho quando você para de mexer (mouse, teclado, aba visível) por 10 minutos: a sua foto mostra a bolinha amarela e, embaixo do status, *"Ausente: sem atividade nesta aba há 10 min. Volta a Disponível quando você mexer."* Para os outros, você só aparece ausente quando **todas** as suas abas e aparelhos estão parados. Quem escolheu Ocupado ou Indisponível continua assim.

Na primeira vez que você abre o painel, um aviso embaixo do status explica: *"Você aparece como disponível para conversar. Mude aqui quando quiser."* **Entendi** (ou qualquer mudança de status) fecha o aviso, que não volta.

| | Disponível ou Ausente | Ocupado | Indisponível |
|---|---|---|---|
| Aparece em **Pessoas** para os outros | Sim, online (verde, ou amarelo com *"ausente"*) | Sim, online em vermelho, com *"ocupado"* | **Nunca** |
| Vê a lista **Pessoas** | Sim | Sim | Não (*"Você está indisponível: ninguém vê você aqui e a lista fica fechada. Mude o status acima para ver quem está por aqui."*) |
| Alguém pode abrir uma conversa **nova** ou pedir conexão a você | Sim | Sim | Não |
| Recebe mensagens nas conversas que já tem | Sim | Sim | **Sim**: você lê e responde quando abrir o painel |
| Número na foto e no título da aba | Sim | Sim | Não |
| Som e janela que abre sozinha | Sim | **Não** | Não |
| E-mail de mensagem | Sim | Sim | **Não** |

### O que os outros veem: online e visto por último

Em **Pessoas**, em **Conversas** e no topo da janela da conversa, cada pessoa aparece como no WhatsApp:

| Situação | Bolinha | O que aparece |
|---|---|---|
| Online e Disponível | Verde | *"online"* |
| Online e Ocupado | Vermelha | *"ocupado"* |
| Online e Ausente | Amarela | *"ausente"* |
| Fora do app, com horário | Cinza | *"visto por último hoje às 14:32"* (ou *ontem às…*, o dia da semana, ou a data, quando foi antes) |
| Fora do app, sem horário | Cinza | *"offline"* |

Na janela da conversa, que é estreita, a frase fica curta (*"visto hoje às 14:32"*), e a frase inteira aparece ao parar o mouse em cima. O horário é arredondado para o minuto.

**Indisponível e bloqueado parecem offline.** Para os outros, quem está offline, quem escolheu **Indisponível** e quem bloqueou (ou foi bloqueado) aparecem do mesmo jeito: bolinha cinza, com o último horário ou *"offline"*. Ninguém descobre que você escolheu Indisponível nem que bloqueou alguém. Entre duas pessoas com bloqueio, o horário nunca aparece.

**Mostrar quando estive online por último**, na engrenagem **Configurações do chat**, vem ligado. Desligado, ninguém vê o seu horário, e **você também não vê o dos outros** (*"Se desligar, você também não vê o dos outros"*): todo mundo fora do app aparece só como *"offline"*.

## Pessoas

A aba **Pessoas** do **Chat** lista quem está **disponível para conversar** na comunidade:

- primeiro a **Equipe**, depois os **Membros**, cada título com quantas pessoas há no grupo (*"Equipe · 28"*, *"Membros · 79"*), acompanhando a busca; em cada grupo, **online** (verde) primeiro, depois **offline** (cinza), por nome; o número na aba é o total de pessoas online;
- **Buscar pelo nome** filtra a lista pelo nome que aparece no perfil (a equipe também encontra pelo e-mail), e o resto carrega conforme você rola;
- só aparece quem ligou **Disponível para conversar** (*"Só aparece quem ligou "Disponível para conversar"."*), sem as pessoas que você bloqueou ou que bloquearam você;
- só vê a lista quem também está disponível.

Quem é da equipe tem um anel na cor da comunidade em volta da foto e uma etiqueta com o papel (**Proprietário**, **Administrador**, **Moderador** ou **Financeiro**), em **Pessoas**, em **Conversas** e nas abas da barra **Mensagens** (no topo da janela da conversa, só o anel). Mensagens não lidas aparecem numa bolha à direita de cada contato (até **99+**), com o nome em negrito.

A lista se atualiza sozinha: quem fecha o app passa a offline em até 2 minutos; quem fica indisponível some na hora. Cada linha traz só a pessoa e o status: **clicar na pessoa abre a janela da conversa** (a que já existe ou, com quem você ainda não falou, uma janela vazia; a conversa só é criada quando você envia a primeira mensagem). Os pedidos de conexão recebidos são respondidos no [sino](#notificacoes).

## Conversar

1. Clique na sua foto, no topo, abra a aba **Pessoas** e toque na pessoa (com **Precisa adicionar**, depois de conectados).
2. Escreva em **Escreva uma mensagem** e clique em **Enviar** (ou Enter; Shift+Enter quebra a linha).

A mensagem é texto simples, de até **4.000 caracteres**; acima disso, o campo avisa e não envia. Enquanto a outra pessoa escreve, aparece **digitando…**. As mensagens antigas carregam conforme você rola a conversa para cima.

A aba **Conversas** lista todas as suas conversas, a mais recente primeiro, com a foto e o status da pessoa, a última mensagem, a hora e o número de não lidas. Abrir a conversa marca como lida.

Também dá para começar pelo **cartão de perfil** de alguém (o que abre ao clicar no nome ou na foto): o botão **Enviar mensagem** aparece **só quando você pode escrever para aquela pessoa**: o chat está ligado na comunidade, ela está **Disponível para conversar**, a regra de quem pode iniciar deixa você, nenhum dos dois bloqueou o outro e, com **Precisa adicionar**, vocês estão conectados. Em qualquer outro caso o botão simplesmente não aparece, sem dizer o motivo, para não revelar se a pessoa está disponível. A bolinha verde de online no cartão também só aparece para quem está disponível.

> [!NOTE]
> Sem a conexão em tempo real (rede instável, por exemplo), a conversa avisa *"Sem conexão em tempo real: as mensagens novas chegam a cada 30 segundos."* Nada se perde: a mensagem enviada chega quando a conexão volta ou na próxima atualização.

## Precisa adicionar: conexões

O proprietário e o administrador escolhem, em **Para conversar** (ver [Para a equipe](#para-a-equipe-ligar-desligar-e-quem-inicia)), se as pessoas conversam direto (**Livre**, o padrão) ou se precisam **se adicionar antes** (**Precisa adicionar**), como numa rede de contatos. Com **Precisa adicionar**, a janela da conversa com quem não está conectado com você mostra no topo uma faixa com o botão do momento, e o campo de escrever fica travado: *"Para escrever, vocês precisam estar conectados."*

| Botão | Quando | O que acontece |
|---|---|---|
| **Adicionar** | Vocês não estão conectados | Envia o pedido; a outra pessoa recebe a notificação no sino e, se estiver disponível, um e-mail |
| **Pedido enviado** | Você já pediu | **Cancelar pedido** desfaz |
| **Aceitar** / **Recusar** | A pessoa pediu a você (*"Quer se conectar com você"*) | Na faixa ou no [sino](#notificacoes). Aceitar conecta os dois; recusar não avisa ninguém |
| Nenhum | Vocês estão conectados | A faixa some e você escreve normalmente |

- **Recusar é silencioso**: quem pediu continua vendo **Pedido enviado**, sem saber que foi recusado, e pedir de novo não gera aviso nem e-mail.
- **Pedidos cruzados se aceitam**: se você pede conexão a quem já tinha pedido a você, a conexão fica aceita na hora.
- Quem não pode iniciar conversas (regra de **Quem pode iniciar**) também não pode adicionar, e só dá para adicionar quem está **Disponível para conversar**.
- **Bloquear** desfaz a conexão (ou o pedido) e impede um pedido novo.
- **A equipe é sempre alcançável**: qualquer pessoa pode escrever para quem é da equipe (proprietário, administrador, moderador e financeiro) sem conexão, respeitando a disponibilidade, os bloqueios, a regra de quem pode iniciar e os limites. A equipe responde numa conversa que já existe sem conexão, mas para começar uma conversa com um membro também precisa estar conectada.
- **Quem está no mesmo Networking conversa sem conexão**: duas pessoas ativas ou pausadas no mesmo espaço de [Networking](/espacos/networking#chat-entre-participantes) abrem conversa e escrevem sem pedido, com a disponibilidade, os bloqueios, a regra de quem pode iniciar e os limites valendo. Quando uma sai do programa, sem outro programa em comum nem conexão aceita, a conversa fica só para leitura. Num programa de mentoria, quem a equipe remove do programa também perde a conversa sem conexão com os mentores dele (só leitura, com o histórico guardado) e volta a ver a página deles no modo limitado, até um mentor aceitar uma conexão; pela API, `403` `notParticipant`.

**Remover conexão.** Com **Precisa adicionar**, o menu **⋯** da janela da conversa com uma pessoa conectada tem **Remover conexão**. A confirmação pergunta *"Remover a conexão com {nome}?"* e explica: *"A conversa continua guardada, mas no modo "Precisa adicionar" vira só leitura e o perfil completo deixa de aparecer para os dois. Ninguém é avisado. Para se conectar de novo, é preciso esperar 24 horas."* **Remover** confirma; **Cancelar** desiste. Qualquer um dos dois pode remover.

**Conversa sem conexão fica só para leitura.** Ao trocar de **Livre** para **Precisa adicionar**, as conversas que já existiam continuam no histórico, mas quem não está conectado vê a faixa da conexão no topo da janela e o campo travado. Voltar para **Livre** libera tudo na hora.

**O perfil depende da conexão.** Com **Precisa adicionar**, quem não está conectado com você vê do seu perfil só o **nome**, a **foto**, a **frase do perfil** e o **cargo**, com *"Conecte-se para ver o perfil completo."* e o botão **Adicionar**; o resto (e-mail, telefone, campos personalizados, grupos, tags, redes) aparece só para as conexões aceitas, no app, na API e no assistente de IA. **A equipe sempre vê o perfil completo**, conectada ou não. Com **Livre**, nada muda no perfil.

Pedidos e conexões valem por comunidade: a mesma pessoa em outra comunidade começa sem conexão.

## Notificações

O sino se atualiza na hora, sem recarregar a página, mesmo com o chat desligado.

O **sino** no cabeçalho reúne as notificações **desta comunidade**, com o número das não lidas:

- *"{nome} quer se conectar com você"*, com **Aceitar** e **Recusar** na própria notificação: é aqui que você responde os pedidos recebidos, e eles somem depois de respondidos;
- *"{nome} aceitou o seu pedido de conexão"*, que abre a conversa.

Abrir uma notificação marca como lida, e **Marcar todas como lidas** zera o contador. As notificações chegam na hora, sem recarregar a página. Outra comunidade não vê estas notificações, e cada pessoa só vê as suas.

## Confirmação de leitura

Na engrenagem **Configurações do chat**, no topo do painel da foto, fica **Confirmação de leitura**, desligada por padrão: *"Quem conversa com você vê quando você leu. Desligado, você também não vê a dos outros."* O **Visto** embaixo da sua mensagem só aparece quando **as duas pessoas** ligaram; com uma só, ninguém vê.

## Sons e conversas que abrem sozinhas

- **Sons.** Um som curto toca quando você envia e quando chega mensagem, um por rajada de mensagens, e não toca quando você já está lendo aquela conversa nem enquanto está **Ocupado** ou **Indisponível**. **Sons** fica na engrenagem **Configurações do chat**, ligado por padrão. O navegador só deixa tocar som depois do seu primeiro clique na página.
- **Conversa que abre sozinha (computador).** Quando chega mensagem numa conversa que não está aberta, a janela dela abre, sem remover o cursor de onde você está; uma minimizada continua minimizada, só o número cresce, e uma fechada reabre. Enquanto você está **Ocupado** ou **Indisponível**, nada abre sozinho: a mensagem só aumenta o número na sua foto.
- **Cursor no lugar.** Ao abrir uma conversa, o cursor já fica no campo de escrever.
- Em **Conversas**, cada contato mostra o número de mensagens não lidas.

## Apagar uma mensagem

Na sua mensagem, abra (no computador, passe o mouse sobre ela) **Opções da mensagem** e clique em **Apagar mensagem**. Depois de confirmar, ela vira **Mensagem apagada** para vocês dois; o resto da conversa continua. Não tem volta, e você só apaga as suas, nunca as da outra pessoa. Não há como editar uma mensagem enviada.

## Menu da conversa e limpar o histórico

O menu **⋯** no topo da janela da conversa tem **Ver perfil** (o cartão de perfil da pessoa), **Limpar histórico**, **Remover conexão** (só com **Precisa adicionar**, ver [Remover conexão](#precisa-adicionar-conexoes)) e **Bloquear** ou **Desbloquear** (ver [Bloquear](#bloquear-e-desbloquear)).

**Limpar histórico** pergunta *"Limpar o histórico?"* e explica: *"As mensagens até agora somem só para você. {nome} continua vendo a conversa inteira."* **Limpar** confirma. Nada é apagado: as mensagens até ali só deixam de aparecer para você (na conversa, na prévia e nas não lidas), as novas continuam chegando, e a outra pessoa não é avisada. Funciona em qualquer modo, inclusive com bloqueio.

## Bloquear e desbloquear

Na janela da conversa, abra o menu **⋯** (**Opções da conversa**) e clique em **Bloquear**. Com o bloqueio:

- nenhum dos dois consegue mais escrever ao outro; quem foi bloqueado vê só *"Não é possível enviar mensagens para esta pessoa."*, sem dizer por quê;
- vocês somem de **Pessoas** um do outro, e a conexão (ou o pedido), se havia, acaba;
- **ninguém é avisado**, nem a outra pessoa, nem a equipe; a conversa fica guardada.

Bloquear é pessoal, não é denúncia: ninguém lê nada. Para desfazer, **Desbloquear** na própria conversa ou em **Configurações do chat › Pessoas bloqueadas**.

## Aviso por e-mail

Quem está **Disponível para conversar** e não está com a comunidade aberta recebe um e-mail quando chega mensagem: *"Maria te mandou mensagem em <comunidade>"*, com o número de não lidas e o botão **Abrir conversa**. O e-mail **nunca traz o texto** da mensagem.

- Sai **10 minutos** depois da primeira mensagem não lida; se você ler antes, não sai.
- No máximo **um por conversa a cada 6 horas**.

Com **Precisa adicionar**, um pedido de conexão novo também manda e-mail: *"Maria quer se conectar com você em <comunidade>"*, com o botão **Ver pedido**, que abre o sino das notificações no app. No máximo **um por par de pessoas a cada 24 horas**; pedir de novo depois de uma recusa não manda nada.

- Quem está indisponível **não recebe** e-mail nenhum do chat. Quem está **Ocupado** ou **Ausente** recebe normalmente.
- Os dois avisos são da categoria **Mensagens** de [E-mails desta comunidade](/notificacoes/emails-desta-comunidade), ligada por padrão. O link do rodapé desliga só ela.

O botão do e-mail de mensagem abre o app direto na conversa (`/_/chat/{id}`); sem login, pede para entrar primeiro.

## Limites contra spam

Para ninguém inundar a comunidade de pedidos, primeiros contatos ou mensagens repetidas, cada pessoa tem limites, contados por comunidade e iguais no app e no assistente de IA:

| O quê | Limite |
|---|---|
| Pedidos de conexão | **20 por dia** e **100 por semana** |
| Pedidos esperando resposta ao mesmo tempo | **200**; para pedir mais, cancele alguns |
| Conversas novas (a primeira mensagem para quem você ainda não falou) | **10 por hora** e **30 por dia**; as conversas que você já tem nunca contam |
| Mensagens | **30 por minuto** |
| O mesmo texto para pessoas diferentes | **5 por hora** |

- Quem entrou na comunidade **há menos de 24 horas** tem **metade** dos limites de pedidos de conexão e de conversas novas.
- A **equipe** (proprietário, administrador, moderador e financeiro) tem **o dobro** de todos os limites.
- Ao passar de um limite, a mensagem diz qual foi e quando libera, no fuso horário da comunidade: *"Você chegou ao limite de 10 conversas novas por hora. Tente de novo às 15:42. As conversas que você já tem continuam livres."*

## Para a equipe: ligar, desligar e quem inicia

O proprietário e o administrador encontram o cartão **Mensagens** em **Configurações › Recursos**:

| Campo | O que faz |
|---|---|
| **Chat ligado** | Ligado por padrão. Desligado, o chat some para todos (a foto abre só **Minha Conta**, **Sair** e os itens do seu papel); as conversas ficam guardadas e voltam quando você religar |
| **Quem pode iniciar uma conversa** | **Todos os membros** (padrão), **Membros com plano ativo** (com assinatura ou compra que dá acesso) ou **Só a equipe**. Responder uma conversa que já existe é sempre permitido |
| **Para conversar** | **Livre** (padrão): qualquer pessoa disponível pode receber uma conversa. **Precisa adicionar**: primeiro uma pessoa adiciona a outra; depois do aceite, as duas conversam e veem o perfil completo (ver [Precisa adicionar](#precisa-adicionar-conexoes)) |

Com **Só a equipe** ou **Membros com plano ativo**, quem não se encaixa vê em **Pessoas** *"Nesta comunidade, só a equipe inicia conversas. Você pode responder as que receber."* (ou a frase do plano ativo). O moderador e o membro não veem esse cartão.

Não há fila de moderação no chat: se alguém incomoda, a pessoa bloqueia, e a comunidade pode desligar o chat ou exigir conexão. Contra spam, valem os [limites do chat](#limites-contra-spam).

## Pedir acesso à equipe

Numa seção ou num espaço com cadeado que só a equipe libera (fechado por grupo, ou sem nada à venda), a tela de acesso exclusivo traz o botão **Fale com a equipe** (ver [Visibilidade e acesso](/conceitos/visibilidade-e-acesso#o-botao-fale-com-a-equipe)). Ele aparece só com o chat ligado e alguém da equipe para atender, e:

- abre uma conversa direta com quem atende: o primeiro administrador online, depois o primeiro moderador online; sem ninguém online, o proprietário. Sempre alguém **Disponível para conversar** e sem bloqueio entre os dois; o financeiro nunca atende;
- reaproveita a conversa que você já tem com alguém da equipe que pode atender;
- deixa no campo o rascunho *"Quero acesso a Clube"*, sem enviar;
- ignora **Quem pode iniciar uma conversa** e conta no limite de **10 conversas novas por hora** (só quando a conversa é nova).

## Privacidade

- As mensagens são **privadas entre as duas pessoas** da conversa. Ninguém da equipe da comunidade, nem o proprietário, lê as conversas dos outros, pelo app, pela API ou pelo [assistente de IA](#assistente-de-ia).
- O texto das mensagens não vai para e-mails, notificações, registros de atividade nem relatórios.
- Aparecer como disponível é o padrão, e cada pessoa desliga quando quiser; quem desliga não aparece para ninguém.
- Com **Precisa adicionar**, só as conexões aceitas (e a equipe) veem o perfil completo.
- A mesma pessoa em duas comunidades tem conversas, conexões e notificações separadas em cada uma.

Ver [Termos de uso › Dados pessoais](/conceitos/termos-de-uso#dados-pessoais).

## Na API

As rotas ficam em `/api/chat` (preferências, pessoas, quem está online, conversas, mensagens, bloqueios, conexões e as configurações da comunidade) e em `/api/notifications`, sempre com o `X-CommunityId`:

- `GET /api/chat/members` é o painel **Pessoas**: só para quem está disponível (`403` sem isso), online primeiro, com `q` (nome) e `cursor`; a equipe vem primeiro, e cada pessoa traz `online`, `lastSeenAt`, `canStart` e `isTeam`. `pagination` traz `teamTotal`, `membersTotal`, `teamOnline` e `membersOnline`.
- `GET /api/chat/me` e `PATCH /api/chat/me` trazem `availabilityNoticeSeen`, do aviso de primeira vez, e `chatStatus` (`AVAILABLE`, `BUSY` ou `UNAVAILABLE`), o status escolhido. O `PATCH` aceita `chatStatus`; `AWAY` não se escolhe (`400`), e um `chatAvailable` que contradiz o `chatStatus` na mesma chamada também é `400`. `chatAvailable` continua: é `false` só com `UNAVAILABLE`.
- Cada pessoa de `GET /api/chat/online` e `GET /api/chat/members` (só quando online) e o `other` de uma conversa (só quando online) trazem `status`: `AVAILABLE`, `AWAY` ou `BUSY`. Quem está indisponível ou bloqueado vem sem status. Quem está fora do app traz `lastSeenAt` (arredondado para o minuto) em `GET /api/chat/members`, no `other` da conversa e no `presence.delta` com `online: false`, só quando não há bloqueio e as duas pessoas deixam ligado `chatShowLastSeen` (em `GET`/`PATCH /api/chat/me`, ligado por padrão); senão, `null`. Indisponível sai como offline.
- `/api/chat/connections`: listar, pedir (`POST` com `profileId`), `accept`, `decline` e `DELETE` (cancelar o pedido ou desfazer a conexão). Só as duas pessoas agem sobre a conexão.
- `POST /api/chat/conversations/{id}/clear` limpa o histórico só para quem chama (as duas pessoas da conversa; `404` para qualquer outra), em qualquer modo e mesmo com bloqueio.
- As configurações da comunidade ganham `startMode`: `FREE` (padrão) ou `CONNECTION`. Com `CONNECTION`, conversa nova e mensagem nova sem conexão aceita voltam `403`.
- `/api/notifications`: listar (com `cursor`), `unread-count`, ver, marcar como lida (`PUT /{id}/read` e `PUT /read-all`) e apagar. Cada pessoa só vê as suas.
- Os limites do chat respondem `429` com `errors[0].code` (`limitConnectionsDaily`, `limitConnectionsWeekly`, `limitPendingRequests`, `limitNewConversationsHourly`, `limitNewConversationsDaily`, `limitMessagesPerMinute` ou `limitDuplicateMessage`), `errors[0].limit` e, quando o tempo libera, `errors[0].retryAt` e o cabeçalho `Retry-After` (ver [Respostas e erros › Limites do chat](/api/respostas-e-erros#limites-do-chat)).
- `POST /api/chat/contact-team` (com `spaceId` ou `sectionId`) é o botão **Fale com a equipe**: escolhe quem atende e abre ou reaproveita a conversa direta, sem enviar nada (ver [Pedir acesso à equipe](#pedir-acesso-a-equipe)). A recusa de um espaço ou seção com cadeado traz `canContactTeam`.

A conversa de outra pessoa responde `404` para qualquer papel; com o chat desligado, `403`. `GET /api/members/{id}` traz `chatAvailable`, que diz se você pode escrever para aquela pessoa agora, e, com **Precisa adicionar**, `limited: true` quando você só vê o cartão. Ver a [Referência da API](/api/introducao).

## Assistente de IA

Pelo [MCP](/mcp/o-que-e-o-mcp), o assistente lê e escreve **só as suas conversas**, com as [ferramentas de Mensagens](/mcp/ferramentas-membros#mensagens): as suas preferências e o seu status, as pessoas disponíveis, quem está online (e quem está ausente ou ocupado), conversas, enviar (com confirmação), marcar como lida, apagar e limpar o histórico (com confirmação), bloquear, as conexões (pedir, aceitar, recusar e desfazer, com confirmação), as suas notificações e as configurações da comunidade para o proprietário e o administrador. Ver [Ferramentas › Membros › Mensagens](/mcp/ferramentas-membros#mensagens). `contact_team` abre a conversa com a equipe sobre uma área com cadeado (ver a [receita 97](/mcp/receitas#97-peca-acesso-a-uma-area-com-cadeado)).

**Peça assim:** *"Tenho mensagens não lidas?"* · *"Escreva para a Ana: chego às 15h na reunião."* · *"Quem pediu para se conectar comigo? Aceite o pedido do Bruno."* (ver a [receita 88](/mcp/receitas#88-veja-quem-pediu-conexao-e-aceite)).

## Relacionados

- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)
- [Configurações gerais](/configuracoes/configuracoes-gerais)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Moderação](/membros/moderacao)