# Canal

> El módulo de espacio Canal, de la pestaña Comunidad. La conversación del grupo en tiempo real, con el mensaje más nuevo abajo, hilos, reacciones con cualquier emoji, menciones, foto y vídeo, no leídos en el menú, quien solo lee y reacciona, límites, el correo de menciones y respuestas, y las mismas acciones desde el asistente y la API.

El **Canal** es la conversación rápida del grupo dentro de la comunidad, en lugar del grupo de mensajería de fuera: los mensajes llegan en tiempo real, el más nuevo queda abajo, y cada mensaje puede convertirse en un **hilo** con sus respuestas.

Es un [módulo de espacio](/conceitos/modulos) de la pestaña **Comunidad** de **Añadir Espacio**. **Un espacio es un canal**: para tener varios canales (#general, #avisos, #promo-2026), crea varios espacios y usa la [sección](/conceitos/secoes) del menú para agruparlos. Quién crea el espacio: propietario o administrador.

## ¿Canal, Feed o Mensajes?

| | [Feed](/espacos/feed) | **Canal** | [Mensajes](/membros/mensagens) |
|---|---|---|---|
| Qué es | Muro de publicaciones | Conversación rápida del grupo | Conversación privada entre dos personas |
| Orden | Lo más nuevo arriba | Lo más nuevo **abajo**, como un chat; abre en el primer no leído | Lo más nuevo abajo |
| Respuestas | Comentarios bajo la publicación | **Hilos** ligados a un mensaje | En la propia conversación |
| Quién lee | Quien abre el espacio | Quien abre el espacio | Solo las dos personas |
| Bueno para | Anuncios, debates que tienen que durar, contenido | "¿Alguien sabe…?", quedar, charla de clase, equipo o evento | Conversación uno a uno |

**La regla práctica:** si la persona espera respuesta en los próximos minutos, es Canal; si espera que el texto se encuentre la semana que viene, es Feed; si no quiere que el grupo lo vea, es Mensajes.

## Quién puede hacer qué

| Acción | Quién |
|---|---|
| Leer el canal y los hilos | Quien abre el espacio (la visibilidad del espacio). El visitante sin sesión no lee el canal, ni siquiera en un espacio público |
| Escribir, responder en el hilo, enviar foto y vídeo | Quien permita el **Quién puede publicar** del espacio: **Cualquiera**, el **Equipo** (propietario, administrador, moderador y finanzas) o los **Admins** |
| Reaccionar, seguir un hilo | Quien abre el espacio, aunque no pueda escribir |
| Editar un mensaje | Solo el autor, en cualquier momento |
| Eliminar un mensaje | El autor; y el propietario, el administrador y el moderador eliminan cualquier mensaje del espacio |

Quien no puede escribir no ve la caja de mensaje, ni en el canal ni en el hilo, y encuentra *"En este canal solo escribe quien tiene permiso. Puedes leer y reaccionar a los mensajes."* Así se hace un canal de avisos: **Quién puede publicar = Equipo** (o **Admins**), y el resto de la comunidad lee y reacciona.

El canal no tiene aprobación previa: la moderación es después de publicar, eliminando.

## Cómo funciona

### La conversación

El canal abre en el **primer mensaje no leído**, marcado por la línea **Mensajes nuevos**, o al final si ya lo has leído todo. Los mensajes se agrupan por día (**Hoy**, **Ayer**, la fecha), y los más antiguos se cargan al desplazarte hacia arriba. Si llega un mensaje nuevo mientras estás lejos del final, aparece **Ir al final**.

Cuando el canal está vacío, muestra *"Empieza la conversación del grupo"*; el comienzo del historial dice *"Este es el comienzo de #nombre"*.

### Hilos

**Responder en el hilo** abre la conversación de ese mensaje: en un panel al lado del canal cuando hay espacio, o a pantalla completa, con **Volver**, en la pantalla estrecha. En el móvil, tocar un mensaje que tiene hilo (o **N respuestas**) abre el hilo a pantalla completa; el botón atrás del sistema también lo cierra. El mensaje muestra **N respuestas** y, cuando hay respuestas que aún no has leído, **N respuestas nuevas**.

Los hilos tienen **un nivel**: se responde a un mensaje del canal, no a una respuesta.

Sigues automáticamente el hilo de tu mensaje, los hilos en los que respondiste y aquellos en los que te mencionaron. En el hilo, **Seguir hilo** y **Dejar de seguir** lo cambian. Quien sigue recibe las respuestas en la campana y, si no las lee, por correo.

### Reacciones

Pasa el ratón por el mensaje para las **7 reacciones rápidas**, o **Más emojis** para elegir cualquier emoji, con búsqueda. En el móvil, **mantén pulsado** el mensaje: sube desde abajo una hoja con las 7 reacciones, el **+** (todos los emojis), **Responder en el hilo**, **Copiar texto**, **Editar mensaje** y **Eliminar mensaje**; mantener pulsada una reacción muestra cuántas personas reaccionaron con ella. Cada reacción muestra el emoji y cuántas personas reaccionaron; pulsar de nuevo quita la tuya. Cada mensaje admite hasta 20 emojis distintos.

### Menciones

Escribe `@` y el comienzo del nombre: la lista **Personas para mencionar** muestra solo a quien puede abrir el espacio. La persona mencionada recibe en la campana *"Fulano te mencionó en #nombre"* y, si no lo lee, un correo. Mencionar a quien no abre el espacio no avisa a nadie. Cada mensaje avisa como máximo a 20 personas.

**La tarjeta de la persona.** Hacer clic en una mención **@Nombre**, o en el nombre o la foto de quien escribió, abre una tarjeta pequeña con la foto, el nombre, el cargo y el [estado en el chat](/membros/mensagens#tu-estado-en-el-chat) (*"en línea"*, *"ocupado"*, *"ausente"* o *"Desconectado"* con la última vez), y dos botones:

- **Enviar mensaje**, que abre la conversación con la persona según las reglas del chat. Con **Hay que agregar**, en su lugar aparece el botón de la conexión (**Agregar**, **Solicitud enviada**, **Aceptar**; ver [conexiones](/membros/mensagens#hay-que-agregar-conexiones)). Cuando no se puede escribir, el botón queda desactivado con el motivo: *"Esta persona no está recibiendo conversaciones nuevas ahora."* o, si estás No disponible, *"Estás No disponible en el chat. Cambia tu estado para conversar."*
- **Ver perfil**, que lleva a la [página del miembro](/membros/seu-perfil).

Una mención a ti mismo muestra solo **Ver perfil**.

### Foto y vídeo

En la caja de mensaje:

- **Añadir foto**: hasta **10 fotos** por mensaje (JPG, PNG, WebP o GIF), de hasta 50 MB cada una.
- **Añadir vídeo**: **1 vídeo** por mensaje, enviado como archivo (MP4, WebM o MOV, hasta 350 MB) o grabado en el momento con **Grabar vídeo**, hasta 10 minutos, como un [Drop](/espacos/drops).

El botón de emoji, al lado, añade un emoji al texto.

### Formato

El texto admite un formato sencillo, que aparece ya formateado en el mensaje:

| Escribe | Para |
|---|---|
| `*texto*` o `**texto**` | **negrita** |
| `_texto_` | *cursiva* |
| `` `texto` `` | `código` |
| `https://…` | enlace, que se abre en otra pestaña |

Los saltos de línea se quedan como se escribieron: en el ordenador, **Mayús + Intro** salta de línea e **Intro** envía; en el móvil, **Intro** salta de línea y **Enviar** envía. Las marcas solo cuentan en el borde de una palabra (un `_` dentro de `nombre_de_archivo` se queda como está). Cualquier otra marca aparece como texto.

### Editar y eliminar

En el mensaje, **Más acciones** › **Editar** o **Eliminar** (en el móvil, mantén pulsado el mensaje y elige **Editar mensaje** o **Eliminar mensaje**).

- **Editar**: solo el autor, sin plazo. **Enter** guarda, **Esc** cancela. El mensaje pasa a mostrar **(editado)**.
- **Eliminar**: en su lugar queda el aviso *mensaje eliminado*, y las fotos y el vídeo se van con él. Si el mensaje tenía hilo, el hilo sigue, con todas las respuestas, ligado al aviso.

Eliminar tu propio mensaje lo oculta al instante, con **Deshacer** durante 5 segundos (*"Mensaje eliminado"*); un mensaje eliminado sin hilo desaparece de la conversación.

### No leídos

En el menú, el canal con mensajes nuevos aparece en **negrita**, con el número de **menciones no leídas** al lado. Leer el canal hasta el final, o el hilo, deja a cero lo leído. Tu propio mensaje nunca cuenta como no leído, y quien acaba de entrar en el espacio no hereda el historial como no leído.

**Silenciar canal**, en la parte superior del canal: las menciones y respuestas de ese canal dejan de generar aviso y correo, y los mensajes no leídos siguen contando. **Volver a recibir avisos** lo deshace. La parte superior también muestra quién está en la conversación y **Buscar en el canal**, que busca en los mensajes cargados.

### Límites

| Límite | Valor |
|---|---|
| Longitud de un mensaje o respuesta | 4000 caracteres (el contador avisa cuando te pasas) |
| Mensajes y respuestas por minuto | 30 por persona; el equipo tiene el doble, quien entró en la comunidad hace menos de 24 horas, la mitad |
| El mismo texto | 3 veces por hora en el mismo canal |
| Mensajes con foto o vídeo | 20 por hora |
| Vídeos | 10 por hora |

Al pasar un límite, el mensaje no sale y aparece *"Has llegado al límite de mensajes. Espera un poco."* (o el aviso del límite de multimedia).

### Correo

La mención y la respuesta en un hilo que sigues llegan **a la campana, al momento**. Si no las lees en 10 minutos, llega un correo, como máximo **uno por canal cada 6 horas** (*"Te mencionaron en #general"*, *"Respuestas nuevas en #general"* o *"Menciones y respuestas en #general"*). El correo **no lleva el texto** del mensaje: te lleva al canal. Cada mensaje nuevo del canal no genera correo.

Se desactiva en la categoría **Canales: menciones y respuestas**, en [Correos de esta comunidad](/notificacoes/emails-desta-comunidade), o con el enlace del pie.

## Paso a paso

### Crear un canal

*Rol: propietario o administrador.*

1. En el menú, en **Añadir Espacio**, abre la pestaña **Comunidad** y elige **Canal**.
2. Pon el nombre (será el `#nombre` del canal), la descripción, la visibilidad y el **Quién puede publicar**.
3. Créalo. El espacio abre directamente en la conversación.

No hay elección "uno o varios" ni aprobación previa: el espacio ya es el canal.

### Enviar un mensaje

1. Abre el canal y escribe en **Mensaje para #nombre**.
2. Si quieres, **Añadir foto**, **Añadir vídeo** o **Grabar vídeo**, y `@` para mencionar.
3. **Enviar** (en el ordenador, también **Intro**).

### Responder en un hilo

1. En el mensaje, **Responder en el hilo**.
2. Escribe en **Responder en el hilo** y envía.
3. **Cerrar hilo** vuelve al canal.

## Ejemplos

**El #general de una promoción.** **Quién puede publicar = Cualquiera**: los alumnos resuelven dudas rápidas, organizan el grupo de estudio y reaccionan a los avisos del profesor. La duda que da para mucho se convierte en un hilo y no tapa el resto de la conversación.

**Los #avisos del coworking.** **Quién puede publicar = Equipo**: la recepción avisa del mantenimiento del ascensor con una foto; los residentes leen, reaccionan con 👍 y siguen el hilo del aviso para saber cuándo terminó.

## Errores frecuentes y cómo resolverlos

| Situación | Qué hacer |
|---|---|
| No aparece la caja de mensaje | El **Quién puede publicar** del espacio no incluye tu rol: lees y reaccionas. Pide al equipo si necesitas escribir |
| *"No tienes acceso a este canal."* | La visibilidad del espacio no te incluye |
| *"Has llegado al límite de mensajes. Espera un poco."* | Espera un minuto (o la hora, en el límite de multimedia y de texto repetido) |
| El contador muestra caracteres por encima del límite | El mensaje pasa de 4000 caracteres: divídelo en dos |
| *"Hasta 10 fotos por mensaje."* | Envía las demás fotos en un segundo mensaje |
| La mención no avisó a la persona | No abre el espacio; la mención se queda como texto |
| No se puede responder a una respuesta | Los hilos tienen un nivel: responde en el mismo hilo |

## Preguntas frecuentes

**¿Puede haber varios canales en un espacio?**
No. Un espacio es un canal; crea un espacio por canal y agrúpalos en una sección.

**¿El equipo lee mis mensajes privados desde el canal?**
El canal es del grupo: quien abre el espacio lo lee. Para hablar solo con una persona, usa [Mensajes](/membros/mensagens), que el equipo nunca lee.

**¿Quien pierde el acceso al espacio sigue recibiendo avisos?**
No. La campana y el correo comprueban el acceso en el momento de avisar.

**¿Eliminar el espacio elimina los mensajes?**
Sí, los mensajes se van con el espacio.

## Por el asistente

El asistente lee y escribe en el canal con las mismas reglas que quien lo conectó: solo lee canales que la persona abriría en la app, y solo escribe donde el **Quién puede publicar** lo permite. Ver [Herramientas · Contenido](/mcp/ferramentas-conteudo#canal).

- **Lectura:** `get_channel_unread` (los no leídos de todos los canales), `list_channel_messages`, `get_channel_thread` y `list_channel_mentionable_members`, que devuelve el token `<@id>` para mencionar a alguien en el texto.
- **Piden confirmación:** `post_channel_message` y `reply_channel_thread` (muestran el canal, cuántas personas lo ven y el texto) y `delete_channel_message`.
- **Solo el autor:** `update_channel_message`.
- **Sin confirmación:** `set_channel_reaction`, `follow_channel_thread`, `unfollow_channel_thread`, `mark_channel_read` y `mark_channel_thread_read`.

Pídelo así: *"Crea un canal de avisos solo del equipo en la sección Comunidad y envía el primer mensaje."* El asistente crea el espacio (`create_space` con `module: "channel"`), pone **Quién puede publicar = Equipo** y muestra el mensaje antes de enviarlo. Ver la [receta](/mcp/receitas#90-un-canal-de-avisos-solo-del-equipo).

## En la API

Las rutas están en `/api/channels`, con `X-CommunityId` y sesión iniciada; la ruta no lleva la comunidad. Cada ruta comprueba el acceso al espacio, y escribir comprueba el **Quién puede publicar**.

| Ruta | Qué hace |
|---|---|
| `GET /api/channels/unread` | Los no leídos de cada canal que la persona abre (menciones, hilos) |
| `GET /api/channels/{spaceId}` | El canal: si la persona puede publicar, reaccionar y moderar, y los límites |
| `GET` · `POST /api/channels/{spaceId}/messages` | Los mensajes (cursores `before`, `after`, `around`, `ids`; 50 por página) · publica (`body`, `mediaIds`) |
| `PATCH` · `DELETE /api/channels/messages/{id}` | El autor edita · el autor o el equipo elimina |
| `GET` · `POST /api/channels/messages/{id}/replies` | El hilo · responde |
| `PUT` · `DELETE /api/channels/messages/{id}/reactions/{emoji}` | Reacciona · quita la reacción |
| `PUT` · `DELETE /api/channels/messages/{id}/follow` | Sigue · deja de seguir el hilo |
| `POST /api/channels/{spaceId}/read` · `POST /api/channels/messages/{id}/read` | Marca como leído el canal · el hilo |
| `GET /api/channels/{spaceId}/mentionable?q=` | A quién se puede mencionar (desde 3 letras) |

La mención va en el texto como `<@id>`. Errores: `400` (texto vacío o de más de 4000 caracteres, respuesta a una respuesta), `403` (sin acceso al espacio o sin permiso para publicar; editar el mensaje de otra persona), `404` (mensaje de otro espacio o comunidad), `409` (mensaje eliminado, más de 20 emojis), `429` (límites). La clave de API usa el módulo `channels` (ver [Autenticación](/api/autenticacao#el-alcance)). Las rutas aparecen en la [Referencia de la API](/api/referencia) cuando el módulo llegue a las comunidades.

## Relacionados

- [Feed](/espacos/feed)
- [Mensajes](/membros/mensagens)
- [Módulos](/conceitos/modulos)
- [Roles y permisos](/conceitos/papeis-e-permissoes)
- [Correos de esta comunidad](/notificacoes/emails-desta-comunidade)
- [Herramientas · Contenido](/mcp/ferramentas-conteudo#canal)