Ressources · Intégration n8n

Intégration Mattermost n8nAutomatiser Mattermost avec n8n.

Envie de synchroniser chaque canal, message et compte utilisateur sans ouvrir la console d'administration Mattermost ? L'intégration Mattermost n8n couvre 19 opérations sur 4 ressources, sans trigger dédié : un Schedule Trigger, ou un Webhook (une URL appelée par un autre outil), lance le workflow à sa place.

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

Pourquoi automatiser

Que peut-on automatiser avec l' intégration Mattermost n8n ?

Le nœud Mattermost dans n8n crée et recherche des canaux, poste et réagit à des messages, et gère des comptes utilisateurs via l'API de Mattermost. Il couvre 4 ressources, Channel, Message, Reaction et User, et 19 opérations au total. Le nœud n'a pas de trigger propre : chaque workflow qui touche Mattermost démarre ailleurs, puis appelle ce nœud pour agir.

Une candidature validée dans l'outil RH déclenche un Webhook n8n : channel.create ouvre un canal privé pour le nouveau projet, user.invite envoie l'invitation par email, puis channel.addUser ajoute la personne au canal général. Résultat : un canal prêt avant le premier point d'équipe, sans copier-coller de pseudos à la main.

Mautic signale un lead chaud : message.post dépose l'alerte dans le canal commercial, avec un Fallback Text et une Color rouge pour qu'elle saute aux yeux dans la liste des canaux. Les équipes qui utilisent aussi Telegram ou Discord pour d'autres groupes peuvent brancher le même workflow sur les deux, et prévoir un relais par SendGrid si personne ne réagit dans le canal.

Un incident déclenche une alerte d'astreinte : message.postEphemeral prévient uniquement la personne de garde, sans ajouter une ligne visible par tout le canal, puis reaction.create marque la prise en charge dès qu'elle répond, plutôt qu'un nouveau message dans le fil.

Le nœud ne couvre pas toute l'API de Mattermost : la gestion des équipes, l'envoi de fichiers et la modification d'un message déjà posté manquent aux 19 opérations. Pour ces cas, le même identifiant Mattermost fonctionne dans un nœud HTTP Request sur n'importe quel endpoint que le nœud dédié n'expose pas. Deux autres limites à connaître avant de construire : plusieurs opérations de liste dépendent de Return All, sans quoi n8n s'arrête à la valeur de Limit ; et channel.restore attend un identifiant de canal brut, pas un nom choisi dans une liste comme les autres opérations sur les canaux.

Construire le premier workflow prend plus de temps que d'en lire la description. L'avis n8n détaille ce que la plateforme fait bien au-delà du chat, et la formation n8n montre comment connecter un premier outil de bout en bout.

Connexion

Comment connecter Mattermost à n8n ?

  1. 01

    Créer un jeton d'accès personnel

    Dans Mattermost, ouvrir Profil, puis Sécurité, puis Personal Access Tokens. Choisir Create Token, saisir une description comme n8n integration pour le retrouver plus tard, valider, puis copier le Token ID renvoyé, prêt à coller dans l'identifiant n8n à l'étape suivante.

  2. 02

    Renseigner la Base URL

    Dans n8n, ouvrir le menu Credentials et ajouter un identifiant Mattermost. Coller le jeton copié dans Access Token, puis indiquer la Base URL du serveur Mattermost, la même adresse que celle utilisée au quotidien pour se connecter, par exemple le domaine Mattermost propre à l'entreprise.

  3. 03

    Relier l'identifiant au nœud

    Enregistrer l'identifiant, déposer un nœud Mattermost dans le workflow et le choisir dans la liste déroulante : le même identifiant se réutilise dans tous les workflows qui touchent Mattermost. Sur un serveur auto-hébergé sans certificat valide, activer Ignore SSL Issues pour que la connexion passe quand même plutôt que d'échouer.

Actions

Ce que sait faire le nœud Mattermost

Le nœud Mattermost expose 19 opérations sur 4 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
RessourceCreateGet ManyDeleteAdd UserDeactiveGet By EmailGet By IDInviteMemberPostPost EphemeralRestoreSearchStatistics
Channel✓✓✓✓✓✓✓
Message✓✓✓
Reaction✓✓✓
User✓✓✓✓✓✓

Channel

7 opérations
01

Add a user to a channel

channel.addUser

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute un utilisateur Mattermost déjà existant à un canal dont il n'est pas encore membre, sans passer par un lien d'invitation.

