# Canal

> O módulo de espaço Canal, do separador Comunidade. A conversa do grupo em tempo real, com a mensagem mais recente em baixo, threads, reações com qualquer emoji, menções, fotografia e vídeo, não lidas no menu, quem só lê e reage, limites, o e-mail de menções e respostas, e as mesmas ações pelo assistente e pela API.

O **Canal** é a conversa rápida do grupo dentro da comunidade, em vez do grupo de mensagens de fora: as mensagens chegam em tempo real, a mais recente fica em baixo, e cada mensagem pode tornar-se uma **thread** com as respostas dela.

É um [módulo de espaço](/conceitos/modulos) do separador **Comunidade** de **Adicionar Espaço**. **Um espaço é um canal**: para ter vários canais (#geral, #avisos, #turma-2026), crie vários espaços e use a [secção](/conceitos/secoes) do menu para os agrupar. Quem cria o espaço: proprietário ou administrador.

## Canal, Feed ou Mensagens?

| | [Feed](/espacos/feed) | **Canal** | [Mensagens](/membros/mensagens) |
|---|---|---|---|
| O que é | Mural de publicações | Conversa rápida do grupo | Conversa privada entre duas pessoas |
| Ordem | Mais recente em cima | Mais recente **em baixo**, como um chat; abre na primeira não lida | Mais recente em baixo |
| Respostas | Comentários por baixo da publicação | **Threads** presas a uma mensagem | Na própria conversa |
| Quem lê | Quem abre o espaço | Quem abre o espaço | Só as duas pessoas |
| Bom para | Anúncios, discussões que precisam de durar, conteúdo | "Alguém sabe…?", combinar, conversa de turma, equipa ou evento | Conversa um a um |

**A regra prática:** se a pessoa espera resposta nos próximos minutos, é Canal; se espera que o texto seja encontrado na semana seguinte, é Feed; se não quer que o grupo veja, é Mensagens.

## Quem pode o quê

| Ação | Quem |
|---|---|
| Ler o canal e as threads | Quem abre o espaço (a visibilidade do espaço). O visitante sem sessão iniciada não lê o canal, nem em espaço público |
| Escrever, responder na thread, enviar fotografia e vídeo | Quem o **Quem pode publicar** do espaço permite: **Qualquer pessoa**, **Equipa** (proprietário, administrador, moderador e financeiro) ou **Admins** |
| Reagir, seguir thread | Quem abre o espaço, mesmo sem poder escrever |
| Editar uma mensagem | Só o autor, a qualquer momento |
| Apagar uma mensagem | O autor; e o proprietário, o administrador e o moderador apagam qualquer mensagem do espaço |

Quem não pode escrever não vê a caixa de mensagem, nem no canal nem na thread, e encontra *"Neste canal só quem tem permissão escreve. Pode ler e reagir às mensagens."* É assim que se faz um canal de avisos: **Quem pode publicar = Equipa** (ou **Admins**), e o resto da comunidade lê e reage.

O canal não tem aprovação prévia: a moderação faz-se depois de publicado, apagando.

## Como funciona

### A conversa

O canal abre na **primeira mensagem não lida**, marcada pela linha **Novas mensagens**, ou no fim, se já leu tudo. As mensagens agrupam-se por dia (**Hoje**, **Ontem**, a data), e as mais antigas carregam quando desliza para cima. Se chega uma mensagem nova enquanto está longe do fim, aparece **Ir para o fim**.

Quando o canal está vazio, mostra *"Comece a conversa do grupo"*; o início do histórico diz *"Este é o início de #nome"*.

### Threads

**Responder na thread** abre a conversa daquela mensagem: num painel ao lado do canal quando há espaço, ou em ecrã inteiro, com **Voltar**, no ecrã estreito. No telemóvel, tocar numa mensagem que tem thread (ou em **N respostas**) abre a thread em ecrã inteiro; o voltar do sistema também fecha. A mensagem mostra **N respostas** e, quando há respostas que ainda não leu, **N respostas novas**.

As threads têm **um nível**: pode responder a uma mensagem do canal, não a uma resposta.

Segue automaticamente a thread da sua mensagem, as threads em que respondeu e aquelas em que foi mencionado. Na thread, **Seguir thread** e **Deixar de seguir** mudam isso. Quem segue recebe as respostas no sino e, se não as ler, por e-mail.

### Reações

Passe o rato pela mensagem para as **7 reações rápidas**, ou **Mais emojis** para escolher qualquer emoji, com pesquisa. No telemóvel, **toque e mantenha** a mensagem: sobe de baixo uma folha com as 7 reações, o **+** (todos os emojis), **Responder na thread**, **Copiar texto**, **Editar mensagem** e **Apagar mensagem**; tocar e manter uma reação mostra quantas pessoas reagiram com ela. Cada reação mostra o emoji e quantas pessoas reagiram; clicar outra vez retira a sua. Cada mensagem aceita até 20 emojis diferentes.

### Menções

Escreva `@` e o início do nome: a lista **Pessoas para mencionar** mostra só quem pode abrir o espaço. A pessoa mencionada recebe no sino *"Fulano mencionou-o em #nome"* e, se não ler, um e-mail. Mencionar quem não abre o espaço não avisa ninguém. Cada mensagem avisa no máximo 20 pessoas.

**O cartão da pessoa.** Clicar numa menção **@Nome**, ou no nome ou na fotografia de quem escreveu, abre um cartão pequeno com a fotografia, o nome, o cargo e o [estado no chat](/membros/mensagens#o-seu-estado-no-chat) (*"online"*, *"ocupado"*, *"ausente"* ou *"Offline"* com o visto pela última vez), e dois botões:

- **Enviar mensagem**, que abre a conversa com a pessoa seguindo as regras do chat. Com **Precisa adicionar**, no lugar dele aparece o botão da ligação (**Adicionar**, **Pedido enviado**, **Aceitar**; ver [ligações](/membros/mensagens#precisa-adicionar-ligacoes)). Quando não é possível escrever, o botão fica desativado com o motivo: *"Esta pessoa não está a receber conversas novas agora."* ou, se estiver Indisponível, *"Está Indisponível no chat. Mude o seu estado para conversar."*
- **Ver perfil**, que leva à [página de membro](/membros/seu-perfil).

Uma menção a si próprio mostra só **Ver perfil**.

### Fotografia e vídeo

Na caixa de mensagem:

- **Adicionar fotografia**: até **10 fotografias** por mensagem (JPG, PNG, WebP ou GIF), de até 50 MB cada.
- **Adicionar vídeo**: **1 vídeo** por mensagem, enviado como ficheiro (MP4, WebM ou MOV, até 350 MB) ou gravado na hora em **Gravar vídeo**, até 10 minutos, como um [Drop](/espacos/drops).

O botão de emoji, ao lado, insere um emoji no texto.

### Formatação

O texto aceita uma formatação simples, que aparece já formatada na mensagem:

| Escreva | Para |
|---|---|
| `*texto*` ou `**texto**` | **negrito** |
| `_texto_` | *itálico* |
| `` `texto` `` | `código` |
| `https://…` | ligação, que abre noutro separador |

As quebras de linha ficam como foram escritas: no computador, **Shift + Enter** quebra a linha e **Enter** envia; no telemóvel, **Enter** quebra a linha e **Enviar** envia. Os marcadores só valem no limite de uma palavra (um `_` no meio de `nome_do_ficheiro` fica como está). Qualquer outra marcação aparece como texto.

### Editar e apagar

Na mensagem, **Mais ações** › **Editar** ou **Apagar** (no telemóvel, toque e mantenha a mensagem e escolha **Editar mensagem** ou **Apagar mensagem**).

- **Editar**: só o autor, sem prazo. **Enter** guarda, **Esc** cancela. A mensagem passa a mostrar **(editada)**.
- **Apagar**: no lugar dela fica o aviso *mensagem apagada*, e as fotografias e o vídeo saem com ela. Se a mensagem tinha thread, a thread continua, com todas as respostas, presa ao aviso.

Apagar a sua própria mensagem esconde-a de imediato, com **Desfazer** durante 5 segundos (*"Mensagem apagada"*); uma mensagem apagada sem thread desaparece da conversa.

### Não lidas

No menu, o canal com mensagens novas fica a **negrito**, com o número de **menções não lidas** ao lado. Ler o canal até ao fim, ou a thread, limpa o que foi lido. A sua própria mensagem nunca conta como não lida, e quem acabou de entrar no espaço não herda o histórico como não lido.

**Silenciar canal**, no topo do canal: as menções e as respostas desse canal deixam de gerar aviso e e-mail, e as mensagens por ler continuam a contar. **Voltar a receber avisos** desfaz. O topo mostra também quem está na conversa e **Buscar no canal**, que procura nas mensagens carregadas.

### Limites

| Limite | Valor |
|---|---|
| Tamanho de uma mensagem ou resposta | 4000 caracteres (o contador avisa quando passa) |
| Mensagens e respostas por minuto | 30 por pessoa; a equipa tem o dobro, quem entrou na comunidade há menos de 24 horas tem metade |
| O mesmo texto | 3 vezes por hora no mesmo canal |
| Mensagens com fotografia ou vídeo | 20 por hora |
| Vídeos | 10 por hora |

Passando um limite, a mensagem não sai e aparece *"Atingiu o limite de mensagens. Aguarde um pouco."* (ou o aviso do limite de multimédia).

### E-mail

A menção e a resposta numa thread que segue chegam **ao sino, na hora**. Se não as ler em 10 minutos, chega um e-mail, no máximo **um por canal a cada 6 horas** (*"Foi mencionado em #geral"*, *"Respostas novas em #geral"* ou *"Menções e respostas em #geral"*). O e-mail **não traz o texto** da mensagem: leva-o ao canal. Cada mensagem nova do canal não gera e-mail.

Pode desligar na categoria **Canais: menções e respostas**, em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade), ou pela ligação do rodapé.

## Passo a passo

### Criar um canal

*Papel: proprietário ou administrador.*

1. No menu, em **Adicionar Espaço**, abra o separador **Comunidade** e escolha **Canal**.
2. Indique o nome (passa a ser o `#nome` do canal), a descrição, a visibilidade e o **Quem pode publicar**.
3. Crie. O espaço abre diretamente na conversa.

Não há a escolha "um ou vários" nem aprovação prévia: o espaço já é o canal.

### Enviar uma mensagem

1. Abra o canal e escreva em **Mensagem para #nome**.
2. Se quiser, **Adicionar fotografia**, **Adicionar vídeo** ou **Gravar vídeo**, e `@` para mencionar.
3. **Enviar** (no computador, também **Enter**).

### Responder numa thread

1. Na mensagem, **Responder na thread**.
2. Escreva em **Responder na thread** e envie.
3. **Fechar thread** volta ao canal.

## Exemplos

**#geral de uma turma.** **Quem pode publicar = Qualquer pessoa**: os alunos tiram dúvidas rápidas, combinam o grupo de estudo e reagem aos recados do professor. A dúvida que rendeu passa a thread e não atropela o resto da conversa.

**#avisos do coworking.** **Quem pode publicar = Equipa**: a receção avisa da manutenção do elevador com uma fotografia; os residentes leem, reagem com 👍 e seguem a thread do aviso para saber quando terminou.

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| Não aparece a caixa de mensagem | O **Quem pode publicar** do espaço não inclui o seu papel: lê e reage. Peça à equipa se precisar de escrever |
| *"Não tem acesso a este canal."* | A visibilidade do espaço não o inclui |
| *"Atingiu o limite de mensagens. Aguarde um pouco."* | Aguarde um minuto (ou a hora, no limite de multimédia e de texto repetido) |
| O contador mostra caracteres acima do limite | A mensagem passa dos 4000 caracteres: divida-a em duas |
| *"Até 10 fotografias por mensagem."* | Envie as outras fotografias numa segunda mensagem |
| A menção não avisou a pessoa | Ela não abre o espaço; a menção fica como texto |
| Não dá para responder a uma resposta | As threads têm um nível: responda na mesma thread |

## Perguntas frequentes

**Pode haver vários canais num espaço?**
Não. Um espaço é um canal; crie um espaço para cada canal e agrupe-os numa secção.

**A equipa lê as minhas mensagens privadas pelo canal?**
O canal é do grupo: quem abre o espaço lê. Para conversar só com uma pessoa, use [Mensagens](/membros/mensagens), que a equipa nunca lê.

**Quem perde o acesso ao espaço continua a receber avisos?**
Não. O sino e o e-mail confirmam o acesso no momento de avisar.

**Apagar o espaço apaga as mensagens?**
Sim, as mensagens vão com o espaço.

## Pelo assistente

O assistente lê e escreve no canal com as mesmas regras de quem o ligou: só lê canais que a pessoa abriria na app, e só escreve onde o **Quem pode publicar** deixa. Ver [Ferramentas · Conteúdo](/mcp/ferramentas-conteudo#canal).

- **Leitura:** `get_channel_unread` (as não lidas de todos os canais), `list_channel_messages`, `get_channel_thread` e `list_channel_mentionable_members`, que devolve o token `<@id>` para mencionar alguém no texto.
- **Pedem confirmação:** `post_channel_message` e `reply_channel_thread` (mostram o canal, quantas pessoas o veem e o texto) e `delete_channel_message`.
- **Só o autor:** `update_channel_message`.
- **Sem confirmação:** `set_channel_reaction`, `follow_channel_thread`, `unfollow_channel_thread`, `mark_channel_read` e `mark_channel_thread_read`.

Peça assim: *"Crie um canal de avisos só da equipa na secção Comunidade e envie a primeira mensagem."* O assistente cria o espaço (`create_space` com `module: "channel"`), define **Quem pode publicar = Equipa** e mostra a mensagem antes de enviar. Ver a [receita](/mcp/receitas#90-um-canal-de-avisos-so-da-equipa).

## Na API

As rotas ficam em `/api/channels`, com `X-CommunityId` e sessão iniciada; o caminho não leva a comunidade. Todas as rotas confirmam o acesso ao espaço, e escrever confirma o **Quem pode publicar**.

| Rota | O que faz |
|---|---|
| `GET /api/channels/unread` | As não lidas de cada canal que a pessoa abre (menções, threads) |
| `GET /api/channels/{spaceId}` | O canal: se a pessoa pode publicar, reagir e moderar, e os limites |
| `GET` · `POST /api/channels/{spaceId}/messages` | As mensagens (cursores `before`, `after`, `around`, `ids`; 50 por página) · publica (`body`, `mediaIds`) |
| `PATCH` · `DELETE /api/channels/messages/{id}` | O autor edita · o autor ou a equipa apaga |
| `GET` · `POST /api/channels/messages/{id}/replies` | A thread · responde |
| `PUT` · `DELETE /api/channels/messages/{id}/reactions/{emoji}` | Reage · retira a reação |
| `PUT` · `DELETE /api/channels/messages/{id}/follow` | Segue · deixa de seguir a thread |
| `POST /api/channels/{spaceId}/read` · `POST /api/channels/messages/{id}/read` | Marca como lido o canal · a thread |
| `GET /api/channels/{spaceId}/mentionable?q=` | Quem pode ser mencionado (a partir de 3 letras) |

A menção vai no texto como `<@id>`. Erros: `400` (texto vazio ou acima de 4000 caracteres, resposta a uma resposta), `403` (sem acesso ao espaço ou sem permissão para publicar; editar a mensagem de outra pessoa), `404` (mensagem de outro espaço ou comunidade), `409` (mensagem apagada, mais de 20 emojis), `429` (limites). A chave de API usa o módulo `channels` (ver [Autenticação](/api/autenticacao#o-ambito)). As rotas estão na [Referência da API](/api/referencia).

## Relacionados

- [Feed](/espacos/feed)
- [Mensagens](/membros/mensagens)
- [Módulos](/conceitos/modulos)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)
- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)
- [Ferramentas · Conteúdo](/mcp/ferramentas-conteudo#canal)