# Canale

> Il modulo di spazio Canale, nella scheda Community. La conversazione del gruppo in tempo reale, con il messaggio più recente in basso, thread, reazioni con qualsiasi emoji, menzioni, foto e video, non letti nel menu, chi legge e reagisce soltanto, limiti, l'e-mail di menzioni e risposte, e le stesse azioni dall'assistente e dall'API.

Il **Canale** è la conversazione rapida del gruppo dentro la community, al posto del gruppo di messaggistica esterno: i messaggi arrivano in tempo reale, il più recente sta in basso, e ogni messaggio può diventare un **thread** con le sue risposte.

È un [modulo di spazio](/conceitos/modulos) della scheda **Community** di **Aggiungi Spazio**. **Uno spazio è un canale**: per avere più canali (#generale, #avvisi, #classe-2026), crea più spazi e usa la [sezione](/conceitos/secoes) del menu per raggrupparli. Chi crea lo spazio: proprietario o amministratore.

## Canale, Feed o Messaggi?

| | [Feed](/espacos/feed) | **Canale** | [Messaggi](/membros/mensagens) |
|---|---|---|---|
| Che cos'è | Bacheca di pubblicazioni | Conversazione rapida del gruppo | Conversazione privata tra due persone |
| Ordine | Il più recente in alto | Il più recente **in basso**, come una chat; si apre sul primo non letto | Il più recente in basso |
| Risposte | Commenti sotto il post | **Thread** legati a un messaggio | Nella conversazione stessa |
| Chi legge | Chi apre lo spazio | Chi apre lo spazio | Solo le due persone |
| Adatto a | Annunci, discussioni che devono durare, contenuti | "Qualcuno sa…?", organizzarsi, chiacchiere di classe, team o evento | Conversazione a due |

**La regola pratica:** se la persona si aspetta una risposta nei prossimi minuti, è Canale; se si aspetta che il testo si ritrovi la settimana prossima, è Feed; se non vuole che il gruppo lo veda, è Messaggi.

## Chi può fare cosa

| Azione | Chi |
|---|---|
| Leggere il canale e i thread | Chi apre lo spazio (la visibilità dello spazio). Il visitatore senza accesso non legge il canale, neanche in uno spazio pubblico |
| Scrivere, rispondere nel thread, inviare foto e video | Chi il **Chi può pubblicare** dello spazio permette: **Chiunque**, **Team** (proprietario, amministratore, moderatore e finanza) o **Admin** |
| Reagire, seguire un thread | Chi apre lo spazio, anche senza poter scrivere |
| Modificare un messaggio | Solo l'autore, in qualsiasi momento |
| Eliminare un messaggio | L'autore; e il proprietario, l'amministratore e il moderatore eliminano qualsiasi messaggio dello spazio |

Chi non può scrivere non vede la casella del messaggio, né nel canale né nel thread, e trova *"In questo canale scrive solo chi ha il permesso. Puoi leggere e reagire ai messaggi."* È così che si fa un canale di avvisi: **Chi può pubblicare = Team** (o **Admin**), e il resto della community legge e reagisce.

Il canale non ha approvazione preventiva: la moderazione avviene dopo la pubblicazione, eliminando.

## Come funziona

### La conversazione

Il canale si apre sul **primo messaggio non letto**, segnato dalla riga **Nuovi messaggi**, o alla fine, se hai già letto tutto. I messaggi sono raggruppati per giorno (**Oggi**, **Ieri**, la data), e i più vecchi si caricano scorrendo verso l'alto. Se arriva un messaggio nuovo mentre sei lontano dalla fine, compare **Vai alla fine**.

Quando il canale è vuoto, mostra *"Avvia la conversazione del gruppo"*; l'inizio della cronologia dice *"Questo è l'inizio di #nome"*.

### Thread

**Rispondi nel thread** apre la conversazione di quel messaggio: in un pannello accanto al canale quando c'è spazio, oppure a schermo intero, con **Indietro**, sugli schermi stretti. Sul telefono, toccare un messaggio che ha un thread (o **N risposte**) apre il thread a schermo intero; anche il tasto indietro del sistema lo chiude. Il messaggio mostra **N risposte** e, quando ci sono risposte che non hai ancora letto, **N nuove risposte**.

I thread hanno **un livello**: si risponde a un messaggio del canale, non a una risposta.

Segui automaticamente il thread del tuo messaggio, i thread in cui hai risposto e quelli in cui sei stato menzionato. Nel thread, **Segui thread** e **Smetti di seguire** cambiano questa impostazione. Chi segue riceve le risposte nella campanella e, se non le legge, per e-mail.

### Reazioni

Passa il mouse sul messaggio per le **7 reazioni rapide**, oppure **Altre emoji** per scegliere qualsiasi emoji, con ricerca. Sul telefono, **tieni premuto** il messaggio: dal basso sale un pannello con le 7 reazioni, il **+** (tutte le emoji), **Rispondi nel thread**, **Copia testo**, **Modifica messaggio** ed **Elimina messaggio**; tenere premuta una reazione mostra quante persone l'hanno usata. Ogni reazione mostra l'emoji e quante persone hanno reagito; un nuovo clic toglie la tua. Ogni messaggio accetta fino a 20 emoji diverse.

### Menzioni

Scrivi `@` e l'inizio del nome: l'elenco **Persone da menzionare** mostra solo chi può aprire lo spazio. La persona menzionata riceve nella campanella *"Tizio ti ha menzionato in #nome"* e, se non legge, un'e-mail. Menzionare chi non apre lo spazio non avvisa nessuno. Ogni messaggio avvisa al massimo 20 persone.

**La scheda della persona.** Fare clic su una menzione **@Nome**, o sul nome o sulla foto di chi ha scritto, apre una piccola scheda con la foto, il nome, il ruolo e lo [stato in chat](/membros/mensagens#il-tuo-stato-in-chat) (*"online"*, *"occupato"*, *"assente"* o *"Offline"* con l'ultimo accesso), e due pulsanti:

- **Invia messaggio**, che apre la conversazione con la persona secondo le regole della chat. Con **Serve aggiungere**, al suo posto compare il pulsante del collegamento (**Aggiungi**, **Richiesta inviata**, **Accetta**; vedi [collegamenti](/membros/mensagens#serve-aggiungere-collegamenti)). Quando non si può scrivere, il pulsante è disattivato con il motivo: *"Questa persona non accetta nuove conversazioni in questo momento."* oppure, se sei Non disponibile, *"Sei Non disponibile nella chat. Cambia il tuo stato per conversare."*
- **Vedi profilo**, che porta alla [pagina del membro](/membros/seu-perfil).

Una menzione a te stesso mostra solo **Vedi profilo**.

### Foto e video

Nella casella del messaggio:

- **Aggiungi foto**: fino a **10 foto** per messaggio (JPG, PNG, WebP o GIF), fino a 50 MB ciascuna.
- **Aggiungi video**: **1 video** per messaggio, inviato come file (MP4, WebM o MOV, fino a 350 MB) o registrato al momento con **Registra video**, fino a 10 minuti, come un [Drop](/espacos/drops).

Il pulsante delle emoji, accanto, inserisce un'emoji nel testo.

### Formattazione

Il testo accetta una formattazione semplice, che compare già formattata nel messaggio:

| Scrivi | Per |
|---|---|
| `*testo*` o `**testo**` | **grassetto** |
| `_testo_` | *corsivo* |
| `` `testo` `` | `codice` |
| `https://…` | un link, che si apre in un'altra scheda |

Gli a capo restano come sono stati scritti: sul computer, **Maiusc + Invio** va a capo e **Invio** invia; sul telefono, **Invio** va a capo e **Invia** invia. I simboli valgono solo al bordo di una parola (un `_` dentro `nome_file` resta com'è). Qualsiasi altro markup compare come testo.

### Modificare ed eliminare

Sul messaggio, **Altre azioni** › **Modifica** o **Elimina** (sul telefono, tieni premuto il messaggio e scegli **Modifica messaggio** o **Elimina messaggio**).

- **Modifica**: solo l'autore, senza scadenza. **Invio** salva, **Esc** annulla. Il messaggio mostra poi **(modificato)**.
- **Elimina**: al suo posto resta l'avviso *messaggio eliminato*, e le foto e il video se ne vanno con lui. Se il messaggio aveva un thread, il thread continua, con tutte le risposte, legato all'avviso.

Eliminare il proprio messaggio lo nasconde subito, con **Annulla** per 5 secondi (*"Messaggio eliminato"*); un messaggio eliminato senza thread sparisce dalla conversazione.

### Non letti

Nel menu, il canale con messaggi nuovi è in **grassetto**, con il numero di **menzioni non lette** accanto. Leggere il canale fino alla fine, o il thread, azzera ciò che è stato letto. Il tuo messaggio non conta mai come non letto, e chi è appena entrato nello spazio non eredita la cronologia come non letta.

**Silenzia canale**, in cima al canale: menzioni e risposte di quel canale non generano più avvisi né e-mail, e i messaggi non letti continuano a contare. **Riattiva notifiche** lo annulla. In cima compaiono anche chi partecipa alla conversazione e **Cerca nel canale**, che cerca tra i messaggi caricati.

### Limiti

| Limite | Valore |
|---|---|
| Lunghezza di un messaggio o di una risposta | 4.000 caratteri (il contatore avvisa quando li superi) |
| Messaggi e risposte al minuto | 30 a persona; il team ha il doppio, chi è entrato nella community da meno di 24 ore ha la metà |
| Lo stesso testo | 3 volte all'ora nello stesso canale |
| Messaggi con foto o video | 20 all'ora |
| Video | 10 all'ora |

Superato un limite, il messaggio non parte e compare *"Hai raggiunto il limite di messaggi. Attendi un momento."* (o l'avviso del limite dei media).

### E-mail

La menzione e la risposta in un thread che segui arrivano **nella campanella, subito**. Se non le leggi entro 10 minuti, arriva un'e-mail, al massimo **una per canale ogni 6 ore** (*"Sei stato menzionato in #generale"*, *"Nuove risposte in #generale"* o *"Menzioni e risposte in #generale"*). L'e-mail **non contiene il testo** del messaggio: ti porta al canale. Ogni nuovo messaggio del canale non genera un'e-mail.

Si disattiva nella categoria **Canali: menzioni e risposte**, in [E-mail di questa community](/notificacoes/emails-desta-comunidade), o con il link a piè di pagina.

## Passo dopo passo

### Creare un canale

*Ruolo: proprietario o amministratore.*

1. Nel menu, in **Aggiungi Spazio**, apri la scheda **Community** e scegli **Canale**.
2. Dai il nome (diventa il `#nome` del canale), la descrizione, la visibilità e il **Chi può pubblicare**.
3. Crealo. Lo spazio si apre direttamente sulla conversazione.

Non c'è la scelta "uno o più" né l'approvazione preventiva: lo spazio è già il canale.

### Inviare un messaggio

1. Apri il canale e scrivi in **Messaggio in #nome**.
2. Se vuoi, **Aggiungi foto**, **Aggiungi video** o **Registra video**, e `@` per menzionare.
3. **Invia** (sul computer, anche **Invio**).

### Rispondere in un thread

1. Sul messaggio, **Rispondi nel thread**.
2. Scrivi in **Rispondi nel thread** e invia.
3. **Chiudi thread** torna al canale.

## Esempi

**Il #generale di una classe.** **Chi può pubblicare = Chiunque**: gli studenti fanno domande veloci, organizzano il gruppo di studio e reagiscono agli avvisi del docente. La domanda che si allunga diventa un thread e non travolge il resto della conversazione.

**Gli #avvisi del coworking.** **Chi può pubblicare = Team**: la reception avvisa della manutenzione dell'ascensore con una foto; i residenti leggono, reagiscono con 👍 e seguono il thread dell'avviso per sapere quando è finita.

## Errori comuni e come risolverli

| Situazione | Cosa fare |
|---|---|
| La casella del messaggio non compare | Il **Chi può pubblicare** dello spazio non include il tuo ruolo: leggi e reagisci. Chiedi al team se devi scrivere |
| *"Non hai accesso a questo canale."* | La visibilità dello spazio non ti include |
| *"Hai raggiunto il limite di messaggi. Attendi un momento."* | Attendi un minuto (o l'ora, per il limite dei media e del testo ripetuto) |
| Il contatore mostra caratteri oltre il limite | Il messaggio supera i 4.000 caratteri: dividilo in due |
| *"Fino a 10 foto per messaggio."* | Invia le altre foto in un secondo messaggio |
| La menzione non ha avvisato la persona | Non apre lo spazio; la menzione resta come testo |
| Non si può rispondere a una risposta | I thread hanno un livello: rispondi nello stesso thread |

## Domande frequenti

**Uno spazio può avere più canali?**
No. Uno spazio è un canale; crea uno spazio per ogni canale e raggruppali in una sezione.

**Il team legge i miei messaggi privati dal canale?**
Il canale è del gruppo: chi apre lo spazio lo legge. Per parlare con una sola persona, usa [Messaggi](/membros/mensagens), che il team non legge mai.

**Chi perde l'accesso allo spazio continua a ricevere avvisi?**
No. Campanella ed e-mail verificano l'accesso al momento dell'avviso.

**Eliminare lo spazio elimina i messaggi?**
Sì, i messaggi se ne vanno con lo spazio.

## Tramite l'assistente

L'assistente legge e scrive nel canale con le stesse regole di chi lo ha collegato: legge solo i canali che la persona aprirebbe nell'app, e scrive solo dove il **Chi può pubblicare** lo consente. Vedi [Strumenti · Contenuti](/mcp/ferramentas-conteudo#canale).

- **Lettura:** `get_channel_unread` (i non letti di tutti i canali), `list_channel_messages`, `get_channel_thread` e `list_channel_mentionable_members`, che restituisce il token `<@id>` per menzionare qualcuno nel testo.
- **Chiedono conferma:** `post_channel_message` e `reply_channel_thread` (mostrano il canale, quante persone lo vedono e il testo) e `delete_channel_message`.
- **Solo l'autore:** `update_channel_message`.
- **Senza conferma:** `set_channel_reaction`, `follow_channel_thread`, `unfollow_channel_thread`, `mark_channel_read` e `mark_channel_thread_read`.

Chiedi così: *"Crea un canale di avvisi solo per il team nella sezione Community e manda il primo messaggio."* L'assistente crea lo spazio (`create_space` con `module: "channel"`), imposta **Chi può pubblicare = Team** e mostra il messaggio prima di inviarlo. Vedi la [ricetta](/mcp/receitas#90-un-canale-di-avvisi-solo-per-il-team).

## Nell'API

Le rotte stanno in `/api/channels`, con `X-CommunityId` e accesso effettuato; il percorso non contiene la community. Ogni rotta verifica l'accesso allo spazio, e scrivere verifica il **Chi può pubblicare**.

| Rotta | Cosa fa |
|---|---|
| `GET /api/channels/unread` | I non letti di ogni canale che la persona apre (menzioni, thread) |
| `GET /api/channels/{spaceId}` | Il canale: se la persona può pubblicare, reagire e moderare, e i limiti |
| `GET` · `POST /api/channels/{spaceId}/messages` | I messaggi (cursori `before`, `after`, `around`, `ids`; 50 per pagina) · pubblica (`body`, `mediaIds`) |
| `PATCH` · `DELETE /api/channels/messages/{id}` | L'autore modifica · l'autore o il team elimina |
| `GET` · `POST /api/channels/messages/{id}/replies` | Il thread · risponde |
| `PUT` · `DELETE /api/channels/messages/{id}/reactions/{emoji}` | Reagisce · toglie la reazione |
| `PUT` · `DELETE /api/channels/messages/{id}/follow` | Segue · smette di seguire il thread |
| `POST /api/channels/{spaceId}/read` · `POST /api/channels/messages/{id}/read` | Segna come letto il canale · il thread |
| `GET /api/channels/{spaceId}/mentionable?q=` | Chi si può menzionare (da 3 lettere) |

La menzione va nel testo come `<@id>`. Errori: `400` (testo vuoto o oltre 4.000 caratteri, risposta a una risposta), `403` (senza accesso allo spazio o senza permesso di pubblicare; modificare il messaggio di un altro), `404` (messaggio di un altro spazio o di un'altra community), `409` (messaggio eliminato, più di 20 emoji), `429` (limiti). La chiave API usa il modulo `channels` (vedi [Autenticazione](/api/autenticacao#l-ambito)). Le rotte compaiono nel [Riferimento API](/api/referencia) quando il modulo arriva nelle community.

## Correlati

- [Feed](/espacos/feed)
- [Messaggi](/membros/mensagens)
- [Moduli](/conceitos/modulos)
- [Ruoli e permessi](/conceitos/papeis-e-permissoes)
- [E-mail di questa community](/notificacoes/emails-desta-comunidade)
- [Strumenti · Contenuti](/mcp/ferramentas-conteudo#canale)