Paramètres clés

  • Channel Name or ID : le canal cible, choisi dans la liste déroulante ou fourni par une expression, la syntaxe {{ }} qui va chercher une valeur dans l'item entrant, ici {{ $json.channelId }}.
  • User Name or ID : l'utilisateur à ajouter, sélectionné de la même façon, souvent renvoyé par une étape user.getByEmail précédente.
Cas d'usage
faire entrer une nouvelle recrue dans les canaux par défaut de l'équipe juste après que user.invite confirme la création du compte.
02

Create a channel

channel.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un nouveau canal Mattermost dans une équipe, public ou privé.

Paramètres clés

  • Team Name or ID : l'équipe à laquelle appartient le canal.
  • Display Name : le nom affiché dans la liste des canaux, par exemple Announcements.
  • Name : l'identifiant unique utilisé dans l'URL du canal, par exemple announcements, en minuscules et sans espace.
  • Type : à choisir entre Public, ouvert à toute l'équipe, et Private, visible seulement pour les membres ajoutés.
Cas d'usage
ouvrir un canal dédié pour un nouveau projet dès qu'un formulaire ou une ligne de tableur confirme qu'il doit exister.
03

Delete a channel

channel.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Supprime un canal sans l'effacer : Mattermost le marque comme supprimé, ce qui laisse la possibilité de le récupérer plus tard.

Paramètres clés

  • Channel Name or ID : le canal à retirer, choisi dans la liste ou transmis comme identifiant.
Cas d'usage
ranger un canal de projet une fois celui-ci terminé, tout en gardant la possibilité de le restaurer avec channel.restore si quelqu'un a encore besoin de l'historique.
04

Get a page of members for a channel

channel.members

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie la composition d'un canal, page par page.

Paramètres clés

  • Team Name or ID et Channel Name or ID : les deux sont obligatoires ici, alors que channel.delete et channel.statistics se contentent du canal.
  • Resolve Data : désactivé par défaut, n8n ne renvoie que l'identifiant de chaque membre ; activé, il ramène le profil complet de chacun dans le même appel.
  • Return All : décoché, n8n s'arrête à Limit ; coché, il parcourt tous les membres.
Cas d'usage
auditer un canal privé membre par membre, et repérer les comptes que user.deactive a déjà fermés.
05

Restore a soft-deleted channel

channel.restore

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un canal supprimé auparavant avec channel.delete.

Paramètres clés

  • Channel ID : contrairement aux autres opérations sur les canaux, ce champ est une simple chaîne de texte, pas une liste déroulante : l'identifiant exact doit être fourni directement, pas un nom choisi dans une liste.
Cas d'usage
annuler une suppression faite par erreur, ou rouvrir un canal de projet archivé quand un ancien client reprend contact plus tard.
07

Get statistics for a channel

channel.statistics

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie un aperçu rapide de l'activité d'un canal, sans ouvrir Mattermost ni compter quoi que ce soit à la main.

Paramètres clés

  • Channel Name or ID : le canal dont on veut les statistiques, choisi dans la liste ou transmis comme identifiant.
Cas d'usage
la passer sur les canaux que channel.search renvoie pour une équipe, puis archiver avec channel.delete ceux dont les chiffres montrent que plus personne n'y écrit.

Message

3 opérations
08

Delete a message

message.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Même logique que pour un canal : Mattermost marque le message comme supprimé en base au lieu de l'effacer, comme le fait channel.delete.

Paramètres clés

  • Post ID : l'identifiant du message à supprimer, saisi ou passé par une expression, ce champ n'ayant pas de liste déroulante.
Cas d'usage
retirer un message automatisé devenu inexact, par exemple un ancien statut d'astreinte qu'un nouveau message.post a déjà remplacé dans le même canal, pour ne pas laisser deux versions visibles en même temps.
09

Post a message

message.post

Ce que tu vois dans n8n

Notes & cas d'usage

Poste un message dans un canal, en texte simple ou avec une pièce jointe enrichie.

Paramètres clés

  • Channel Name or ID : le canal de destination.
  • Message : le texte du message, qui n'est pas obligatoire ; seul Channel Name or ID l'est, un message peut donc ne porter qu'une pièce jointe.
  • Parent Post ID : pour répondre dans un fil au lieu d'ouvrir un nouveau message.
  • Color et Fallback Text : dans Attachments, la barre de couleur à gauche et le résumé en texte brut obligatoire quand la mise en forme ne passe pas.
Cas d'usage
poster un résultat de build avec une barre verte ou rouge, lisible d'un coup d'œil.
10

Post an ephemeral message

message.postEphemeral

Ce que tu vois dans n8n

Notes & cas d'usage

Seule la personne visée voit ce message, et rien n'en est conservé pour le reste du canal.

