Integración Matrix n8nAutomatiza Matrix con n8n.
Una sala de Matrix puede ser el destino natural de todo lo que automatizas. La integración Matrix n8n viene incluida con la herramienta y reúne 11 operaciones repartidas en 6 recursos: cuenta, evento, medio, mensaje, sala y miembro. No hay trigger de Matrix, así que el arranque llega desde otro nodo.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué aporta la integración Matrix n8n?
La integración Matrix n8n es el nodo Matrix que trae n8n de fábrica: habla con tu homeserver (el servidor donde vive tu cuenta de Matrix) a través de su API cliente, usando un token de acceso. Con él cubres lo que una cuenta bot necesita a diario: publicar un mensaje o un archivo en una sala, releer el historial, crear salas, invitar, unirse, expulsar, salir y ver quién está dentro. Matrix sigue siendo tu mensajería, n8n se limita a operarla por ti.
El primer caso es la alerta que aterriza donde de verdad se lee. Un flujo revisa una fuente, la resume en tres líneas y dispara message.create hacia la sala de guardia del equipo. Al ser Matrix una red federada, ese mismo flujo llega igual a un servidor interno de la empresa que a una cuenta de matrix.org, sin duplicar la integración.
En el segundo caso, el informe llega directo a la conversación. Una exportación programada arma el archivo y media.upload lo suelta en la sala, así nadie necesita abrir el correo para ver la cifra de la semana. Si el dato ya vive en una hoja de cálculo, la integración con Google Sheets sigue siendo la fuente real y Matrix solo reparte el aviso.
El tercer caso es el ciclo de vida de las salas sin que nadie las administre a mano. room.create abre una sala por cliente o por proyecto, room.invite añade a quien toca y room.kick cierra el acceso cuando el proyecto termina. roomMember.getAll da la lista real de quién sigue dentro, con lo que la revisión trimestral de accesos deja de ser papeleo y pasa a ser una comprobación directa.
Matrix compite con otros canales para lo mismo. Cuando el equipo ya está instalado en Slack, Telegram o Discord, esos nodos cubren la misma necesidad en su propia red, y nada impide que un flujo publique a la vez en dos de ellos.
Antes de montar nada conviene saber dónde está el límite. El nodo Matrix no escucha nada por iniciativa propia, porque no existe un trigger de Matrix: hace falta un Schedule Trigger a intervalo fijo, un Webhook de n8n (la URL que expone n8n para que otro servicio la llame) o el trigger de otra herramienta para arrancar el flujo. Tampoco están expuestos la presencia, las claves de cifrado, las reacciones ni las confirmaciones de lectura. Si la API cliente ofrece algo que el nodo no cubre, el HTTP Request llama directamente a ese endpoint y reutiliza el mismo credential de Matrix, sin sumar un secreto más que gestionar. Para conocer la plataforma con calma, la Reseña n8n entra en el detalle.
¿Cómo se conecta Matrix con n8n?
- 01
Crea la cuenta de Matrix que usará el flujo
Necesitas una cuenta en un servidor Matrix, en matrix.org o en un homeserver que gestione tu empresa. Usa una cuenta dedicada y no la tuya personal: cada mensaje que envíe el flujo llevará esa identidad, y el token sigue siendo válido mientras la cuenta no lo revoque. Ponle un nombre que el equipo reconozca en la lista de miembros, porque eso es lo que verán cuando la automatización publique algo.
- 02
Consigue el token de acceso y la URL del homeserver
La conexión se abre con dos valores. El Access Token está ligado a la cuenta con la que entras en Matrix. La Homeserver URL es la dirección del servidor que elegiste al crear la cuenta. En la mayoría de clientes ambos aparecen en Settings > Help & About > Advanced, aunque la ruta exacta depende del cliente, así que revisa su documentación si el menú no coincide.
- 03
Guarda el credential una sola vez en n8n
En n8n abre el menú Credentials y crea un credential de Matrix, es decir, el acceso guardado que el nodo reutiliza. Pega el token y luego la URL del homeserver: n8n rellena ese campo con el servidor de matrix.org, cámbialo si tu cuenta está en otro sitio. Una vez guardado, cada nodo Matrix de cada flujo lo elige en un desplegable, sin reescribir nada y sin dejar el secreto dentro de un parámetro.
¿Qué sabe hacer el nodo Matrix ?
El nodo Matrix expone 11 operaciones en 6 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create | Get | Get Many | Invite | Join | Kick | Leave | Me | Upload |
|---|---|---|---|---|---|---|---|---|---|
| Account | ✓ | ||||||||
| Event | ✓ | ||||||||
| Media | ✓ | ||||||||
| Message | ✓ | ✓ | |||||||
| Room | ✓ | ✓ | ✓ | ✓ | ✓ | ||||
| Room Member | ✓ |
Account
1 operaciónGet the current user's account information
account.meLo que ves en n8n
Notas y casos de uso
Devuelve la información de la cuenta a la que pertenece el token de acceso. No hay nada que rellenar: el nodo responde por la cuenta que emitió ese token, lo que lo convierte en la prueba de credential más barata que existe.
Event
1 operaciónGet an event by ID
event.getLo que ves en n8n
Notas y casos de uso
Recupera un único evento de una sala a partir de su identificador. Es la forma de volver más tarde sobre un mensaje concreto, un cambio de membresía o un archivo.
Parámetros clave
- Room ID: la sala del evento, con la forma
!123abc:matrix.org. - Event ID: el evento en sí, escrito
$1234abcd:matrix.org, casi siempre pasado como{{ $json.eventId }}desde el nodo que lo creó.
Media
1 operaciónUpload media to a chatroom
media.uploadLo que ves en n8n
Notas y casos de uso
Envía a una sala un archivo que ya viaja en el flujo como dato binario. Acaba dentro de la conversación y no en un buzón.
Parámetros clave
- Room Name or ID: la sala, elegida en la lista o indicada con una expresión, la sintaxis de n8n que toma un valor del nodo anterior.
- Input Binary Field: el nombre del campo binario que contiene el archivo,
dataen casi todos los nodos de descarga. - Media Type: File, Image, Audio o Video, que decide cómo lo muestra el cliente de Matrix.
- File Name: opcional, fija el nombre visible del adjunto.
Message
2 operacionesCreate a message
message.createLo que ves en n8n
Notas y casos de uso
Publica un mensaje en una sala. La mayoría de los flujos termina aquí, con cuatro ajustes opcionales que cambian el aspecto del texto.
Parámetros clave
- Room Name or ID: el destino, tomado de la lista o escrito como
!123abc:matrix.org. - Text: el cuerpo del mensaje, por ejemplo
Hello from n8n!o una expresión montada con el nodo anterior. - Message Type: Text para un mensaje normal, Notice para salida de máquina, Emote para una acción.
- Message Format: Plain Text, o HTML si quieres enlaces y negritas.
- Fallback Text: la versión en texto plano que se muestra cuando el cliente no puede dibujar el HTML.
Get many messages
message.getAllLo que ves en n8n
Notas y casos de uso
Trae el historial de una sala al flujo, un item por evento. La conversación se convierte en datos que puedes contar, filtrar o archivar.
Parámetros clave
- Room Name or ID: la sala que vas a releer.
- Return All: activado, n8n encadena las páginas hasta agotar los eventos; desactivado, se detiene en Limit.
- Filter: un RoomEventFilter en JSON, por ejemplo
{"contains_url":true}para quedarte solo con los eventos que llevan un enlace.
Room
5 operacionesCreate a room
room.createLo que ves en n8n
Notas y casos de uso
Abre una sala en el homeserver y devuelve su identificador, que los nodos siguientes reutilizan para invitar gente o publicar el primer mensaje.
Parámetros clave
- Room Name: cómo se llama la sala, por ejemplo
My new room. - Preset: Private Chat, o Public Chat para una sala abierta y pública. Ese ajuste decide quién puede entrar.
- Room Alias: opcional, una dirección legible como
coolest-room-arounda la que unirse en lugar del identificador crudo.
Invite a room
room.inviteLo que ves en n8n
Notas y casos de uso
Manda una invitación a un usuario de Matrix. La persona todavía tiene que aceptar, así que esto propone una entrada, no la impone.
Parámetros clave
- Room Name or ID: la sala a la que invitar.
- User ID: el identificador completo del invitado, escrito
@cheeky_monkey:matrix.org, normalmente leído de tu directorio con{{ $json.matrixId }}.
Join a room
room.joinLo que ves en n8n
Notas y casos de uso
Hace que la cuenta del credential entre en una sala. Un robot invitado se queda fuera hasta que esto se ejecuta, y ningún nodo puede publicar en una sala donde su cuenta no ha entrado.
Parámetros clave
- Room ID or Alias: aquí valen las dos formas, el identificador crudo y el alias legible, lo que la convierte en la única operación de sala que puedes lanzar con un nombre escrito por ti.
Kick a user from a room
room.kickLo que ves en n8n
Notas y casos de uso
Saca a alguien de una sala. La cuenta del credential necesita permiso para hacerlo, y la persona puede volver a ser invitada después, así que no equivale a un veto permanente.
Parámetros clave
- Room Name or ID: la sala de la que se la retira.
- User ID: el identificador completo de esa persona.
- Reason: texto opcional que queda guardado con la expulsión, del tipo
Telling unfunny jokes.
Leave a room
room.leaveLo que ves en n8n
Notas y casos de uso
La cuenta robot se marcha de una sala por decisión propia. No se borra nada, la sala y su historial siguen ahí para el resto de miembros, y la cuenta deja de recibir lo que ocurre dentro.
Parámetros clave
- Room Name or ID: la sala que se abandona, elegida en la lista o indicada con una expresión.
Room Member
1 operaciónGet many room members
roomMember.getAllLo que ves en n8n
Notas y casos de uso
Lista a las personas vinculadas a una sala, un item por miembro, con su estado de membresía. Es la cara de lectura de invitar, expulsar y salir.
Parámetros clave
- Room Name or ID: la sala que quieres inspeccionar.
- Membership: quedarte solo con Join, Invite, Leave o Ban, o Any para no filtrar.
- Exclude Membership: el filtro espejo, que descarta un estado en vez de conservarlo.
¿Necesitas ayuda para automatizar Matrix con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
