Recursos · Integración n8n

Integración Bitbucket n8nAutomatiza Bitbucket con n8n.

La integración Bitbucket n8n se reduce a un trigger, sin nodo de acción. El Bitbucket Trigger escucha los eventos de un repositorio por webhook, una URL que Bitbucket llama cuando algo ocurre, y pide un espacio de trabajo, un repositorio y los eventos elegidos.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Qué cubre de verdad la integración Bitbucket n8n?

La integración Bitbucket n8n circula en un solo sentido, y conviene saberlo antes de dibujar el flujo. n8n trae un nodo Bitbucket Trigger, así que los eventos de un repositorio pueden arrancar una automatización. Lo que no existe en el catálogo es un nodo de acción Bitbucket: nada de esto crea ni modifica nada dentro de Bitbucket. Bitbucket habla, n8n escucha y el trabajo ocurre en las herramientas que conectes después.

El uso más directo es avisar a quien toca. El trigger arranca con los eventos marcados y el flujo manda un correo por Gmail con los datos que de verdad importan del contenido recibido, y no con el formato que un bot genérico te habría impuesto.

Segundo uso: dejar rastro. Cada evento recibido se convierte en un archivo o una fila guardada en Google Drive, con el espacio de trabajo, el repositorio y la hora de llegada. Útil cuando el equipo necesita un historial legible fuera de Bitbucket sin montar una plataforma de logs.

Tercer uso: el relevo. El trigger lanza la ejecución, un paso de filtro descarta los eventos que no interesan y solo el resto sigue adelante. Lo que venga después puede ser cualquier herramienta que n8n alcance, y ahí es donde la ausencia de nodo de acción deja de molestar.

Queda el caso que hay que prever: escribir en Bitbucket. Como no hay nodo de acción, eso pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de Bitbucket reutilizando el mismo credential con la autenticación predefinida. Un solo token que mantener.

Dos límites antes de empezar. El trigger pide un espacio de trabajo y un repositorio, así que vigila un repositorio cada vez: varios repositorios significan un flujo por repositorio, o una expresión que rellene ese campo. Y la lista de eventos la sirve Bitbucket, de modo que lo que puedes escuchar depende de la cuenta y de los scopes del token. ¿Empiezas con la plataforma? La Reseña n8n cuenta qué hace bien, y el Curso n8n enseña a construir los flujos.

Conexión

¿Cómo conectar Bitbucket con n8n?

  1. 01

    Crear un token API en Bitbucket

    Entra en Bitbucket y abre los ajustes de tu cuenta o tus ajustes personales. Busca la sección de tokens API o de seguridad. Crea ahí un token nuevo, ponle un nombre que reconozcas dentro de unos meses y una fecha de caducidad acorde con el uso: un token sin caducidad es un token que nadie renueva. Tener una cuenta de Bitbucket es el único requisito previo.

  2. 02

    Marcar los seis scopes necesarios

    Elige Bitbucket como aplicación y marca los scopes, es decir los permisos que llevará el token. Tres sirven para leer: read:user:bitbucket, read:workspace:bitbucket y read:repository:bitbucket, que permiten a n8n ofrecerte tus espacios de trabajo y repositorios en los desplegables. Tres son para el webhook: read:webhook:bitbucket, write:webhook:bitbucket y delete:webhook:bitbucket.

  3. 03

    Guardar el credential en n8n

    Confirma la creación del token y cópialo en ese mismo momento. En n8n, abre el menú Credentials y crea un credential de Bitbucket con el método de token de acceso, pegando el valor. Un credential se crea una vez y se reutiliza en todas partes: el Bitbucket Trigger te lo ofrecerá en su desplegable, y cualquier nodo HTTP Request apuntado a la API de Bitbucket también podrá usarlo.

Disparadores

¿Qué arranca el flujo desde Bitbucket ?

Bitbucket Trigger es el nodo que arranca un workflow con cada nueva respuesta recibida en Bitbucket. Eliges el formulario, activas el workflow y n8n registra el webhook en tu cuenta de Bitbucket.

Lo que ves en n8n

Notas de configuración

01Set Up the Bitbucket TriggerEste nodo es la puerta de entrada del flujo: espera a que Bitbucket comunique algo y arranca una ejecución con ese contenido como primer item. La versión 1 del nodo pide cuatro campos, todos obligatorios.

Este nodo es la puerta de entrada del flujo: espera a que Bitbucket comunique algo y arranca una ejecución con ese contenido como primer item. La versión 1 del nodo pide cuatro campos, todos obligatorios.

Parámetros clave

  • Resource : lo que vigila el trigger, y lo que determina si los campos siguientes apuntan a un espacio de trabajo o a un repositorio concreto.
  • Workspace Name or ID : el espacio de trabajo cuyos eventos quieres. Elígelo en la lista que n8n carga desde el credential, o pasa un identificador con una expresión como {{ $json.workspace }}, la sintaxis de n8n para leer un campo del item entrante.
  • Repository Name or ID : el repositorio que se escucha, elegido en un desplegable igual o indicado por expresión.
Casos de uso
el repositorio principal de un equipo enganchado a un único flujo permanente, con valores elegidos una vez en las listas y nunca tocados otra vez.
02Select the Event Names to Listen ToMientras este campo siga vacío, al flujo no llega nada. El nodo no propone ningún evento por defecto: carga las opciones desde Bitbucket en cuanto el credential y el repositorio están puestos, de manera que la lista refleja esa cuenta y no un catálogo fijo dentro de n8n.