Paramètres clés

  • User Name or ID : la seule personne qui verra le message.
  • Channel Name or ID : le canal dans lequel le message apparaît, pour cette personne uniquement.
  • Message : le texte à afficher.
Cas d'usage
prévenir un agent qu'un ticket vient de lui être assigné, sans ajouter une ligne visible par tout le reste du canal.

Reaction

3 opérations
11

Create a reaction

reaction.create

Ce que tu vois dans n8n

Notes & cas d'usage

Ajoute une réaction emoji à un message existant.

Paramètres clés

  • User Name or ID : l'utilisateur au nom duquel la réaction est postée.
  • Post ID : le message concerné, la chaîne qui suit /pl/ dans son lien permanent.
  • Emoji Name : l'emoji à utiliser, sans les deux-points qui l'entourent.
Cas d'usage
marquer un message de support comme traité avec une réaction plutôt qu'avec une réponse de plus dans le fil.
12

Delete a reaction

reaction.delete

Ce que tu vois dans n8n

Notes & cas d'usage

Retire une réaction précise d'un message.

Paramètres clés

  • User Name or ID : la personne dont la réaction doit être retirée.
  • Post ID : le message qui porte la réaction, lu dans la partie /pl/ de son lien permanent.
  • Emoji Name : l'emoji exact à retirer ; les autres réactions du même message restent en place.
Cas d'usage
retirer une réaction automatique posée à l'ouverture du message, dès que reaction.create ajoute celle qui confirme le traitement terminé.
13

Get many reactions

reaction.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Ramène les réactions posées sur un message, ou sur plusieurs d'un coup.

Paramètres clés

  • Post ID : un identifiant de message, ou plusieurs séparés par des virgules, pour lire leurs réactions en un seul appel.
  • Return All et Limit : la même pagination que les autres opérations de liste.
Cas d'usage
compter combien de personnes ont réagi à une annonce avant de décider si elle mérite une relance.

User

6 opérations
14

Create a user

user.create

Ce que tu vois dans n8n

Notes & cas d'usage

Crée un nouveau compte utilisateur Mattermost.

Paramètres clés

  • Username : le seul champ obligatoire.
  • Email et Password : nécessaires ensemble pour l'authentification par email ; Auth Service permet de basculer sur LDAP, SAML, Google, Office365 ou Gitlab.
  • First Name, Last Name, Nickname : dans Additional Fields, les informations de profil affichées à côté de chaque message.
Cas d'usage
créer un compte le matin même où les RH confirment une date d'arrivée, avant que user.invite n'ajoute la personne à une équipe.
15

Deactivate a user

user.deactive

Ce que tu vois dans n8n

Notes & cas d'usage

Désactive un utilisateur et révoque toutes ses sessions actives en archivant l'objet utilisateur ; contrairement à une suppression, le compte et son historique restent en place.

Paramètres clés

  • User ID : le GUID du compte, pas son nom d'utilisateur, souvent obtenu via une étape user.getByEmail précédente.
Cas d'usage
couper l'accès le jour du départ d'un salarié, sans perdre son historique de messages dans les canaux dont il faisait partie.
16

Get a user by email

user.getByEmail

Ce que tu vois dans n8n

Notes & cas d'usage

Recherche un utilisateur Mattermost unique à partir de son adresse email, et renvoie le profil complet plutôt qu'un simple identifiant.

Paramètres clés

  • Email : l'adresse à rechercher, correspondance exacte, par exemple name@email.com.
Cas d'usage
transformer une adresse email récupérée dans un formulaire en identifiant utilisateur dont channel.addUser ou message.postEphemeral ont besoin plus loin dans ce même workflow, sans étape de recherche séparée.
17

Get a user by ID

user.getById

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère le profil complet d'un utilisateur à partir de son identifiant, tout ce que channel.members ne renvoie pas quand Resolve Data est désactivé.

Paramètres clés

  • User IDs : le champ s'écrit au pluriel, mais l'opération renvoie un utilisateur, donc un seul identifiant y suffit.
  • Since : dans Additional Fields, ne renvoie l'utilisateur que si son profil a changé après ce timestamp Unix, exprimé en millisecondes.
Cas d'usage
rafraîchir un nom ou un pseudo mis en cache juste avant un message automatique qui mentionne la personne par son nom.
18

Get many users

user.getAll

Ce que tu vois dans n8n

Notes & cas d'usage

Parcourt l'annuaire des utilisateurs du serveur, sans aucun champ obligatoire à remplir.

