# Mensagens

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

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

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

## Onde fica

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

O painel tem, de cima para baixo:

- uma linha com a roda dentada **Definições do chat** (com **Confirmações de leitura**, **Mostrar quando estive online pela última vez**, **Sons** e **Pessoas bloqueadas**), o botão **A Minha Conta** (com o nome escrito) e **Terminar sessão**. Já não há o ícone **O meu perfil**: a sua [página de membro](/membros/seu-perfil) abre por **Ver o meu perfil**, em **A Minha Conta**;
- conforme o seu papel, uma linha com **A minha empresa** (quem está na equipa de uma [empresa](/membros/empresas)), **Eventos que organizo** (quem organiza eventos) e **Envolvimento geral** (quando a comunidade tem o envolvimento geral ligado). Saíram do menu lateral, que agora termina com a comunidade;
- **Procurar conversas**;
- os separadores **Conversas** (com o número por ler) e **Pessoas** (com o número de pessoas online), sublinhados como os separadores do Feed, com o seletor do seu **estado** na mesma linha, à direita. Num ecrã estreito, o seletor encolhe para a bolinha e a seta (o nome do estado aparece ao passar o rato). O painel abre em **Conversas** quando há mensagens por ler e em **Pessoas** quando não há.

Com o chat desligado na comunidade, a fotografia abre só a linha da conta (**A Minha Conta** e **Terminar sessão**) e a dos itens do seu papel. O menu lateral já não tem **A Minha Conta**, **Terminar sessão**, **Faturação** (agora em **A Minha Conta › Faturação**) nem **Reportar problema** (o ícone de inseto no topo).

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

**Ao abrir uma conversa:** em ecrãs abaixo de 1024 px, ela ocupa o ecrã, com **Voltar** para o painel. **No computador (a partir de 1024 px)**, 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 num ecrã de 1280 px com o menu aberto, duas num de 1920 px), e uma nova substitui a mais antiga. Uma conversa minimizada passa a um separador pequeno com a fotografia, o nome e o número por ler; as que não cabem ficam em **+N** (*"Mais N conversas"*). As janelas abertas ficam guardadas neste navegador.

