Ressources · Intégration n8n

Intégration Bitbucket n8nAutomatiser Bitbucket avec n8n.

L'intégration Bitbucket n8n se résume à un trigger, sans nœud d'action. Le Bitbucket Trigger écoute les événements d'un dépôt via un webhook, une URL que Bitbucket appelle quand il se passe quelque chose. Il demande un espace de travail, un dépôt et des événements.

Tester l'intégration Bitbucket sur n8n

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

Pourquoi automatiser

Que couvre vraiment l'intégration Bitbucket n8n ?

L'intégration Bitbucket n8n va dans un seul sens, et mieux vaut le savoir avant de dessiner le workflow. n8n fournit un nœud Bitbucket Trigger : les événements d'un dépôt peuvent donc lancer une automatisation. En revanche le catalogue n'a aucun nœud d'action Bitbucket, donc rien ici ne crée ni ne modifie quoi que ce soit dans Bitbucket. Bitbucket parle, n8n écoute, et le travail se fait dans les outils branchés derrière.

Le premier usage tient en une phrase : prévenir les bonnes personnes. Le trigger part sur les événements cochés et le workflow envoie un message formaté dans Telegram, avec les seules informations utiles du contenu reçu. Un bot générique t'aurait imposé son format.

Deuxième usage : la trace. Chaque événement reçu devient une ligne dans Airtable, avec l'espace de travail, le dépôt et l'heure d'arrivée. Pratique quand une équipe a besoin d'un historique lisible hors de Bitbucket, sans installer une plateforme de logs pour ça.

Troisième usage : le relais. Le trigger démarre l'exécution, une étape de filtre écarte les événements sans intérêt, et seuls les autres continuent. La suite peut être n'importe quel outil que n8n sait joindre, et c'est là que l'absence de nœud d'action cesse d'être gênante.

Reste le cas à anticiper : écrire dans Bitbucket. Comme aucun nœud d'action n'existe, ça passe par le nœud HTTP Request, qui appelle n'importe quel endpoint de l'API Bitbucket en réutilisant le même credential grâce à l'authentification prédéfinie. Un seul jeton à gérer, pas deux.

Deux limites à connaître avant de te lancer. Le trigger réclame un espace de travail et un dépôt, donc il surveille un dépôt à la fois : plusieurs dépôts, c'est un workflow par dépôt ou une expression qui alimente le champ. Et la liste d'événements vient de Bitbucket : ce que tu peux écouter dépend du compte et des scopes du jeton. Si n8n est nouveau pour toi, l'Avis n8n dit ce que l'outil vaut, et la Formation n8n apprend à construire les workflows.

Connexion

Comment brancher Bitbucket sur n8n ?

  1. 01

    Créer un jeton API dans Bitbucket

    Connecte-toi à Bitbucket et ouvre les paramètres de ton compte ou tes paramètres personnels. Repère la section dédiée aux jetons API ou à la sécurité. Crée un nouveau jeton, donne-lui un nom que tu reconnaîtras dans six mois et une date d'expiration cohérente avec l'usage : un jeton sans échéance est un jeton que personne ne renouvelle. Un compte Bitbucket suffit comme prérequis.

  2. 02

    Cocher les six scopes attendus

    Choisis Bitbucket comme application, puis coche les scopes, c'est-à-dire les droits accordés au jeton. Trois servent à lire : read:user:bitbucket, read:workspace:bitbucket et read:repository:bitbucket, qui permettent à n8n de proposer tes espaces de travail et tes dépôts dans les listes déroulantes. Trois servent au webhook : read:webhook:bitbucket, write:webhook:bitbucket et delete:webhook:bitbucket.

  3. 03

    Enregistrer le credential dans n8n

    Valide la création du jeton et copie-le tout de suite. Dans n8n, ouvre le menu Credentials et crée un credential Bitbucket avec la méthode par jeton d'accès, en collant la valeur. Un credential se crée une fois et se réutilise partout : le Bitbucket Trigger te le proposera dans sa liste déroulante, et un nœud HTTP Request pointé vers l'API Bitbucket pourra s'en servir aussi.

Déclencheurs

Qu'est-ce qui lance le workflow depuis Bitbucket ?

Bitbucket Trigger est le nœud qui démarre un workflow à chaque nouvelle réponse reçue dans Bitbucket. Tu choisis le formulaire, tu actives le workflow : n8n enregistre le webhook sur ton compte Bitbucket.

Ce que tu vois dans n8n

Notes de configuration

01Set Up the Bitbucket TriggerCe nœud est la porte d'entrée du workflow : il attend que Bitbucket signale quelque chose et démarre une exécution avec le contenu reçu comme premier item. La version 1 du nœud demande quatre champs, tous obligatoires.

Ce nœud est la porte d'entrée du workflow : il attend que Bitbucket signale quelque chose et démarre une exécution avec le contenu reçu comme premier item. La version 1 du nœud demande quatre champs, tous obligatoires.

Paramètres clés

  • Resource : ce que le trigger surveille, ce qui détermine si les champs suivants visent un espace de travail ou un dépôt précis.
  • Workspace Name or ID : l'espace de travail concerné. Prends-le dans la liste que n8n charge à partir du credential, ou fournis un identifiant via une expression comme {{ $json.workspace }}, la syntaxe n8n pour aller chercher un champ dans l'item entrant.
  • Repository Name or ID : le dépôt à écouter, choisi dans le même type de liste ou renseigné par expression.
Cas d'usage
le dépôt principal d'une équipe branché sur un workflow unique, dont les valeurs sont choisies une fois dans les listes et plus jamais touchées.
02Select the Event Names to Listen ToTant que ce champ reste vide, rien n'arrive dans le workflow. Le nœud ne propose aucun événement par défaut : il charge les choix depuis Bitbucket une fois le credential et le dépôt renseignés, si bien que la liste reflète ce compte-là plutôt qu'un catalogue figé dans n8n.

