Ressources · Intégration n8n

Intégration Matrix n8nAutomatiser Matrix avec n8n.

Un salon Matrix peut devenir la sortie par défaut de tes automatisations. L'intégration Matrix n8n est livrée avec l'outil et couvre 11 opérations réparties sur 6 ressources : compte, événement, média, message, salon et membre. Aucun trigger Matrix, donc le départ vient d'ailleurs.

Tester l'intégration Matrix sur n8nVoir les 11 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert l'intégration Matrix n8n ?

L'intégration Matrix n8n, c'est le nœud Matrix intégré à n8n, qui parle à ton homeserver (le serveur qui héberge ton compte Matrix) via son API client, avec un jeton d'accès. Il fait ce qu'un compte robot doit savoir faire : poster un message ou un fichier dans un salon, relire l'historique, créer un salon, inviter, rejoindre, exclure, quitter, et lister qui est présent. Matrix reste ta messagerie, n8n devient la main qui la pilote.

Premier scénario : l'astreinte qui reçoit la bonne alerte au bon endroit. Un workflow surveille une source, met en forme trois lignes lisibles et appelle message.create sur le salon d'équipe. Matrix étant fédéré, le même workflow atteint un serveur interne et un compte matrix.org sans deuxième intégration à maintenir.

Deuxième scénario : le document qui arrive dans la conversation. Un export planifié génère un fichier, et media.upload le dépose directement dans le salon. Personne n'ouvre sa boîte mail pour lire le chiffre de la semaine. Si les données viennent déjà d'un tableur, l'intégration Google Sheets reste la source et Matrix ne porte que la notification.

Troisième scénario : le cycle de vie des salons sans administrateur humain. room.create ouvre un salon par client ou par projet, room.invite y amène les bonnes personnes, room.kick referme l'accès à la fin. Avec roomMember.getAll, tu obtiens la liste réelle des présents, ce qui rend la revue d'accès trimestrielle vérifiable au lieu d'être déclarative.

Matrix n'est évidemment pas le seul canal possible. Si tes équipes vivent déjà dans Slack, Telegram ou Discord, ces nœuds font le même travail sur leur réseau, et rien n'empêche un workflow de poster sur deux canaux en parallèle.

Reste les bords du nœud, à connaître avant de construire. Il n'écoute jamais tout seul : pas de trigger Matrix, donc un Schedule Trigger à intervalle fixe, un Webhook n8n (une URL exposée par n8n qu'un service tiers appelle) ou le trigger d'un autre outil démarre l'exécution. La présence, les clés de chiffrement, les réactions et les accusés de lecture ne sont pas exposés non plus. Quand l'API client propose un point d'entrée absent du nœud, le nœud HTTP Request l'appelle en réutilisant le même credential Matrix, donc un seul secret à gérer. Pour situer la plateforme dans son ensemble, l'Avis n8n entre dans le détail.

Connexion

Comment connecter Matrix à n8n ?

  1. 01

    Créer le compte Matrix dédié à l'automatisation

    Il te faut un compte sur un serveur Matrix, sur matrix.org ou sur un homeserver géré par ta société. Prends un compte dédié plutôt que le tien : chaque message envoyé par le workflow portera cette identité, et le jeton reste valable tant que le compte ne le révoque pas. Donne-lui un nom que l'équipe reconnaîtra dans la liste des membres, puisque c'est ce que les gens verront quand l'automatisation postera.

  2. 02

    Récupérer le jeton d'accès et l'URL du homeserver

    Deux valeurs ouvrent la connexion. L'Access Token est rattaché au compte avec lequel tu te connectes à Matrix. La Homeserver URL est l'adresse du serveur choisi à la création du compte. Dans la plupart des clients, les deux se trouvent dans Settings > Help & About > Advanced, mais le chemin exact dépend du client, donc vérifie sa documentation si le menu diffère chez toi.

  3. 03

    Enregistrer le credential une fois dans n8n

    Dans n8n, ouvre le menu Credentials et crée un credential Matrix, c'est-à-dire l'identifiant stocké que le nœud réutilise. Colle le jeton, puis l'URL du homeserver : n8n préremplit ce champ avec le serveur de matrix.org, donc change-le si ton compte est ailleurs. Une fois enregistré, chaque nœud Matrix de chaque workflow le sélectionne dans une liste déroulante, sans rien retaper et sans secret écrit dans un paramètre.

Actions

Que sait faire le nœud Matrix ?

Le nœud Matrix expose 11 opérations sur 6 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceCreateGetGet ManyInviteJoinKickLeaveMeUpload
Account✓
Event✓
Media✓
Message✓✓
Room✓✓✓✓✓
Room Member✓

Account

1 opération
01

Get the current user's account information

account.me

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie les informations du compte auquel le jeton d'accès appartient. Rien à configurer : le nœud répond pour le compte qui a émis le jeton, ce qui en fait le test de credential le moins cher du lot.

Cas d'usage
place-le en premier dans un workflow neuf et lance-le une fois. S'il renvoie bien le compte robot attendu, c'est que le jeton et l'URL du homeserver sont d'accord entre eux, et tu peux passer aux opérations qui écrivent vraiment quelque chose.