O sino, à esquerda da sua fotografia, traz os pedidos de ligação e as aceitações (ver [Notificações](#notificacoes)). Com mensagens por ler, o título do separador do navegador mostra o total. Cada pessoa pode ter até **10 separadores ou dispositivos** ligados ao chat ao mesmo tempo; ao abrir mais um, o mais antigo deixa de receber em tempo real.

## O seu estado no chat

O estado fica no painel da fotografia, na linha dos separadores **Conversas | Pessoas**, à direita, no botão com a bolinha colorida (**O seu estado no chat**). Três são escolhidos por si; o quarto, **Ausente**, é automático:

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

**Toda a gente começa Disponível**, incluindo 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 é substituída. A mudança vale de imediato em todos os seus separadores; se falhar, o estado volta ao anterior com *"Não foi possível mudar o estado. Tente novamente."*

**Ausente** chega sozinho quando deixa de mexer (rato, teclado, separador visível) durante 10 minutos: a sua fotografia mostra a bolinha amarela e, por baixo do estado, *"Ausente: sem atividade neste separador há 10 min. Volta a Disponível quando mexer."* Para os outros, só aparece ausente quando **todos** os seus separadores e dispositivos estão parados. Quem escolheu Ocupado ou Indisponível continua assim.

Na primeira vez que abre o painel, um aviso por baixo do estado explica: *"Aparece como disponível para conversar. Mude aqui quando quiser."* **Entendi** (ou qualquer mudança de estado) 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 a vermelho, com *"ocupado"* | **Nunca** |
| Vê a lista **Pessoas** | Sim | Sim | Não (*"Está indisponível: ninguém o vê aqui e a lista fica fechada. Mude o estado acima para ver quem está por cá."*) |
| Alguém pode abrir uma conversa **nova** ou pedir-lhe ligação | Sim | Sim | Não |
| Recebe mensagens nas conversas que já tem | Sim | Sim | **Sim**: lê e responde quando abrir o painel |
| Número na fotografia e no título do separador | 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 pela última vez

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 da aplicação, com hora | Cinzenta | *"visto pela última vez hoje às 14:32"* (ou *ontem às…*, o dia da semana, ou a data, quando foi antes) |
| Fora da aplicação, sem hora | Cinzenta | *"offline"* |

Na janela da conversa, que é estreita, a frase fica curta (*"visto hoje às 14:32"*), e a frase inteira aparece ao passar o rato por cima. A hora é arredondada ao minuto.

**Indisponível e bloqueado parecem offline.** Para os outros, quem está offline, quem escolheu **Indisponível** e quem bloqueou (ou foi bloqueado) aparecem da mesma forma: bolinha cinzenta, com a última hora ou *"offline"*. Ninguém descobre que escolheu Indisponível nem que bloqueou alguém. Entre duas pessoas com bloqueio, a hora nunca aparece.

**Mostrar quando estive online pela última vez**, na roda dentada **Definições do chat**, vem ligado. Desligado, ninguém vê a sua hora, e **também não vê a dos outros** (*"Se desligar, também não vê o dos outros"*): toda a gente fora da aplicação aparece só como *"offline"*.

## Pessoas

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

- primeiro a **Equipa**, depois os **Membros**, cada título com quantas pessoas há no grupo (*"Equipa · 28"*, *"Membros · 79"*), acompanhando a pesquisa; em cada grupo, **online** (verde) primeiro, depois **offline** (cinzento), por nome; o número no separador é o total de pessoas online;
- **Procurar pelo nome** filtra a lista pelo nome que aparece no perfil (a equipa também encontra pelo e-mail), e o resto carrega à medida que percorre a lista;
- só aparece quem está disponível (*"Só aparece quem ligou "Disponível para conversar"."*), sem as pessoas que bloqueou ou que o bloquearam;
- só vê a lista quem também está disponível.

Quem é da equipa tem um anel na cor da comunidade à volta da fotografia e uma etiqueta com o papel (**Proprietário**, **Administrador**, **Moderador** ou **Financeiro**), em **Pessoas**, em **Conversas** e nos separadores da barra **Mensagens** (no topo da janela da conversa, só o anel). As mensagens por ler aparecem numa bolha à direita de cada contacto (até **99+**), com o nome a negrito.

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

## Conversar

1. Clique na sua fotografia, no topo, abra o separador **Pessoas** e toque na pessoa (com **Precisa adicionar**, depois de estarem ligados).
2. Escreva em **Escreva uma mensagem** e clique em **Enviar** (ou Enter; Shift+Enter muda de linha).

A mensagem é texto simples, com até **4.000 caracteres**; acima disso, o campo avisa e não envia. Enquanto a outra pessoa escreve, aparece **a escrever…**. As mensagens antigas carregam à medida que percorre a conversa para cima.

O separador **Conversas** lista todas as suas conversas, a mais recente primeiro, com a fotografia e o estado da pessoa, a última mensagem, a hora e o número por ler. Abrir a conversa marca-a como lida.

Também pode começar pelo **cartão de perfil** de alguém (o que abre ao clicar no nome ou na fotografia): o botão **Enviar mensagem** aparece **só quando pode escrever àquela pessoa**: o chat está ligado na comunidade, ela está **Disponível para conversar**, a regra de quem pode iniciar permite-lho, nenhum dos dois bloqueou o outro e, com **Precisa adicionar**, estão ligados. 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. O ponto verde de online no cartão também só aparece para quem está disponível.

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

## Precisa adicionar: ligações

O proprietário e o administrador escolhem, em **Para conversar** (ver [Para a equipa](#para-a-equipa-ligar-desligar-e-quem-inicia)), se as pessoas conversam diretamente (**Livre**, por omissão) ou se precisam de **se adicionar antes** (**Precisa adicionar**), como numa rede de contactos. Com **Precisa adicionar**, a janela da conversa com quem não está ligado a si mostra no topo uma faixa com o botão do momento, e o campo de escrita fica bloqueado: *"Para escrever, precisam de estar ligados."*

| Botão | Quando | O que acontece |
|---|---|---|
| **Adicionar** | Não estão ligados | Envia o pedido; a outra pessoa recebe a notificação no sino e, se estiver disponível, um e-mail |
| **Pedido enviado** | Já pediu | **Cancelar pedido** desfaz |
| **Aceitar** / **Recusar** | A pessoa pediu-lhe (*"Quer ligar-se a si"*) | Na faixa ou no [sino](#notificacoes). Aceitar liga os dois; recusar não avisa ninguém |
| Nenhum | Estão ligados | A faixa desaparece e escreve normalmente |

- **Recusar é silencioso**: quem pediu continua a ver **Pedido enviado**, sem saber que foi recusado, e pedir de novo não gera aviso nem e-mail.
- **Pedidos cruzados aceitam-se**: se pedir ligação a quem já lhe tinha pedido, a ligação fica aceite de imediato.
- Quem não pode iniciar conversas (regra de **Quem pode iniciar**) também não pode adicionar, e só é possível adicionar quem está **Disponível para conversar**.
- **Bloquear** desfaz a ligação (ou o pedido) e impede um pedido novo.
- **A equipa está sempre ao alcance**: qualquer pessoa pode escrever a quem é da equipa (proprietário, administrador, moderador e financeiro) sem ligação, respeitando a disponibilidade, os bloqueios, a regra de quem pode iniciar e os limites. A equipa responde numa conversa que já existe sem ligação, mas para começar uma conversa com um membro também precisa de estar ligada.
- **Quem está no mesmo Networking conversa sem ligação**: duas pessoas ativas ou em pausa 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 a valer. Quando uma sai do programa, sem outro programa em comum nem ligação aceite, a conversa fica só de leitura. Num programa de mentoria, quem a equipa remove do programa também perde a conversa sem ligação com os mentores desse programa (só de leitura, com o histórico guardado) e volta a ver a página deles no modo limitado, até um mentor aceitar uma ligação; pela API, `403` `notParticipant`.

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

**Conversa sem ligação fica só de leitura.** Ao mudar de **Livre** para **Precisa adicionar**, as conversas que já existiam continuam no histórico, mas quem não está ligado vê a faixa da ligação no topo da janela e o campo bloqueado. Voltar a **Livre** liberta tudo de imediato.

**O perfil depende da ligação.** Com **Precisa adicionar**, quem não está ligado a si vê do seu perfil só o **nome**, a **fotografia**, a **frase do perfil** e o **cargo**, com *"Ligue-se para ver o perfil completo."* e o botão **Adicionar**; o resto (e-mail, telefone, campos personalizados, grupos, etiquetas, redes) aparece só às ligações aceites, na aplicação, na API e no assistente de IA. **A equipa vê sempre o perfil completo**, ligada ou não. Com **Livre**, nada muda no perfil.

Pedidos e ligações valem por comunidade: a mesma pessoa noutra comunidade começa sem ligação.

## Notificações

O sino atualiza-se de imediato, 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 por ler:

- *"{nome} quer ligar-se a si"*, com **Aceitar** e **Recusar** na própria notificação: é aqui que responde aos pedidos recebidos, e eles desaparecem depois de respondidos;
- *"{nome} aceitou o seu pedido de ligação"*, que abre a conversa.

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

## Confirmações de leitura

Na roda dentada **Definições do chat**, no topo do painel da fotografia, estão as **Confirmações de leitura**, desligadas por omissão: *"Quem fala consigo vê quando leu. Desligado, também não vê as dos outros."* O **Visto** por baixo da sua mensagem só aparece quando **as duas pessoas** as ligaram; com uma só, ninguém o vê.

## Sons e conversas que abrem sozinhas

- **Sons.** Um som curto toca quando envia e quando chega uma mensagem, um por rajada de mensagens, e não toca quando já está a ler essa conversa nem enquanto está **Ocupado** ou **Indisponível**. **Sons** fica na roda dentada **Definições do chat**, ligado por omissão. O navegador só permite som depois do seu primeiro clique na página.
- **Conversa que abre sozinha (computador).** Quando chega uma mensagem numa conversa que não está aberta, a janela dela abre, sem tirar o cursor de onde está; uma minimizada continua minimizada, só o número cresce, e uma fechada reabre. Enquanto está **Ocupado** ou **Indisponível**, nada abre sozinho: a mensagem só aumenta o número na sua fotografia.
- **Cursor no lugar.** Ao abrir uma conversa, o cursor já fica no campo de escrita.
- Em **Conversas**, cada contacto mostra o número de mensagens por ler.

## Apagar uma mensagem

Na sua mensagem, abra (no computador, passe o rato por cima) **Opções da mensagem** e clique em **Apagar mensagem**. Depois de confirmar, passa a **Mensagem apagada** para os dois; o resto da conversa continua. Não tem volta, e só apaga as suas, nunca as da outra pessoa. Não é possível 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 ligação** (só com **Precisa adicionar**, ver [Remover ligação](#precisa-adicionar-ligacoes)) e **Bloquear** ou **Desbloquear** (ver [Bloquear](#bloquear-e-desbloquear)).

**Limpar histórico** pergunta *"Limpar o histórico?"* e explica: *"As mensagens até agora desaparecem só para si. {nome} continua a ver a conversa inteira."* **Limpar** confirma. Nada é apagado: as mensagens até ali só deixam de aparecer para si (na conversa, na pré-visualização e nas por ler), as novas continuam a chegar, e a outra pessoa não é avisada. Funciona em qualquer modo, incluindo 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 voltar a escrever ao outro; quem foi bloqueado vê só *"Não é possível enviar mensagens para esta pessoa."*, sem dizer porquê;
- desaparecem de **Pessoas** um do outro, e a ligação (ou o pedido), se existia, termina;
- **ninguém é avisado**, nem a outra pessoa, nem a equipa; a conversa fica guardada.

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

## Aviso por e-mail

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

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

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

- Quem está indisponível **não recebe** nenhum e-mail 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 omissão. A ligação do rodapé desliga só essa.

O botão do e-mail de mensagem abre a aplicação diretamente na conversa (`/_/chat/{id}`); sem sessão iniciada, pede para entrar primeiro.

## Limites contra spam

Para ninguém inundar a comunidade de pedidos, primeiros contactos ou mensagens repetidas, cada pessoa tem limites, contados por comunidade e iguais na aplicação e no assistente de IA:

| O quê | Limite |
|---|---|
| Pedidos de ligação | **20 por dia** e **100 por semana** |
| Pedidos à espera de resposta ao mesmo tempo | **200**; para pedir mais, cancele alguns |
| Conversas novas (a primeira mensagem para quem ainda não falou) | **10 por hora** e **30 por dia**; as conversas que 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 ligação e de conversas novas.
- A **equipa** (proprietário, administrador, moderador e financeiro) tem **o dobro** de todos os limites.
- Ao passar um limite, a mensagem diz qual foi e quando liberta, no fuso horário da comunidade.

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

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

| Campo | O que faz |
|---|---|
| **Chat ligado** | Ligado por omissão. Desligado, o chat desaparece para todos (a fotografia abre só **A Minha Conta**, **Terminar sessão** e os itens do seu papel); as conversas ficam guardadas e voltam quando o voltar a ligar |
| **Quem pode iniciar uma conversa** | **Todos os membros** (por omissão), **Membros com plano ativo** (com subscrição ou compra que dá acesso) ou **Só a equipa**. Responder a uma conversa que já existe é sempre permitido |
| **Para conversar** | **Livre** (por omissão): qualquer pessoa disponível pode receber uma conversa. **Precisa adicionar**: primeiro uma pessoa adiciona a outra; depois da aceitação, as duas conversam e veem o perfil completo (ver [Precisa adicionar](#precisa-adicionar-ligacoes)) |

Com **Só a equipa** ou **Membros com plano ativo**, quem não se enquadra vê em **Pessoas** *"Nesta comunidade, só a equipa inicia conversas. Pode responder às que receber."* (ou a frase do plano ativo). O moderador e o membro não veem este 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 ligação. Contra spam, valem os [limites do chat](#limites-contra-spam).

## Pedir acesso à equipa

Numa secção ou num espaço com cadeado a que só a equipa dá acesso (fechado por grupo, ou sem nada à venda), o ecrã de acesso exclusivo traz o botão **Fale com a equipa** (ver [Visibilidade e acesso](/conceitos/visibilidade-e-acesso#o-botao-fale-com-a-equipa)). Aparece só com o chat ligado e alguém da equipa 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 já tem com alguém da equipa 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 equipa da comunidade, nem o proprietário, lê as conversas dos outros, pela aplicação, pela API ou pelo [assistente de IA](#assistente-de-ia).
- O texto das mensagens não vai para e-mails, notificações, registos de atividade nem relatórios.
- Aparecer como disponível é o comportamento por omissão, e cada pessoa desliga quando quiser; quem desliga não aparece a ninguém.
- Com **Precisa adicionar**, só as ligações aceites (e a equipa) veem o perfil completo.
- A mesma pessoa em duas comunidades tem conversas, ligações e notificações separadas em cada uma.

Ver [Termos de utilização › 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, ligações e as definiçõ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 equipa 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 da primeira vez, e `chatStatus` (`AVAILABLE`, `BUSY` ou `UNAVAILABLE`), o estado escolhido. O `PATCH` aceita `chatStatus`; `AWAY` não se escolhe (`400`), e um `chatAvailable` que contradiga o `chatStatus` na mesma chamada também dá `400`. `chatAvailable` mantém-se: é `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 estado. Quem está fora da aplicação traz `lastSeenAt` (arredondado ao 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 mantêm ligado `chatShowLastSeen` (em `GET`/`PATCH /api/chat/me`, ligado por omissão); caso contrário, `null`. Indisponível sai como offline.
- `/api/chat/connections`: listar, pedir (`POST` com `profileId`), `accept`, `decline` e `DELETE` (cancelar o pedido ou desfazer a ligação). Só as duas pessoas agem sobre a ligaçã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 definições da comunidade ganham `startMode`: `FREE` (por omissão) ou `CONNECTION`. Com `CONNECTION`, conversa nova e mensagem nova sem ligação aceite respondem `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 liberta, `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 equipa**: escolhe quem atende e abre ou reaproveita a conversa direta, sem enviar nada (ver [Pedir acesso à equipa](#pedir-acesso-a-equipa)). A recusa de um espaço ou secçã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 pode escrever àquela pessoa agora, e, com **Precisa adicionar**, `limited: true` quando 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 estado, 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 ligações (pedir, aceitar, recusar e desfazer, com confirmação), as suas notificações e as definiçõ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 equipa sobre uma área com cadeado (ver a [receita 97](/mcp/receitas#97-peca-acesso-a-uma-area-com-cadeado)).

**Peça assim:** *"Tenho mensagens por ler?"* · *"Escreva à Ana: chego às 15h à reunião."* · *"Quem pediu para se ligar a mim? 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)
- [Definições gerais](/configuracoes/configuracoes-gerais)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [Moderação](/membros/moderacao)