GitHub para Slack

GitHub es una plataforma donde equipos de programadores de software escriben código y administran 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 aplicación 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 vínculos 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 Agregar 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 públicos, 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 agregar la aplicación de GitHub a canales específicos. Elige cuáles durante la instalación o utiliza /invite @github para agregar 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.
  4. Haz clic en Agregar integración de 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 de Slack y un ícono 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, problemas, solicitudes pull, wikis, ajustes, claves de implementación, 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 ámbito "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.


Cambia 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 Settings (Ajustes) a la derecha del menú de navegación.
  3. Haz clic en Webhooks & Services (Webhooks y servicios) en el menú de navegación de la parte izquierda. A continuación, presiona Add webhook (Agregar 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 Payload URL (URL de Payload).
  6. En la opción Content type (Tipo de contenido), asegúrate de seleccionar aplicación/json.
  7. Asegúrate de haber activado SSL verification (Verificación de SSL).
  8. Haz clic en Add webhook (Agregar webhook).
  9. Regresa a la página de configuración de Slack y haz clic en Guardar integración.


Agregar 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