Event

1 opération
02

Get an event by ID

event.get

Ce que tu vois dans n8n

Notes & cas d'usage

Va chercher un seul événement d'un salon à partir de son identifiant. C'est le moyen de revenir après coup sur un message précis, un changement d'adhésion ou un fichier.

Paramètres clés

  • Room ID : le salon concerné, sous la forme !123abc:matrix.org.
  • Event ID : l'événement lui-même, écrit $1234abcd:matrix.org, souvent passé en {{ $json.eventId }} depuis le nœud qui l'a créé.
Cas d'usage
un circuit de validation stocke l'identifiant du message posté, puis relit cet événement plus tard pour joindre le texte d'origine au ticket qu'il ouvre.

Media

1 opération
03

Upload media to a chatroom

media.upload

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie dans un salon un fichier déjà porté par le workflow sous forme binaire. Un document ou une capture atterrit dans la conversation, pas dans une boîte mail.

Paramètres clés

  • Room Name or ID : le salon, choisi dans la liste ou donné par une expression, la syntaxe n8n qui va chercher une valeur dans le nœud précédent.
  • Input Binary Field : le nom du champ binaire qui contient le fichier, data dans la plupart des nœuds de téléchargement.
  • Media Type : File, Image, Audio ou Video, ce qui décide de l'affichage côté client Matrix.
  • File Name : facultatif, fixe le nom visible sur la pièce jointe.
Cas d'usage
l'export de nuit dépose le PDF de facturation dans le salon compta.

Message

2 opérations
04

Create a message

message.create

Ce que tu vois dans n8n

Notes & cas d'usage

Poste un message dans un salon. La plupart des workflows finissent dessus, avec quatre réglages facultatifs qui changent l'allure du texte.

Paramètres clés

  • Room Name or ID : la destination, prise dans la liste ou écrite !123abc:matrix.org.
  • Text : le corps du message, par exemple Hello from n8n! ou une expression construite à partir du nœud d'avant.
  • Message Type : Text pour un message normal, Notice pour une sortie machine, Emote pour une action.
  • Message Format : Plain Text, ou HTML si tu veux des liens et du gras.
  • Fallback Text : la version en texte brut affichée quand le client ne sait pas rendre le HTML.
Cas d'usage
un workflow de supervision poste en Notice, lu comme une sortie machine.
05

Get many messages

message.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène l'historique d'un salon dans le workflow, un item par événement. La conversation devient de la donnée que tu peux compter, filtrer ou archiver.

Paramètres clés

  • Room Name or ID : le salon à relire.
  • Return All : activé, n8n enchaîne les pages jusqu'à épuiser les événements ; désactivé, il s'arrête à Limit.
  • Filter : un RoomEventFilter en JSON, par exemple {"contains_url":true} pour ne garder que les événements qui portent un lien.
Cas d'usage
l'archivage de fin de trimestre parcourt le salon support avec Return All et écrit chaque message dans un tableur.

Room

5 opérations
06

Create a room

room.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ouvre un salon sur le homeserver et renvoie son identifiant, que les nœuds suivants réutilisent pour inviter du monde ou poster le premier message.

Paramètres clés

  • Room Name : le nom du salon, par exemple My new room.
  • Preset : Private Chat, ou Public Chat pour un salon ouvert et public. C'est ce réglage qui décide qui peut entrer.
  • Room Alias : facultatif, une adresse lisible comme coolest-room-around que l'on peut rejoindre à la place de l'identifiant brut.
Cas d'usage
une nouvelle signature dans le CRM crée un salon d'accueil au nom du client, en privé, avec un alias dérivé du nom du compte.
07

Invite a room

room.invite

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie une invitation à un utilisateur Matrix. La personne doit encore accepter, donc il s'agit d'une proposition et pas d'une adhésion forcée.

Paramètres clés

  • Room Name or ID : le salon dans lequel inviter.
  • User ID : l'identifiant complet de l'invité, écrit @cheeky_monkey:matrix.org, souvent lu dans ton annuaire avec {{ $json.matrixId }}.
Cas d'usage
juste après la création d'un salon projet, une boucle invite chaque membre de l'équipe depuis une liste, un item d'exécution par personne, et plus personne n'ajoute les gens à la main.
08

Join a room

room.join

Ce que tu vois dans n8n

Notes & cas d'usage

Fait rejoindre un salon au compte du credential. Un robot invité reste dehors tant que ça n'a pas tourné, et un nœud ne peut pas poster dans un salon que son compte n'a pas rejoint.

Paramètres clés

  • Room ID or Alias : les deux formes passent ici, l'identifiant brut comme l'alias lisible, ce qui en fait la seule opération de salon pilotable depuis un nom que tu as tapé toi-même.
Cas d'usage
un workflow d'installation tourne une fois après l'invitation du robot, rejoint tous les salons d'une liste d'alias, et laisse le compte prêt à poster.
09

Kick a user from a room

room.kick

Ce que tu vois dans n8n

Notes & cas d'usage