Mientras este campo siga vacío, al flujo no llega nada. El nodo no propone ningún evento por defecto: carga las opciones desde Bitbucket en cuanto el credential y el repositorio están puestos, de manera que la lista refleja esa cuenta y no un catálogo fijo dentro de n8n.

Parámetros clave

  • Event Names or IDs : un campo de selección múltiple, así que varios eventos pueden alimentar el mismo flujo. Márcalos en la lista, o entrega los identificadores con una expresión cuando la selección cambie según el entorno.
Cuándo usarlo
sé selectivo. Cada evento marcado provoca una ejecución, y un flujo suscrito a todo se pasa el día filtrando un ruido que pidió él mismo. Empieza por el evento al que la automatización reacciona de verdad y amplía después.
Casos de uso
una lista de comprobación de despliegue suscrita a dos o tres eventos del repositorio de producción y callada el resto del día.
03Activate the Workflow to Register the WebhookConfigurar el nodo todavía no cambia nada en Bitbucket. n8n registra su URL de webhook en Bitbucket al activar el flujo, de ahí el permiso de escritura sobre webhooks en el token, y la retira cuando lo desactivas.

Configurar el nodo todavía no cambia nada en Bitbucket. n8n registra su URL de webhook en Bitbucket al activar el flujo, de ahí el permiso de escritura sobre webhooks en el token, y la retira cuando lo desactivas.

Cuándo usarlo
activa en cuanto los cuatro campos estén rellenos y luego provoca el evento en Bitbucket para ver la primera ejecución. La entrega funciona en modo push: cada evento llega a n8n en segundos, sin ningún intervalo de consulta entre los dos sistemas.
Casos de uso
un flujo que debe responder mientras la persona que programó sigue mirando la pantalla, un recordatorio de revisión o un mensaje de estado. Desactivar también es la forma limpia de pausar una integración demasiado habladora, porque el webhook desaparece del repositorio en lugar de acumular ejecuciones que luego hay que borrar.
Necesitas ayuda

¿Necesitas ayuda para automatizar Bitbucket con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Bitbucket y n8n: preguntas frecuentes

01¿Es gratis la integración Bitbucket n8n?
Sí por el lado de n8n. El Bitbucket Trigger viene incluido con n8n, así que no hay nada que instalar ni ningún coste adicional por el nodo en sí. Vale tanto en n8n Cloud, la oferta alojada por n8n, como en una instancia autoalojada instalada con Docker o npm en Community Edition, bajo licencia Sustainable Use. Un flujo construido en un sitio se comporta igual en el otro. Lo que cueste la cuenta de Bitbucket es otra historia, depende de tu plan con ellos y esta página no lo trata.
02¿Qué credenciales y permisos necesita el Bitbucket Trigger?
Un token de acceso y poco más. La autenticación se hace con un token API creado desde los ajustes de tu cuenta o tus ajustes personales, con Bitbucket elegido como aplicación y seis scopes marcados: read:user:bitbucket, read:workspace:bitbucket y read:repository:bitbucket para leer, más read:webhook:bitbucket, write:webhook:bitbucket y delete:webhook:bitbucket para que n8n cree y retire su propio webhook. Sin el permiso de escritura el flujo se activa pero no recibe nada nunca. El token se muestra una sola vez al crearlo, así que pégalo enseguida en el credential de n8n, que luego podrás reutilizar en todos tus flujos.
03¿Qué límites tiene Bitbucket dentro de n8n?
El principal es el alcance. n8n ofrece un trigger de Bitbucket y ningún nodo de acción: un flujo puede reaccionar a los eventos de un repositorio, pero no crear, modificar ni borrar nada en Bitbucket con un nodo dedicado. Todo lo que quieras escribir pasa por el nodo HTTP Request, que alcanza cualquier endpoint de la API de Bitbucket reutilizando el mismo credential con la autenticación predefinida. El trigger apunta además a un espacio de trabajo y un repositorio por nodo, así que cubrir varios repositorios exige varios flujos o una expresión que aporte el valor. Los eventos disponibles los define Bitbucket, no una lista fija de n8n.
04¿El Bitbucket Trigger reacciona en tiempo real?
Sí. Funciona por webhook: Bitbucket llama a una URL de n8n en cuanto ocurre un evento, en vez de que n8n pregunte una y otra vez si algo ha cambiado. n8n registra esa URL en Bitbucket cuando activas el flujo y la retira cuando lo desactivas. No hay ningún intervalo que ajustar ni retraso que prever, los eventos llegan en segundos. La consecuencia práctica es que nada se entrega mientras el flujo está apagado, y un flujo desactivado no recupera lo que se perdió cuando vuelves a encenderlo.
05¿n8n o Make para Bitbucket?
Depende de dónde quieras que vivan los datos y de cómo prefieras pagar. Make es una plataforma alojada, sin opción de autoalojamiento, facturada por operación: encaja con equipos que no quieren administrar nada. n8n corre en su propio Cloud o en tus servidores, de modo que el contenido que envían los repositorios puede quedarse en tu infraestructura, y el coste sigue al alojamiento y no al volumen de eventos. Ambas tienen un editor visual, así que la decisión rara vez se juega ahí. En un repositorio activo que dispara un evento por cada cambio, suele decidir el contador por operación.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.