Configuración de notificaciones

Opciones de entrega de notificaciones

Puedes recibir notificaciones de actividad en your enterprise en las ubicaciones siguientes.

• La bandeja de entrada de notificaciones de la interfaz web de your enterprise
• Un cliente de correo electrónico que usa una dirección de correo electrónico verificada, que también se puede sincronizar con la bandeja de entrada de notificaciones de your enterprise

Beneficios de la bandeja de entrada de notificaciones

La bandeja de entrada de notificaciones de your enterprise incluye opciones de evaluación de prioridades diseñadas específicamente para su flujo de notificaciones de GitHub, con opciones como:

• Evaluación de prioridades de varias notificaciones a la vez.
• Marque las notificaciones completadas como Done y quítelas de la bandeja de entrada. Para ver todas las notificaciones marcadas como Done, use la consulta is:done.
• Guarde una notificación para revisarla más adelante. Las notificaciones guardadas se marcan en la bandeja de entrada y se conservan indefinidamente. Para ver todas las notificaciones guardadas, use la consulta is:saved.
• Cancele la suscripción y quite una notificación de la bandeja de entrada.
• Obtener una vista previa de la incidencia, la solicitud de incorporación de cambios o el debate de equipo donde se origina la notificación en your enterprise desde la bandeja de entrada de notificaciones.
• Vea una de las razones más recientes por las que recibe una notificación de la bandeja de entrada con una etiqueta reasons.
• Cree filtros personalizados para centrarse en diferentes notificaciones cuando quiera.
• Agrupar notificaciones por repositorio o fecha en tu bandeja de entrada para obtener un resumen rápido con menos cambios de contexto

Beneficios de utilizar un cliente de correo electrónico para las notificaciones

Un beneficio de utilizar un cliente de correo electrónico es que todas tus notificaciones se pueden mantener por tiempo indefinido dependiendo de la capacidad de almacenamiento de éste. Las notificaciones de la bandeja de entrada solo se conservan durante 5 meses en GitHub a menos que las haya marcado como Saved. Las notificaciones marcadas como Saved se conservan indefinidamente. Para obtener más información sobre la directiva de retención de la bandeja de entrada, consulte "Acerca de las notificaciones".

Enviar notificaciones a tu cliente de correo electrónico también te permite personalizar tu bandeja de entrada de acuerdo con la configuración del mismo, lo cual puede incluir etiquetas personalizadas o con códigos de color.

Las notificaciones por correo electrónico también permiten la flexibilidad con los tipos de notificaciones que recibes y te permiten escoger diferentes direcciones para las actualizaciones. Por ejemplo, puedes enviar ciertas notificaciones para un repositorio a una dirección de correo electrónico personal verificada. Para obtener más información sobre las opciones de personalización de correo electrónico, consulte "Personalización de las notificaciones por correo electrónico".

Acerca de participar y seguir de cerca las notificaciones

Cuando observas un repositorio, te suscribes a las actualizaciones de la actividad en el mismo. De forma similar, cuando observas las discusiones específicas de un equipo, te suscribes a todas las actualizaciones de la conversación en la página de ese equipo. Para obtener más información, consulte "Acerca de los debates de equipo".

Para ver los repositorios que está inspeccionando, vaya a la página de inspección. Para obtener más información, consulte "Administración de suscripciones y notificaciones en GitHub".

Configuración de notificaciones

Puede configurar las notificaciones de un repositorio en su página o en la página de inspección.

Acerca de las notificaciones personalizadas

Puedes personalizar las notificaciones de un repositorio. Por ejemplo, puedes elegir que solo se te notifique cuando suceden las actualizaciones a uno o más eventos (incidencias, solicitudes de incorporación cambios, lanzamientos, alertas de seguridad o debates) dentro de un repositorio o ignorar todas las notificaciones de este. Para obtener más información, consulte "Configuración de los valores de inspección para un repositorio individual".

Participar en conversaciones