Sort quelqu'un d'un salon. Le compte du credential doit en avoir le droit, et la personne peut être réinvitée ensuite : ce n'est pas un bannissement.

Paramètres clés

  • Room Name or ID : le salon d'où la retirer.
  • User ID : l'identifiant complet de la personne.
  • Reason : texte facultatif conservé avec l'exclusion, du genre Telling unfunny jokes.
Cas d'usage
un workflow de départ lit les sorties de la semaine et retire chaque personne des salons clients auxquels elle avait accès, avec le numéro de ticket en motif.
10

Leave a room

room.leave

Ce que tu vois dans n8n

Notes & cas d'usage

Le compte robot quitte un salon de lui-même. Rien n'est supprimé, le salon et son historique restent pour les autres membres, et le compte cesse simplement de recevoir ce qui s'y passe.

Paramètres clés

  • Room Name or ID : le salon à quitter, choisi dans la liste ou donné par une expression.
Cas d'usage
un ménage mensuel regarde les salons liés aux projets clos et fait sortir le compte d'automatisation de chacun, pour que sa liste de salons reste courte et sa synchronisation rapide.

Room Member

1 opération
11

Get many room members

roomMember.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Liste les personnes rattachées à un salon, un item par membre, avec leur statut d'adhésion. C'est le côté lecture de l'invitation, de l'exclusion et du départ.

Paramètres clés

  • Room Name or ID : le salon à inspecter.
  • Membership : ne garder que Join, Invite, Leave ou Ban, ou Any pour tout le monde.
  • Exclude Membership : le filtre miroir, qui écarte un statut au lieu d'en garder un.
Cas d'usage
la revue d'accès trimestrielle liste chaque salon avec Membership sur Join et compare le résultat à l'export RH avant toute exclusion.
Besoin d'aide

Besoin d'aide pour automatiser Matrix avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Matrix et n8n, les questions qui reviennent

01L'intégration Matrix n8n est-elle gratuite ?
Oui. Le nœud Matrix est livré avec n8n : rien à installer, rien de plus à payer côté n8n. Il se comporte de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance que tu héberges toi-même avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit sur l'un tourne sur l'autre sans modification. Ce que coûte Matrix lui-même dépend de ton homeserver : un compte sur un serveur public ou sur un serveur géré par ta société est une question distincte de n8n, et le nœud ne fait aucune différence entre les deux.
02Quels credentials faut-il pour le nœud Matrix ?
Un seul credential, construit à partir de deux valeurs. Un Access Token, rattaché au compte avec lequel tu te connectes à Matrix, et une Homeserver URL, l'adresse du serveur où vit ce compte. La plupart des clients affichent les deux dans Settings, puis Help and About, puis Advanced, mais le chemin change d'un client à l'autre, donc vérifie sa documentation. n8n préremplit le champ homeserver avec matrix.org, à modifier si ton compte est ailleurs. Il n'y a pas de sélecteur d'authentification sur le nœud : ce jeton est la seule méthode. Crée le credential une fois dans le menu Credentials, tous les nœuds Matrix le réutilisent.
03Quelles sont les limites du nœud Matrix dans n8n ?
Ça dépend de ce que tu cherches. Le nœud couvre 11 opérations sur 6 ressources : messagerie, médias, cycle de vie des salons et adhésions. La relecture d'historique est paginée, avec Return All désactivé tu n'obtiens que le nombre fixé par Limit, et un salon chargé impose de l'activer. Tout ce que l'API client propose au-delà de ces opérations n'est pas dans le nœud, notamment les réactions, les accusés de lecture et la gestion des clés de chiffrement. Dans ce cas, le nœud HTTP Request appelle le point d'entrée Matrix directement en réutilisant le même credential via l'authentification prédéfinie.
04Le nœud Matrix réagit-il aux nouveaux messages en temps réel ?
Non, parce qu'il n'existe pas de nœud trigger Matrix dans n8n. Rien côté Matrix ne peut démarrer un workflow tout seul, le départ vient donc d'ailleurs. Trois montages couvrent presque tous les besoins. Un Schedule Trigger se déclenche à intervalle fixe et relit le salon avec Get many messages : c'est du polling, autrement dit n8n redemande à échéance régulière au lieu d'être prévenu. Un Webhook n8n te donne une URL qu'un autre service appelle quand il se passe quelque chose. Ou bien le trigger d'un autre outil lance la chaîne, et Matrix n'est que l'endroit où le résultat est publié.
05n8n ou Make pour Matrix ?
Ça dépend de trois critères. L'hébergement d'abord : n8n tourne sur ton serveur ou sur n8n Cloud, quand Make n'existe qu'en hébergé. Si ton homeserver Matrix est déjà chez toi pour des raisons de maîtrise des données, garder l'automatisation au même endroit évite de sortir la donnée du périmètre. Le modèle de coût ensuite : Make facture à l'opération, ce qui compte vite quand un workflow boucle sur chaque membre d'un salon, alors qu'un n8n auto-hébergé ne les compte pas. La logique visuelle enfin : les deux se construisent à l'œil et se relisent bien. Choisis selon ton volume réel.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations