# Canal

> O módulo de espaço Canal, da aba Comunidade. A conversa do grupo em tempo real, com a mensagem mais nova embaixo, threads, reações com qualquer emoji, menções, foto 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, no lugar do grupo de mensagens de fora: as mensagens chegam em tempo real, a mais nova fica embaixo, e cada mensagem pode virar uma **thread** com as respostas dela.

É um [módulo de espaço](/conceitos/modulos) da aba **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 [seção](/conceitos/secoes) do menu para agrupá-los. 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 novo em cima | Mais novo **embaixo**, como um chat; abre na primeira não lida | Mais novo embaixo |
| Respostas | Comentários embaixo do post | **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úncio, discussão que precisa durar, conteúdo | "Alguém sabe…?", combinar, bate-papo de turma, time ou evento | Conversa um a um |

**A regra de bolso:** se a pessoa espera resposta nos próximos minutos, é Canal; se espera que o texto seja encontrado na semana que vem, é 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 login não lê o canal, nem em espaço público |
| Escrever, responder na thread, mandar foto e vídeo | Quem o **Quem pode postar** do espaço permite: **Qualquer um**, **Equipe** (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. Você lê e reage às mensagens."* É assim que se faz um canal de avisos: **Quem pode postar = Equipe** (ou **Admins**), e o resto da comunidade lê e reage.

O canal não tem aprovação prévia: a moderação é 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 você já leu tudo. As mensagens se agrupam por dia (**Hoje**, **Ontem**, a data), e as mais antigas carregam quando você rola para cima. Se chega mensagem nova enquanto você está longe do fim, aparece **Ir para o fim**.

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

### Threads

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

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

Você **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 ler, por e-mail.

### Reações

Passe o mouse na mensagem para as **7 reações rápidas**, ou **Mais emojis** para escolher qualquer emoji, com busca. No celular, **toque e segure** 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 segurar uma reação mostra quantas pessoas reagiram com ela. Cada reação mostra o emoji e quantas pessoas reagiram; clicar de novo remove a sua. Cada mensagem aceita até 20 emojis diferentes.

### Menções

Escreva `@` e o começo do nome: a lista **Pessoas para mencionar** mostra só quem pode abrir o espaço. A pessoa mencionada recebe no sino *"Fulano mencionou você 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 foto de quem escreveu, abre um cartão pequeno com a foto, o nome, o cargo e o [status no chat](/membros/mensagens#seu-status-no-chat) (*"online"*, *"ocupado"*, *"ausente"* ou *"Offline"* com o visto por último), 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 conexão (**Adicionar**, **Pedido enviado**, **Aceitar**; ver [conexões](/membros/mensagens#precisa-adicionar-conexoes)). Quando não dá para escrever, o botão fica desligado com o motivo: *"Esta pessoa não está recebendo conversas novas agora."* ou, se você está Indisponível, *"Você está Indisponível no chat. Mude seu status para conversar."*
- **Ver perfil**, que leva à [página do membro](/membros/seu-perfil).

Uma menção a você mesmo mostra só **Ver perfil**.

### Foto e vídeo

Na caixa de mensagem:

- **Adicionar foto**: até **10 fotos** por mensagem (JPG, PNG, WebP ou GIF), de até 50 MB cada.
- **Adicionar vídeo**: **1 vídeo** por mensagem, enviado como arquivo (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, coloca 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://…` | link, que abre em outra aba |

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

### Editar e apagar

Na mensagem, **Mais ações** › **Editar** ou **Apagar** (no celular, toque e segure a mensagem e escolha **Editar mensagem** ou **Apagar mensagem**).

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

Apagar a própria mensagem a esconde na hora, com **Desfazer** por 5 segundos (*"Mensagem apagada"*); uma mensagem apagada sem thread some da conversa.

### Não lidas

No menu, o canal com mensagens novas fica em **negrito**, com o número de **menções não lidas** ao lado. Ler o canal até o fim, ou a thread, zera 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: menções e respostas daquele canal deixam de gerar aviso e e-mail, e as mensagens não lidas continuam contando. **Voltar a receber avisos** desfaz. O topo também mostra quem está na conversa e **Buscar no canal**, que procura nas mensagens carregadas.

### Limites

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

Passando de um limite, a mensagem não sai e aparece *"Você atingiu o limite de mensagens. Espere um pouco."* (ou o aviso do limite de mídia).

### E-mail

Menção e resposta numa thread que você segue chegam **no sino, na hora**. Se você não ler em 10 minutos, chega um e-mail, no máximo **um por canal a cada 6 horas** (*"Você 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: ele leva você ao canal. Cada mensagem nova do canal não gera e-mail.

Dá para desligar na categoria **Canais: menções e respostas**, em [E-mails desta comunidade](/notificacoes/emails-desta-comunidade), ou pelo link do rodapé.

## Passo a passo

### Criar um canal

*Papel: proprietário ou administrador.*

1. No menu, em **Adicionar Espaço**, abra a aba **Comunidade** e escolha **Canal**.
2. Dê o nome (vira o `#nome` do canal), a descrição, a visibilidade e o **Quem pode postar**.
3. Crie. O espaço abre direto na conversa.

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

### Mandar uma mensagem

1. Abra o canal e escreva em **Mensagem para #nome**.
2. Se quiser, **Adicionar foto**, **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 postar = Qualquer um**: os alunos tiram dúvidas rápidas, combinam o grupo de estudo e reagem aos recados do professor. A dúvida que rendeu vira uma thread e não atropela o resto da conversa.

**#avisos do coworking.** **Quem pode postar = Equipe**: a recepção avisa da manutenção do elevador com uma foto; 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 postar** do espaço não inclui o seu papel: você lê e reage. Peça à equipe se precisar escrever |
| *"Você não tem acesso a este canal."* | A visibilidade do espaço não inclui você |
| *"Você atingiu o limite de mensagens. Espere um pouco."* | Espere um minuto (ou a hora, no limite de mídia e de texto repetido) |
| O contador mostra caracteres acima do limite | A mensagem passa de 4.000 caracteres: divida em duas |
| *"Até 10 fotos por mensagem."* | Mande as outras fotos 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

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

**A equipe 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 equipe nunca lê.

**Quem perde o acesso ao espaço continua recebendo avisos?**
Não. Sino e e-mail conferem o acesso na hora de avisar.

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

## Pelo assistente

O assistente lê e escreve no canal com as mesmas regras de quem conectou: só lê canais que a pessoa abriria no app, e só escreve onde o **Quem pode postar** 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 equipe na seção Comunidade e mande a primeira mensagem."* O assistente cria o espaço (`create_space` com `module: "channel"`), coloca **Quem pode postar = Equipe** e mostra a mensagem antes de enviar. Ver a [receita](/mcp/receitas#90-um-canal-de-avisos-so-da-equipe).

## Na API

As rotas ficam em `/api/channels`, com `X-CommunityId` e login; o caminho não leva a comunidade. Toda rota confere o acesso ao espaço, e escrever confere o **Quem pode postar**.

| 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 postar, reagir e moderar, e os limites |
| `GET` · `POST /api/channels/{spaceId}/messages` | As mensagens (cursores `before`, `after`, `around`, `ids`; 50 por página) · posta (`body`, `mediaIds`) |
| `PATCH` · `DELETE /api/channels/messages/{id}` | O autor edita · o autor ou a equipe apaga |
| `GET` · `POST /api/channels/messages/{id}/replies` | A thread · responde |
| `PUT` · `DELETE /api/channels/messages/{id}/reactions/{emoji}` | Reage · remove 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 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 4.000 caracteres, resposta a uma resposta), `403` (sem acesso ao espaço ou sem permissão de postar; editar 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-escopo)). A referência das rotas aparece na [Referência da API](/api/referencia) quando o módulo chegar às comunidades.

## 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)