Skip to main content

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

Uso de GitHub en Slack

Aprenda a usar GitHub en Slack para mejorar la colaboración y simplificar el flujo de trabajo.

La integración de GitHub para Slack le permite conectar la cuenta GitHub a la aplicación GitHub en Slack. Una vez conectado, puede usar comandos de barra diagonal para interactuar con GitHub, recibir notificaciones sobre la actividad del repositorio y colaborar con el equipo directamente en Slack.

Conexión de la cuenta GitHub a la aplicación GitHub en Slack

Nota:

Para poder conectar las cuentas, un administrador del área de trabajo de Slack debe haber instalado la aplicación GitHub . Consulta Integración de GitHub con Slack.

  1. En Slack, inicie un mensaje directo con la aplicación GitHub .
  2. El mensaje directo se rellenará previamente con un mensaje de bienvenida y un vínculo para conectar la cuenta GitHub . Siga las indicaciones en pantalla en Slack y, en GitHub en el explorador, para autenticar y autorizar la conexión.

Una vez que la cuenta GitHub está conectada, Slack le mostrará una lista de los comandos y características disponibles que puede usar.

Uso de slash commands para interactuar con GitHub en Slack

Para usar un comando de barra diagonal, escriba /github seguido del comando que desea ejecutar en el campo de entrada del mensaje de cualquier canal de Slack o mensaje directo donde la aplicación GitHub está presente. Para invitar la aplicación a un canal, escriba /invite @github en el canal.

CommandDescription
/github helpMuestra una lista de comandos esenciales y sus descripciones.
/github subscribe owner/repoSuscribe el canal a las notificaciones del repositorio especificado.
/github unsubscribe owner/repoCancela la suscripción a las notificaciones del canal para el repositorio especificado.
/github subscribe listEnumera todos los repositorios a los que está suscrito el canal.
/github open owner/repoAbre un problema en el repositorio especificado. Se le pedirá que proporcione un título y una descripción para el problema.
/github close [issue link]Cierra el problema especificado como completado.
/github close [issue link] reason:"not planned"Cierra el problema especificado con un motivo. Reemplace "not planned" con su motivo.
/github reopen [issue link]Vuelve a abrir el problema especificado.
/github signinReinicia el flujo de trabajo "Conectar la cuenta de GitHub".

Nota:

Al suscribir un canal a un repositorio, el canal recibirá notificaciones para todos los eventos en las solicitudes de incorporación de cambios y problemas de ese repositorio. El canal también recibirá notificaciones de cualquier push evento directamente en la rama predeterminada del repositorio.

Menciones en Slack

Cuando se suscribe a un repositorio en Slack, verá que se le menciona en las notificaciones de eventos de repositorio donde ha sido mencionado. Por ejemplo, si se le asigna una tarea o se le menciona en un comentario, verá su mención en la notificación en Slack.

Las menciones requieren que inicie sesión en la cuenta GitHub a través de la aplicación GitHub en Slack. Esto permite que GitHub asocie tu identidad de Slack con tu identidad de GitHub. Consulte Conexión de la cuenta GitHub a la aplicación GitHub en Slack.

Nota:

Si tiene varias áreas de trabajo de Slack en las que usa la aplicación GitHub , las menciones solo funcionarán en el área de trabajo donde inició sesión en la aplicación GitHub más recientemente. Si inicia sesión en la aplicación GitHub en otra área de trabajo, las menciones dejarán de funcionar en el área de trabajo anterior.

A continuación se muestran escenarios en los que se mencionará:

  • Se le asigna un problema.
  • Se solicita su revisión en una solicitud de extracción.
  • Se le menciona en una solicitud de incorporación de cambios, una descripción del problema, un comentario o una discusión.
  • Se solicita tu revisión en un despliegue.
  • Recibe un aviso programado para una solicitud de revisión de incorporación de cambios.

Puede ver un resumen de las menciones de GitHub en la vista de "Menciones" de Slack. Para obtener más información, consulte Notificaciones de evaluación de prioridades en la pestaña Actividad de la documentación de Slack.

Subprocesamiento de conversaciones

Las notificaciones de cada problema o pull request se agrupan en un hilo de Slack. El mensaje principal siempre muestra el estado más reciente del problema o la solicitud de extracción, junto con otros metadatos como título, descripción, asignados, revisores, etiquetas y comprobaciones. El hilo ayuda a mantener las conversaciones organizadas, lo que facilita el seguimiento de las actualizaciones y discusiones relacionadas con un problema específico o una solicitud de incorporación de cambios. Cuando cambia el estado de un problema o solicitud de incorporación de cambios, la respuesta asociada se publica tanto en el subproceso como en el canal, de modo que todos los usuarios del canal conozcan la actualización.

Puede desactivar el subprocesamiento para las notificaciones de incidencias y solicitudes de incorporación de cambios en canales individuales.

  1. En el canal de Slack donde desea deshabilitar los hilos, escriba /github settings.
  2. En el menú de configuración, junto a "Deshabilitar subprocesos para notificaciones de solicitud de extracción e incidencias", haga clic en Deshabilitar.

Usted, o cualquier otro miembro del canal, puede volver a habilitar subprocesos en cualquier momento siguiendo los mismos pasos y haciendo clic en Habilitar en el menú de configuración.

Difusión de comentarios y revisiones al canal de Slack

De forma predeterminada, los comentarios y las revisiones solo se mostrarán en su hilo relacionado. Si desea que los miembros del canal vean los mensajes en lugar de solo aquellos que son participantes del tema, puede optar por la difusión con los siguientes comandos:

  • Para la difusión de comentarios, use /github subscribe owner/repo comments:"channel"

  • Para revisar la transmisión, use /github subscribe owner/repo reviews:"channel"

Apertura de vínculos en actividades de GitHub en Slack

Las vistas previas de vínculos proporcionan contexto adicional al compartir vínculos a actividades de GitHub en Slack. Las vistas previas de vínculos se muestran en Slack para las siguientes actividades GitHub :

  • Solicitudes de incorporación de cambios
  • Problemas
  • Comentarios vinculados directamente
  • Blobs de código con números de línea
  • Organizaciones, repositorios y usuarios

Las vistas previas de los vínculos no se mostrarán si se aplica alguna de las siguientes opciones:

  • Las vistas previas de vínculo están deshabilitadas en el área de trabajo de Slack. Consulte Compartir vínculos y establecer preferencias de vista previa en la documentación de Slack.
  • El mismo vínculo ya se ha compartido en el canal en los últimos 30 minutos.
  • 3 o más vínculos se comparten en el mismo mensaje.
  • El repositorio es privado y el usuario que ha compartido el vínculo:

Lectura adicional

  •         [AUTOTITLE](/integrations/how-tos/slack/customize-notifications) : aprenda a personalizar las notificaciones GitHub en Slack para satisfacer sus necesidades.
    
  •         [AUTOTITLE](/integrations/tutorials/slack) - crea aptitudes y conocimientos sobre la integración de Slack de GitHub a través de ejemplos y actividades prácticas.