Paramètres clés

  • Return All et Limit : la même pagination que les autres opérations de liste.
  • In Channel et In Team : dans Additional Fields, restreindre la liste à un canal ou une équipe plutôt qu'à tout le serveur.
  • Not In Channel et Not In Team : les filtres inverses, pour lister les gens qui manquent encore à un canal ou à une équipe.
  • Sort : trier par username, status, createdAt ou lastActivityAt.
Cas d'usage
sortir la liste des gens qui ne sont pas encore dans le canal d'annonces, et la passer à channel.addUser.
19

Invite a user

user.invite

Ce que tu vois dans n8n

Notes & cas d'usage

Invite une ou plusieurs personnes à rejoindre une équipe Mattermost par email, l'étape qui transforme une adresse en compte une fois l'invitation acceptée. L'invitation porte sur l'équipe ; pour entrer dans un canal, il faut encore channel.addUser.

Paramètres clés

  • Team Name or ID : l'équipe concernée par l'invitation.
  • Emails : une adresse, ou plusieurs séparées par des virgules, envoyées en un seul appel.
Cas d'usage
envoyer l'invitation d'équipe juste après que channel.create a ouvert un nouveau canal de projet, pour que l'invitation et le canal arrivent ensemble.
Besoin d'aide

Besoin d'aide pour automatiser Mattermost avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Mattermost et n8n : les questions avant de construire

01L'intégration Mattermost n8n est-elle gratuite ?
Oui. Le nœud Mattermost est livré avec chaque installation n8n, disponible aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition, sans coût supplémentaire côté n8n dans les deux cas. n8n lui-même s'auto-héberge avec Docker ou npm, ou tourne sur n8n Cloud, l'offre hébergée par n8n, et un workflow construit avec le nœud Mattermost fonctionne à l'identique dans les deux cas. Ce que Mattermost coûte dépend de la formule déjà en place chez l'équipe, auto-hébergée ou Mattermost Cloud, et ce tarif n'est pas couvert sur cette page.
02Quels identifiants faut-il pour connecter Mattermost à n8n ?
Un seul identifiant : un jeton d'accès personnel plus la Base URL du serveur. Le jeton se crée depuis un compte Mattermost, sous Profil puis Sécurité puis Personal Access Tokens, et un administrateur doit d'abord activer cette option pour le compte dans System Console. Une fois enregistré dans le menu Credentials de n8n, l'identifiant se crée une seule fois et se réutilise dans tous les workflows qui touchent Mattermost ; il n'y a pas de méthode d'authentification à choisir sur le nœud lui-même, et la même connexion couvre les 19 opérations de cette page, de la publication d'un message à la gestion d'un utilisateur.
03Quelles sont les limites du nœud Mattermost dans n8n ?
Il couvre 19 opérations réparties sur les canaux, les messages, les réactions et les utilisateurs, pas l'ensemble de l'API Mattermost : la gestion des équipes, l'envoi de fichiers et la modification d'un message déjà posté manquent au nœud. Pour ces cas, un nœud HTTP Request qui réutilise le même identifiant Mattermost atteint l'endpoint que le nœud dédié n'expose pas. Les opérations de liste comme channel.members ou user.getAll dépendent de Return All et Limit pour la pagination, sans Return All coché n8n s'arrête à la valeur de Limit, et channel.restore reste la seule opération qui attend un identifiant de canal brut plutôt qu'un nom choisi dans une liste.
04Le déclenchement Mattermost fonctionne-t-il en temps réel dans n8n ?
Non, Mattermost n'a pas de nœud trigger dédié dans n8n, donc rien ici ne réagit à un nouveau message au moment où il est posté. Un workflow qui doit réagir à Mattermost démarre ailleurs, en général un Schedule Trigger qui se déclenche à intervalle régulier, ou un Webhook appelé par un autre outil comme un service de supervision ou un formulaire. À partir de là, le workflow utilise les opérations de cette page pour lire ou écrire dans Mattermost, message.post et message.postEphemeral étant les deux portes d'entrée les plus courantes.
05n8n ou Make pour Mattermost ?
Les deux se connectent à Mattermost. n8n s'auto-héberge gratuitement avec Docker ou npm, ou tourne sur n8n Cloud, l'offre hébergée par n8n, et un workflow se construit de la même façon dans les deux cas ; Make est uniquement la plateforme hébergée de Make, sans option d'auto-hébergement, facturée à l'opération plutôt qu'à l'exécution du scénario. Les équipes qui veulent garder leurs données sur leurs propres serveurs, ou un coût mensuel fixe quel que soit le volume, penchent en général vers n8n ; celles qui veulent zéro serveur à gérer et un tarif visuel à l'opération préfèrent souvent Make. Aucun des deux n'est un mauvais choix, la décision tient surtout à l'hébergement et au modèle de coût.