공백을 메우는 협업의 기술
디스코드에 이어 이번에는 많은 기업과 개발 팀이 주력으로 사용하는 슬랙(Slack)이다.
개발자에게 협업이란 무엇일까.
단순히 코드를 합치는 과정을 넘어, 서로의 작업 상태와 공백을 실시간으로 메워가는 과정이다.
하지만 “PR 올렸습니다”, “이슈 확인해 주세요”라는 말을 매번 직접 전달하는 것은 생각보다 피로한 일이다.
때로는 소통의 타이밍을놓쳐 리뷰가 밀리기도 하고, 반대로 너무 잦은 메시지에 작업의 흐름이 깨지기도 한다.
협업의 온도를 높이는 방법 중 하나가 바로 소통 채널에 알림을 보내주는 것이라고 생각한다.
그리고 팀원들의 시선이 가장 오래 머무는 슬랙에 깃허브(GitHub)의 알림을 심어두는 것은, 이러한 소통의 비용을 제로(Zero)로 만드는 가장 좋은 방법이다.
슬랙 역시 웹훅(Webhook)을 활용하면 별도의 복잡한 개발 없이 깔끔한 실시간 알림 시스템을 구축할 수 있다.
슬랙에서 웹훅(Webhook) URL 준비하기
슬랙은 채널별로 독립적인 수신 웹훅(Incoming Webhook)을 생성하여 외부 서비스의 데이터를 받아올 수 있도록 지원한다.
- 알림을 적용할 슬랙 워크스페이스로 이동한다.
- 알림을 받을 채널의 상단 이름 부분을 클릭하거나, 설정 메뉴에서 ‘앱 추가(Add apps)’를 선택한다.
- ‘Incoming Webhooks’를 검색하여 설치한 후, 알림을 보낼 대상 채널을 지정한다.
- 생성이 완료되면 제공되는 ‘Webhook URL’을 복사하여 메모장에 잠시 보관한다. (이 URL은 외부로 노출되지 않도록 보안에 주의해야 한다.)
깃허브 레포지토리에 슬랙 웹훅 등록하기
이제 복사한 주소를 깃허브에 연결해 줄 차례다. 디스코드와 마찬가지로 슬랙 역시 깃허브의 페이로드를 올바르게 수신하기 위한 작은 설정이 필요하다.
- 연동할 깃허브 레포지토리의 상단 ‘Settings’ 탭으로 이동한다.
- 왼쪽 사이드바에서 ‘Webhooks’를 선택한 후, 우측 상단의 ‘Add webhook’ 버튼을 누른다.
- Payload URL 입력란에 방금 슬랙에서 복사한 Webhook URL을 붙여넣는다.
- Content type을
application/json으로 변경한다.
- 참고: 과거 깃허브 레거시 연동 방식이나 특정 서드파티 앱 환경에 따라 URL 끝에 형식을 맞추는 작업이 필요할 수 있으나, 슬랙의 정식 수신 웹훅 앱을 사용할 때는 복사한 URL 그대로 매핑하면 안정적으로 작동한다.
이벤트 필터링: 신호와 소음의 한 끝 차이
웹훅을 설정할 때 가장 고민해야 하는 지점은 바로 ‘알림의 범위’다.
하단의 이벤트 트리거 옵션에서 “Send me everything”을 선택하는 것은 언뜻 편리해 보이지만, 장기적으로는 팀의 생산성을 해치는 주범이 될 수 있다.
모든 이벤트(Everything)를 구독하면 이슈의 사소한 문구 수정(edited), 댓글 추가, 심지어 레포지토리 포크(Fork)나 스타(Star) 알림까지 슬랙 채널을 뒤덮게 된다.
중요한 알림과 사소한 알림이 섞여 소음(Noise)이 되는 순간, 팀원들은 채널의 알림을 끄기 시작한다. 알림의 가치가 상실되는 것이다.
그렇기 때문에 ‘Let me select individual events’를 선택하여 팀의 워크플로우에 꼭 필요한 신호(Signal)만 골라내는 과정이 반드시 필요하다.
슬랙 채널을 깨끗하게 유지하는 추천 이벤트
- Pull requests: 새로운 제안과 머지(Merge) 상태를 추적하기 위한 핵심 알림.
- Pull request reviews: 코드 리뷰의 승인(Approve) 및 피드백 상태를 실시간으로 확인.
- Issues: 새로운 문제 제기 및 해결 상태 파악.
- Issue comments: 이슈나 PR 내부에서 오가는 팀원들의 토론을 놓치지 않기 위함.
설정을 마치고 맨 아래 ‘Add webhook’을 누르면, 깃허브 리스트에 초록색 체크(✔️)가 뜨며 실시간 연동이 활성화된다.
쌓아 올린 기록은 팀의 문화가 된다
슬랙 채널에 실시간으로 찍히는 깃허브 알림은 단순한 텍스트 가 아니다.
그것은 팀원들이 각자의 자리에서 치열하게 고민하고 기여하고 있다는 ‘살아있는 증거‘다.
코드가 푸시되고, 리뷰가 오가고, 이슈가 해결되는 과정이 투명하게 공유될 때 팀의 신뢰는 자연스럽게 두터워진다. 말로 다 하지 않아도 서로의 속도와 방향을 맞출 수 있게 되기 때문이다.
오늘 구축한 이 작은 자동화가, 우리 팀의 개발 문화를 한층 더 기분 좋고 매끄럽게 연결해 주는 단단한 연결고리가 되기를 기대해 본다.
0 글이 마음에 드시면 하트를 눌러주세요! 행복한 고민이 됩니다!