Cada vez que comenta en una conversación o cuando alguien @mentions su nombre de usuario, participa en una conversación. Predeterminadamente, estás suscrito automáticamente a una conversación cuando participas en ella. Puede cancelar la suscripción de una conversación en la que ha participado manualmente haciendo clic en Unsubscribe en la incidencia o la solicitud de incorporación de cambios o mediante la opción Unsubscribe en la bandeja de entrada de notificaciones.

Para las conversaciones que observas o en las que participas, puedes elegir si quieres recibir notificaciones por correo electrónico o en la bandeja de entrada de notificaciones en your enterprise. Para obtener más información, consulta "Configuración de las opciones de notificación".

Por ejemplo:

• Si no desea que las notificaciones se envíen a su correo electrónico, anule la selección del correo electrónico para participar e inspeccionar las notificaciones.
• Si desea recibir notificaciones por correo electrónico cuando haya participado en una conversación, puede seleccionar email en "Participating".

Si no habilitas las notificaciones para las suscripciones que observas o en las que participas para la versión web, no se mostrarán actualizaciones en tu bandeja de entrada de notificaciones.

Personalizar tus notificaciones de correo electrónico

Después de activar las notificaciones por correo electrónico, your enterprise te enviará notificaciones en forma de correos electrónicos con varias partes que contienen copias del contenido tanto en HTML como en texto simple. El contenido de las notificaciones por correo electrónico incluye cualquier Markdown, @mentions, emojis, vínculos hash, etc., que aparecen en el contenido original de your enterprise. Si solo quieres ver el texto en el correo electrónico, puedes configurar tu cliente de correo electrónico para que muestre solo la copia de texto simple.

Escoge una dirección de correo electrónico predeterminada en donde quieras enviar actualizaciones para las conversaciones que observes o en las cuales participes. También puedes especificar la actividad de your enterprise sobre la cual quieres recibir actualizaciones para usar tu dirección de correo electrónico predeterminada. Por ejemplo, escoge si quieres recibir actualizaciones en tu correo electrónico predeterminado sobre:

• Comentarios sobre informes de problemas y solicitudes de extracción.
• Revisiones de solicitudes de incorporación de cambios.
• Subidas de solicitudes de extracción.
• Tus propias actualizaciones, tales como cuando abres, comentas o cierras un informe de problemas o solicitud de extracción.

Dependiendo de la organización a la que pertenezca el repositorio, también puedes enviar notificaciones a direcciones de correo electrónico distintas. Tu organización podría requerir que dicha dirección se verifique en un dominio específico. Para obtener más información, consulte "Elegir adónde se envían las notificaciones por correo electrónico de su organización".

También puedes enviar las notificaciones para un repositorio específico a una dirección decorreo electrónico. Para obtener más información, consulte "Acerca de las notificaciones por correo electrónico para las inserciones en el repositorio".

Solo recibirás correo electrónicos de notificación si optaste por recibir notificaciones por correo electrónico en los ajustes de las notificaciones.

Filtrar las notificaciones por correo electrónico

Cada notificación por correo electrónico que envía your enterprise contiene información de encabezado. La información del encabezado en cada correo electrónico es consistente, para que pueda usarla en su cliente de correo electrónico para filtrar o reenviar todas las notificaciones de GitHub o ciertos tipos de notificaciones de GitHub.

Si cree que recibe notificaciones que no le corresponden, examine los encabezados X-GitHub-Recipient y X-GitHub-Recipient-Address. Estos encabezados te muestran quién es el destinatario previsto. Dependiendo de tu configuración de correo electrónico, podrías recibir notificaciones destinadas para otro usuario.

Las notificaciones por correo electrónico de your enterprise contienen la siguiente información de encabezado:

Encabezado	Información
Dirección From	Esta dirección siempre será 'la dirección de correo electrónico sin respuesta configurada por el administrador del sitio'.
Campo deTo	Este campo se conecta directamente al subproceso.
Dirección Cc	GitHub AE le enviará Cc si está suscripto a una conversación. La segunda dirección de correo electrónico de Cc coincide con el motivo de la notificación. El sufijo para estos motivos de notificación es based on the no-reply email address configured by your site administrator. Los posibles motivos de notificación son: assign: se le asignó a una incidencia o solicitud de incorporación de cambios. author: creó una incidencia o solicitud de incorporación de cambios. ci_activity: se completó una ejecución de flujo de trabajo de GitHub Actions. comment: hizo un comentario sobre una incidencia o solicitud de incorporación de cambios. manual: hubo una actualización de una incidencia o solicitud de incorporación de cambios a la que se suscribió de forma manual. mention: lo mencionaron en una incidencia o solicitud de incorporación de cambios. push: alguien confirmó una solicitud de incorporación de cambios a la que está suscrito. review_requested: se le solicita a usted o a un equipo del que es miembro revisar una solicitud de incorporación de cambios. security_alert: GitHub detectó una vulnerabilidad en un repositorio para el que recibe alertas. state_change: se cerró o se abrió una incidencia o solicitud de incorporación de cambios a la que está suscrito. subscribed: hubo una actualización en un repositorio que inspecciona. team_mention: un equipo al que pertenece fue mencionado en una incidencia o solicitud de incorporación de cambios. your_activity: abrió, comentó o cerró una incidencia o solicitud de incorporación de cambios.
Campo demailing list	Este campo identifica el nombre del repositorio y su propietario. El formato de esta dirección siempre es <repository name>.<repository owner>.[hostname].
Campo deX-GitHub-Severity	Las notificaciones por correo electrónico para Dependabot alerts que afectan a uno o más repositorios incluyen el campo de encabezado X-GitHub-Severity. Puede usar el valor del campo de encabezado X-GitHub-Severity para filtrar las notificaciones por correo electrónico de Dependabot alerts. Los posibles niveles de gravedad son: low moderate high critical Para más información, vea "Acerca de Dependabot alerts".

Escoger tu configuración de notificaciones

1. En la esquina superior derecha de cualquier página, haga clic en . 1. En la barra lateral izquierda, debajo de la lista de repositorios, utiliza el menú desplegable "Administrar notificaciones" para hacer clic en Configuración de notificaciones.
2. En la página de configuración de notificaciones, elige cómo deseas recibir las notificaciones cuando:
   • Existen actualizaciones en repositorios o debates de equipo que estás siguiendo de cerca, o en una conversación en la que estás participando. Para obtener más información, consulte "Acerca de las notificaciones de participación e inspección".
   • Obtienes acceso a un repositorio nuevo o te has unido a un equipo nuevo. Para más información, consulta Seguimiento automático.
   • Hay nuevas Dependabot alerts en tu repositorio. Para obtener más información, consulte "Opciones de notificación de Dependabot alerts".
   • Hay llaves de lanzamiento nuevas que se agregan a los repositorios y que pertenece a las organizaciones de las cuales eres propietario. Para obtener más información, consulte "Opciones de notificación de alertas de la organización".

Seguimiento automático

Predeterminadamente, cada que obtienes acceso a un repositorio nuevo, comenzarás automáticamente a observarlo. Cada vez que se una a un equipo, se suscribirá automáticamente a las actualizaciones y recibirá notificaciones cuando se @mentioned al equipo. Si no te quieres suscribir automáticamente, puedes anular la selección de las opciones de observar automáticamente en la configuración de notificaciones.

Si inhabilitas la opción de "Observar los repositorios automáticamente", no podrás observar automáticamente tus propios repositorios. Debes navegar hasta tu página de repositorio y escoger la opción de observar.

Para obtener más información, consulta "Configuración de las opciones de notificación".

Configurar los ajustes de observación para un repositorio individual

Puedes elegir si quieres observar o dejar de observar un repositorio individual. También puedes elegir que solo se te notifique sobre tipos de eventos específicos, tales como los incidencias, solicitudes de incorporación cambios, lanzamientos, alertas de seguridad o debates (si es que se habilitaron para el repositorio) o ignorar un repositorio individual por completo.

1. En your enterprise, navega a la página principal del repositorio.

2. En la esquina superior derecha, selecciona en el menú desplegable "Observar" para hacer clic en una opción de observación.

   La opción Custom le permite personalizar aún más las notificaciones para que solo se le notifique cuando sucedan eventos específicos en el repositorio, además de la participación y las @mentions. Si seleccionas "Incidencias", se te notificará sobre las actualizaciones de cada incidencia del repositorio (incluidas las que existían antes de que seleccionaras esta opción) y se te suscribirá a ellas. Si se le @mentioned en una solicitud de incorporación de cambios en este repositorio, también recibirá notificaciones por este evento y se le suscribirá a las actualizaciones de esa solicitud de cambios específica, además de a las notificaciones sobre las incidencias.

Elegir a dónde se envían las notificaciones por correo electrónico de tu organización

Si perteneces a una organización, puedes escoger la cuenta de correo electrónico a la que desees que se envíen las notificaciones de la actividad de la empresa. Por ejemplo, si perteneces a una organización de trabajo, es posible que desees que tus notificaciones se envíen a tu dirección de correo electrónico laboral, en lugar de tu dirección personal.

Solo recibirás correo electrónicos de notificación si optaste por recibir notificaciones por correo electrónico en los ajustes de las notificaciones.

1. En la esquina superior derecha de cualquier página, haga clic en . 1. En la barra lateral izquierda, debajo de la lista de repositorios, utiliza el menú desplegable "Administrar notificaciones" para hacer clic en Configuración de notificaciones.

2. En "Default notification email" (Correo electrónico de notificación predeterminado), selecciona la dirección de correo electrónico a la que deseas que se envíen las notificaciones.

   

3. Haz clic en Guardar.

Personalizar rutas de correo electrónico por organización

Si eres miembro de más de una organización, puedes configurar cada una para enviar notificaciones a cualquiera de las direcciones de correo electrónico de tu cuenta.

1. En la esquina superior derecha de cualquier página, haga clic en . 1. En la barra lateral izquierda, debajo de la lista de repositorios, utiliza el menú desplegable "Administrar notificaciones" para hacer clic en Configuración de notificaciones.

2. En "Custom routing" (Enrutamiento personalizado) busca el nombre de tu organización en la lista.

   

3. Haga clic en Edit junto a la dirección de correo electrónico que desea cambiar.

   

4. Seleccione una de las direcciones de correo electrónico verificadas y haga clic en Save.

   

Opciones de notificación de Dependabot alerts

Puedes elegir el método de entrega de las notificaciones, así como la frecuencia en las que se te envían. De manera predeterminada, si el propietario de tu empresa ha configurado las notificaciones por correo electrónico en tu instancia, recibirás Dependabot alerts:

• en la bandeja de entrada, como notificaciones web. Se enviará una notificación web cuando se habilite Dependabot en un repositorio, cuando se confirme un archivo de manifiesto nuevo en el repositorio y cuando se encuentre una vulnerabilidad nueva con gravedad crítica o alta (en la opción GitHub ).
• por correo electrónico, se enviará un mensaje de correo electrónico cuando se habilite Dependabot para un repositorio, cuando se confirme un archivo de manifiesto nuevo en el repositorio y cuando se encuentre una vulnerabilidad nueva de gravedad crítica o alta (la opción Email).
• en la interfaz de usuario, se muestra una advertencia en las vistas de archivos y código del repositorio si hay dependencias no seguras (opción Alertas de la interfaz de usuario).
• en la línea de comandos, las advertencias se muestran como devoluciones de llamada al insertar en repositorios con dependencias no seguras (opción CLI).

Puedes personalizar la forma en que recibes notificaciones sobre Dependabot alerts. Por ejemplo, puedes recibir un correo electrónico semanal con el resumen de las alertas de hasta 10 de los repositorios mediante las opciones Email a digest summary of vulnerabilities y Weekly security email digest.

Para obtener más información sobre los métodos de entrega de notificaciones disponibles y consejos sobre cómo optimizar las notificaciones en Dependabot alerts, consulte "Configuración de las notificaciones de Dependabot alerts".

Opciones de alertas de notificación de las organizaciones

Si eres un propietario de una organización, recibirás notificaciones de correo electrónico predeterminadamente cuando los miembros de esta agreguen llaves de despliegue a los repositorios dentro de la organización. Puedes dejar de suscribirte a estas notificaciones. En la página de configuración de notificaciones, en "Organization alerts", anule la selección de Email.