Skip to main content

Enterprise Server 3.20 actualmente está disponible como versión candidata para lanzamiento.

Personalizar las notificaciones de GitHub en Teams.

Personalice las notificaciones de GitHub para administrar su trabajo en Teams.

Puede personalizar las notificaciones suscribiéndose a la actividad que sea relevante para su canal de Microsoft Teams y cancelando la suscripción de la actividad que sea menos útil para el proyecto.

Notificaciones habilitadas de forma predeterminada

Las siguientes notificaciones están habilitadas de forma predeterminada, pero puede deshabilitar cualquiera de ellas mediante el comando @GitHub Notifications unsubscribe owner/repo [feature].

CaracterísticaDescripción
issuesProblemas abiertos, cerrados o vueltos a abrir.
pullsSolicitudes de incorporación de cambios nuevas, combinadas, cerradas o reabiertas.
commitsNuevas confirmaciones en la rama predeterminada (normalmente main).
commentsNuevos comentarios sobre informes de problemas y solicitudes de extracción.
deploymentsActualizaciones de estado de implementación.
releasesNuevas versiones y versiones preliminares publicadas.

Nota:

Las notificaciones del repositorio también están habilitadas de forma predeterminada. Recibirá una notificación cuando el repositorio se haga público o se elimine. Esta notificación no se puede deshabilitar, ya que las actualizaciones del repositorio son actividades destructivas.

Notificaciones deshabilitadas de forma predeterminada

Las siguientes notificaciones están deshabilitadas de forma predeterminada, pero puede habilitar cualquiera de ellas mediante el comando @GitHub Notifications subscribe owner/repo [feature].

CaracterísticaDescripción
reviewsRevisiones de solicitudes de incorporación de cambios.
workflowsEjecuciones de flujos de trabajo y notificaciones de aprobación de GitHub Actions.
branchesCreación y eliminación de ramas.
discussionsDiscusiones creadas o contestadas.
+label:"your label"Filtre los problemas, las solicitudes de incorporación de cambios y los comentarios en función de sus etiquetas.

Puede suscribirse o cancelar la suscripción de varias configuraciones a la vez. Por ejemplo:

  • Para activar la actividad para las revisiones y comentarios de solicitudes de incorporación de cambios, use @GitHub Notifications subscribe owner/repo reviews comments.
  • Para desactivar la actividad de problemas y solicitudes de incorporación de cambios, use @GitHub Notifications unsubscribe owner/repo issues pulls.

Filtrado de notificaciones

Puede personalizar aún más las notificaciones con filtros de rama y etiqueta. Los filtros de rama permiten filtrar las notificaciones de confirmación en función de los nombres de rama, mientras que los filtros de etiqueta permiten filtrar las notificaciones de solicitudes de incorporación de cambios y problemas en función de las etiquetas aplicadas.

Filtros de rama para notificaciones de confirmación

Los filtros de rama permiten filtrar las notificaciones de confirmación en función de los nombres de rama. De forma predeterminada, al suscribirse al commits evento, recibirá notificaciones para la rama predeterminada. Sin embargo, puede optar por filtrar por una rama específica o un patrón de ramas o de todas las ramas.