Tant que ce champ reste vide, rien n'arrive dans le workflow. Le nœud ne propose aucun événement par défaut : il charge les choix depuis Bitbucket une fois le credential et le dépôt renseignés, si bien que la liste reflète ce compte-là plutôt qu'un catalogue figé dans n8n.

Paramètres clés

  • Event Names or IDs : un champ à choix multiple, plusieurs événements peuvent donc alimenter le même workflow. Coche-les dans la liste, ou passe les identifiants par une expression quand la sélection change selon l'environnement.
Quand l'utiliser
reste sélectif. Chaque événement coché déclenche une exécution, et un workflow abonné à tout passe son temps à filtrer un bruit qu'il a lui-même demandé. Commence par l'événement auquel l'automatisation réagit réellement.
Cas d'usage
une checklist de mise en production abonnée à deux ou trois événements du dépôt de prod, muette le reste de la journée.
03Activate the Workflow to Register the WebhookConfigurer le nœud ne change encore rien côté Bitbucket. C'est à l'activation du workflow que n8n enregistre son URL de webhook auprès de Bitbucket, d'où le droit d'écriture sur les webhooks dans le jeton, et c'est à la désactivation qu'il la retire.

Configurer le nœud ne change encore rien côté Bitbucket. C'est à l'activation du workflow que n8n enregistre son URL de webhook auprès de Bitbucket, d'où le droit d'écriture sur les webhooks dans le jeton, et c'est à la désactivation qu'il la retire.

Quand l'utiliser
active dès que les quatre champs sont remplis, puis provoque l'événement dans Bitbucket pour voir la première exécution. La livraison se fait en mode push : chaque événement arrive dans n8n en quelques secondes, sans intervalle d'interrogation entre les deux systèmes.
Cas d'usage
un workflow qui doit réagir pendant que le développeur a encore son écran sous les yeux, rappel de relecture ou message de statut. La désactivation est aussi la façon propre de mettre en pause une intégration trop bavarde, puisque le webhook disparaît du dépôt au lieu d'empiler des exécutions à supprimer.
Besoin d'aide

Besoin d'aide pour automatiser Bitbucket avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Bitbucket et n8n : les questions fréquentes

01L'intégration Bitbucket n8n est-elle gratuite ?
Oui du côté de n8n. Le Bitbucket Trigger est livré avec n8n, il n'y a donc rien à installer et rien à payer en plus pour le nœud lui-même. C'est vrai sur n8n Cloud, l'offre hébergée par n8n, comme sur une instance auto-hébergée installée avec Docker ou npm en Community Edition, sous licence Sustainable Use. Un workflow construit d'un côté se comporte pareil de l'autre. Ce que coûte le compte Bitbucket est une autre question, elle dépend de ton abonnement chez eux et cette page ne la traite pas.
02Quels credentials et quels droits demande le Bitbucket Trigger ?
Un jeton d'accès, et c'est tout. L'authentification passe par un jeton API créé depuis tes paramètres de compte ou tes paramètres personnels, avec Bitbucket choisi comme application et six scopes cochés : read:user:bitbucket, read:workspace:bitbucket et read:repository:bitbucket pour la lecture, puis read:webhook:bitbucket, write:webhook:bitbucket et delete:webhook:bitbucket pour que n8n crée et retire son propre webhook. Sans le droit d'écriture, le workflow s'active mais ne reçoit jamais rien. Le jeton ne s'affiche qu'une fois à la création : colle-le immédiatement dans le credential n8n, qui sera ensuite réutilisable dans tous tes workflows.
03Quelles sont les limites de Bitbucket dans n8n ?
La principale tient au périmètre. n8n propose un trigger Bitbucket et aucun nœud d'action : un workflow peut réagir aux événements d'un dépôt, mais il ne peut rien créer, modifier ni supprimer dans Bitbucket via un nœud dédié. Tout ce que tu veux écrire passe par le nœud HTTP Request, qui joint n'importe quel endpoint de l'API Bitbucket en réutilisant le même credential grâce à l'authentification prédéfinie. Le trigger vise aussi un espace de travail et un dépôt par nœud : couvrir plusieurs dépôts demande plusieurs workflows, ou une expression qui fournit la valeur. Les événements disponibles viennent de Bitbucket, pas d'une liste figée dans n8n.
04Le Bitbucket Trigger réagit-il en temps réel ?
Oui. Il fonctionne par webhook : Bitbucket appelle une URL n8n dès qu'un événement se produit, au lieu que n8n demande en boucle si quelque chose a bougé. n8n enregistre cette URL auprès de Bitbucket quand tu actives le workflow et la retire quand tu le désactives. Il n'y a donc aucun intervalle à régler ni délai à prévoir, les événements arrivent en quelques secondes. Conséquence pratique : rien n'est livré pendant que le workflow est éteint, et un workflow désactivé ne rattrape pas ce qu'il a manqué lorsque tu le rallumes.
05n8n ou Make pour Bitbucket ?
Ça dépend de l'endroit où doivent vivre les données et de la façon dont tu veux payer. Make est une plateforme hébergée, sans option d'auto-hébergement, facturée à l'opération : bon choix pour une équipe qui ne veut rien administrer. n8n tourne sur son propre Cloud ou sur tes serveurs, les contenus renvoyés par les dépôts peuvent donc rester dans ton infrastructure, et le coût suit l'hébergement plutôt que le volume d'événements. Les deux offrent un éditeur visuel, la décision se joue rarement là. Sur un dépôt actif qui envoie un événement à chaque commit, c'est le compteur à l'opération qui tranche le plus souvent.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations