GitHub para Slack

GitHub es una plataforma donde equipos de programadores de software escriben código y gestionan sus proyectos. Al conectar GitHub con Slack, recibirás notificaciones de toda clase de eventos en el canal (o canales) que elijas. Conecta dos de las herramientas más importantes para tu trabajo y mantente al tanto de todo directamente desde Slack. 🛠


Decide qué aplicación utilizar

  • GitHub para Slack: ¿Estás en un plan Developer, Team o Business de GitHub? ¡Esta aplicación es para ti!
  • Github Notifications (antigua versión): Esta app es compatible con GitHub Enterprise.


Instalar la aplicación

GitHub para Slack 

GitHub Notifications (antigua versión)

Con la aplicación de GitHub, podrás tener una vista previa en Slack de los enlaces de repositorios públicos, configurar notificaciones con comandos de barra diagonal y estar al día de la actividad de tus proyectos.


Instalar la aplicación

  1. Visita slack.github.com y haz clic en Añadir a Slack.
  2. Revisa los permisos a los que tiene que acceder la aplicación y haz clic en Continuar para concedérselos.
  3. Selecciona los canales a los que podrá acceder la aplicación: todos los canales abiertos, canales determinados o ninguno. 

Después de haber instalado la aplicación GitHub, esta te enviará un mensaje directo para ayudarte a completar la configuración y enseñarte todo lo que puedes hacer con el comando de barra diagonal /github.

Consejo: Utiliza el comando /github subscribe owner/repo para suscribirte a tus configuraciones anteriores. 


Personalizar tus notificaciones

Con la aplicación de GitHub te será muy fácil personalizar lo que se publica en Slack. Podrás suscribirte a la actividad que sea importante que conozca todo el canal y cancelar la suscripción a otro tipo de actividades que carezcan de relevancia. De forma predeterminada te llegarán notificaciones en Slack para determinadas actividades, mientras que para otras no:

Funciones activadas de forma predeterminada

  • issues
  • pulls
  • statuses
  • compromisos
  • deployments
  • public

Funciones no activadas de forma predeterminada

  • reviews
  • comments
  • branches
  • commits:all

 

Puedes personalizar tus notificaciones con los siguientes comandos de barra diagonal:

  • /github subscribe owner/repo [feature]
  • /github unsubscribe owner/repo [feature]


Nota sobre la aplicación de GitHub 

Si utilizas otras aplicaciones de Slack, observarás algunos cambios en el modo que se instala GitHub. El ámbito de funcionamiento de esta aplicación en particular es tu espacio de trabajo; su funcionamiento no afecta a los miembros. ¡Algo muy positivo! A continuación te explicamos por qué:

  • La aplicación nunca se desconectará aunque el instalador original abandone tu espacio de trabajo. 
  • Podrás añadir la aplicación de GitHub a canales específicos. Elige cuáles durante la instalación o utiliza /invite @github para añadir la aplicación a cualquier canal más adelante.

💡Lee más sobre el futuro de las aplicaciones de Slack en el blog de la plataforma de Slack. Si eres desarrollador, descubre cómo puedes formar parte de la próxima generación de aplicaciones de Slack y únete a nuestra versión de desarrollo preliminar.

 

Si utilizas GitHub Enterprise, la opción in situ de GitHub, tendrás que instalar la aplicación GitHub Notifications (antigua versión). 


Instalar la aplicación

  1. Visita GitHub en el Directorio de Aplicaciones de Slack. 
  2. Haz clic en Instalar.
  3. Selecciona el canal donde quieres que se publiquen los eventos de GitHub o haz clic en Crear un nuevo canal si deseas crear uno nuevo.
  4. Haz clic en Añadir integración con GitHub
  5. Haz clic en Autenticar tu cuenta de GitHub.
  6. Selecciona los repositorios para los que deseas recibir notificaciones en Slack. 
  7. Elige los eventos de GitHub que deseas publicar en Slack.
  8. Si lo prefieres, puedes personalizar el diseño de las notas de GitHub en Slack eligiendo un nombre e icono personalizados.
  9. Cuando hayas terminado, haz clic en Guardar integración para guardar los cambios.


Entender los permisos 

La primera vez que conectes la aplicación, Slack te pedirá permiso para acceder a los repositorios de GitHub. Necesitaremos acceso de lectura y escritura a los datos de todos los repositorios, tanto los públicos como los privados: código, issues, pull requests, wikis, ajustes, deploy keys, además de webhooks y servicios.

Sabemos que es mucho pedir. La única manera en que Slack puede acceder a la lista completa de tus repositorios públicos y privados es concediéndole el scope "repo", que proporciona todos los permisos que enumeramos más arriba.

Nota: Slack solo utilizará estos permisos para leer datos de los repositorios (para acceder a una lista de tus repositorios públicos y privados) y para poder configurar tus webhooks en GitHub.


Cambiar al modo sin autenticación

Puedes optar también por configurar la aplicación en modo sin autenticación. Para ello, sigue los pasos del 1 al 4 descritos más arriba y, a continuación, haz lo siguiente:

  1. Desde la página de ajustes de Slack, cambia a modo sin autenticación.
  2. En tu cuenta de GitHub, busca el repositorio que deseas monitorizar. Haz clic en Ajustes a la derecha del menú de navegación.
  3. Haz clic en Webhooks y servicios en el menú de navegación de la parte izquierda. A continuación, pulsa Añadir webhook.
  4. En la ventana del Directorio de Aplicaciones de Slack, haz clic en Copiar URL
  5. En tu cuenta de GitHub, pega la URL en URL de Payload.
  6. En la opción Tipo de contenido, asegúrate de seleccionar aplicación/json.
  7. Asegúrate de haber activado Verificación SSL.
  8. Haz clic en Añadir webhook.
  9. Regresa a tu página de configuración de Slack y haz clic en Guardar integración.


Añadir una nueva organización de GitHub

Cuando te incorpores a una nueva organización en GitHub, deberás darle acceso a Slack. Cuando lo hayas hecho, la nueva organización se mostrará en tu aplicación actual. A continuación te explicamos cómo configurarla:

  1. Visita tus ajustes de GitHub en la dirección: github.com/settings.
  2. En Authorized OAuth Apps (Aplicaciones OAuth autorizadas), haz clic en Slack.
  3. En Acceso a la organización, haz clic en Dar acceso junto a tu nueva organización.

La nueva organización y sus repositorios aparecerán en la página de la aplicación de GitHub en Slack: my.slack.com/apps/manage.

¿Preguntas? Ponte en contacto en cualquier momento. ¡Estamos a tu disposición!

Artículos relacionados

Artículos vistos recientemente