Configuración de ejemploDescripción
@GitHub Notifications subscribe owner/repo commitsRecibir notificaciones de confirmación para la rama predeterminada.
@GitHub Notifications subscribe owner/repo commits:mainSolo recibirá notificaciones de confirmación para la rama main.
@GitHub Notifications subscribe owner/repo commits:feature/*Reciba notificaciones de confirmación para todas las ramas que comienzan por feature/.
@GitHub Notifications subscribe owner/repo commits:*Recibir notificaciones de confirmación para todas las ramas.

Puede cancelar la suscripción a la característica de confirmaciones mediante @GitHub Notifications unsubscribe owner/repo commits.

Nota:

Es posible que haya usado previamente el commits:all filtro para recibir notificaciones de confirmación para todas las ramas. Este filtro es cerrar. Para recibir notificaciones de confirmación para todas las ramas, use el commits:* filtro en su lugar. Si ha configurado previamente el commits:all filtro, seguirá funcionando hasta que actualice la configuración para usar el commits:* filtro.

Filtros de etiquetas para notificaciones de problemas y solicitudes de incorporación de cambios

Los filtros de etiquetas permiten filtrar las notificaciones en función de las etiquetas aplicadas a problemas y solicitudes de incorporación de cambios. Cuando se establece un filtro de etiqueta, solo se enviarán notificaciones para eventos, incluida la etiqueta especificada. Para obtener más información sobre las etiquetas, consulte Administrar las etiquetas y Filtrar y buscar propuestas y solicitudes de cambios.

Actualmente, solo es posible tener un filtro de etiqueta necesario por repositorio. En la tabla siguiente se muestran los tipos de eventos afectados por los filtros de etiqueta.

Tipo de eventoFiltrado por etiqueta
Solicitudes de incorporación de cambios
Problemas
Comentarios
Revisiones
Confirmaciones/Envíos
Ramas

Creación de filtros de etiquetas

Para crear un filtro de etiqueta, use el siguiente formato de comando:

Text
@GitHub Notifications subscribe [owner/repo] +label:"your label"

Esto crea un filtro de etiqueta requerida con el valor your label. Los eventos entrantes que admiten filtros se descartan a menos que tengan esa etiqueta.

Actualización de filtros de etiquetas

Puede actualizar un filtro de etiqueta existente especificando un nuevo valor de etiqueta:

Text
@GitHub Notifications subscribe [owner/repo] +label:"new label"

Esto reemplazará el filtro "su etiqueta" por el filtro "nueva etiqueta".

Eliminación de filtros de etiquetas

Puede quitar un filtro de etiqueta existente mediante el comando de cancelación de suscripción con la +label opción :

Text
@GitHub Notifications unsubscribe [owner/repo] +label:"new label"

Esto quitará el filtro "nueva etiqueta" y el canal recibirá todas las notificaciones de los eventos suscritos sin ningún filtrado de etiquetas.

Visualización de filtros de etiquetas activas

Para ver los filtros de etiqueta actualmente activos para un canal, use el siguiente comando:

Text
@GitHub Notifications subscribe list features

Filtros válidos

La aplicación GitHub en Teams admite los caracteres especiales más comunes para los filtros de etiqueta, incluidos todos los emojis que Teams y GitHub proporcionan como estándar. Rara vez puede encontrarse una etiqueta que contenga un carácter especial que no esté admitido. Por ejemplo, cualquier carácter multibyte no codificado como :foo:, o las etiquetas que usan el , carácter pueden no funcionar según lo previsto.

Notificaciones de flujo de trabajo de GitHub Actions

Puede suscribirse a GitHub Actions notificaciones de ejecución de flujo de trabajo desde su canal o aplicación personal utilizando la característica "flujos de trabajo", con el formato @GitHub Notifications subscribe owner/repo workflows.

Cuando se suscribe a "flujos de trabajo", está disponible la siguiente funcionalidad:

  • Recibirá una notificación cuando se desencadene una nueva ejecución de flujo de trabajo.
  • Puede rastrear las notificaciones de autorización como respuestas dentro del hilo de discusión y puede aprobar las notificaciones directamente desde el canal o la aplicación personal.
  • Una vez completado el flujo de trabajo, obtendrá una actualización como respuesta en el subproceso para que pueda ver el contexto completo y el historial de la ejecución del flujo de trabajo.
  • Si algo falla, puede optar por volver a ejecutar el flujo de trabajo in situ y también puede habilitar los registros de depuración si es necesario.

Nota:

Después del 10 de marzo de 2025 y para GitHub Enterprise Server versión 3.17 en adelante, ya no se le notificará el progreso de los trabajos de flujo de trabajo individuales. Consulte el registro de cambios GitHub para obtener más detalles.

Filtros de notificación de flujo de trabajo

Puede filtrar las notificaciones de flujo de trabajo mediante las siguientes opciones:

FilterDescripción
nameFiltre por el nombre del flujo de trabajo.
actorFiltre por el usuario que desencadenó el flujo de trabajo.
branchFiltre por la rama en la que se ejecuta el flujo de trabajo. En los casos en los que se incluye el evento pull_request, la rama de destino será aquella para la que se crea la solicitud de extracción.
eventFiltre por el evento que desencadenó el flujo de trabajo (por ejemplo, push, pull_request).

Puede configurar filtros de notificación de flujo de trabajo con el formato siguiente:

Text
@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name" event:"workflow event" branch:"branch name" actor:"username"}

También puede pasar varios valores para cada filtro, separados por comas. Por ejemplo:

Text
@GitHub Notifications subscribe owner/repo workflows:{name:"your workflow name","another workflow name" event:"workflow event","another workflow event" branch:"branch name","another branch name" actor:"username","another-username"}

De forma predeterminada, al configurar notificaciones de flujo de trabajo sin aplicar ningún filtro, se configuran para flujos de trabajo que se desencadenan mediante pull requests dirigidas a tu rama principal predeterminada. Puede pasar una o varias entradas.

Puede cancelar la suscripción a las notificaciones de flujo de trabajo mediante el comando: @GitHub Notifications unsubscribe owner/repo workflows.

Nota:

Para recibir notificaciones de GitHub Actions en Teams, la aplicación de GitHub necesita permisos adicionales. Al intentar suscribirse a flujos de trabajo por primera vez, se le pedirá que conceda estos permisos.

Notificaciones de implementación

También puede configurar notificaciones de implementación independientes. Estas implementaciones pueden ocurrir desde GitHub Actions o desde orígenes externos mediante la API de implementaciones. Consulta Puntos de conexión de la API de REST para implementaciones.

Puede suscribirse o cancelar la suscripción a las notificaciones de implementación mediante los siguientes comandos:

Text
@GitHub Notifications subscribe owner/repo deployments
@GitHub Notifications unsubscribe owner/repo deployments

Nota:

Si usa GitHub Actions y desea realizar un seguimiento de las implementaciones en entornos, se recomienda la funcionalidad workflows, ya que proporciona una visión más completa y la capacidad de aprobar las implementaciones directamente desde Teams.