소통의 비용을 줄이는 방법
팀 프로젝트를 진행하다 보면 필연적으로 ‘소통의 비용’이 발생한다.
“이번에 브랜치 푸시했습니다.”
“코드 리뷰 부탁드립니다.”
“이슈 새로 생성했어요.”
…
매번 카톡이나 디스코드로 링크를 복사해서 공유하는 일은 생각보다 번거롭다.
지나치면 팀원의 작업 상태를 모르는 공백이 생기고, 너무 잦으면 작업 흐름이 끊긴다.
이러한 소통의 공백과 피로를 줄이기 위한 가장 확실한 방법은 ‘자동화‘다.
팀원들이 가장 많이 상주하는 디스코드(Discord)에 깃허브(GitHub)의 실시간 알림을 심어두는 것.
방법은 의외로 간단하다. 코드 한 줄 짜지 않고 클릭 몇 번으로 3분 만에 끝낼 수 있다.
디스코드 웹훅(Webhook) URL 발급받기
가장 먼저 알림을 받아볼 디스코드 채널에서 웹훅을 생성해야 한다. (채널 편집 권한이 필요하다.)
- 알림을 연동할 디스코드 채널 이름 옆의 톱니바퀴 아이콘(채널 편집)을 클릭한다.
- 왼쪽 메뉴에서 ‘연동(Integrations)’ 탭을 선택한다.
- ‘웹훅 만들기(Create Webhook)’ 버튼을 누른다.
- 생성된 웹훅의 이름(예:
GitHub Bot)을 지정하고, 알림을 받을 채널이 올바른지 확인한다. - 아래의 ‘웹훅 URL 복사(Copy Webhook URL)’를 클릭하여 주소를 메모장에 잠시 저장해 둔다.
깃허브 레포지토리에 웹훅 등록하기
이제 복사한 주소를 깃허브 레포지토리에 연결할 차례다. 여기서 절대 놓쳐서는 안 될 중요한 팁이 하나 있다.
- 알림을 연결할 깃허브 레포지토리의 상단 ‘Settings’ 탭으로 이동한다.
- 왼쪽 사이드바에서 ‘Webhooks’를 선택한 후, 우측 상단의 ‘Add webhook’ 버튼을 누른다.
- Payload URL 입력란에 방금 디스코드에서 복사한 URL을 붙여넣는다.
- 붙여넣은 URL 맨 끝에
/github를 반드시 수동으로 추가해야 한다.- 예시:
https://discord.com/api/webhooks/...–>https://discord.com/api/webhooks/.../github - 이 접미사를 붙이지 않으면 디스코드 서버가 깃허브가 보낸 데이터를 인식하지 못해 알림이 오지 않는다.
- 예시:
- Content type은
application/json으로 변경한다.
알림의 범위 설정하기: Send me everything?
웹훅 등록 화면 하단에는 어떤 이벤트가 발생했을 때 알림을 보낼지 선택하는 옵션이 있다.
- Just the push event: 단순 커밋 푸시 알림만 받는다.
- Send me everything: 레포지토리에서 일어나는 모든 변경 사항을 받는다.
- Let me select individual events: 원하는 이벤트만 골라서 받는다.
여기서 “Send me everything”을 선택하면 어떻게 될까?
결론부터 말하면, 이슈(Issue)나 PR(Pull Request)이 생성되는 것뿐만 아니라, 내용이 수정(edited)되거나 닫히는(closed) 모든 자잘한 변경 사항까지 전부 알림이 날아온다. 심지어 누군가 댓글을 달거나 레포지토리에 스타를 누르는 것까지 디스코드를 울리게 된다.
이 방식은 채널을 순식간에 알림의 홍수로 만들어 정작 중요한 PR 승인이나 머지(Merge) 알림을 놓치게 만든다. 알림의 피로도가 쌓이면 팀원들은 결국 알림 채널을 뮤트(Mute)하게 된다.
따라서 팀 프로젝트의 최적의 세팅을 원한다면 ‘Let me select individual events’를 선택하고 딱 필요한 알림만 켜두는 것을 추천한다.
추천하는 핵심 이벤트 체크리스트
- Pull requests: PR 생성, 수정, 머지 알림
- Pull request reviews: PR 리뷰 작성 및 승인(Approve) 알림
- Issues: 이슈 오픈, 수정, 닫기 알림
- Issue comments: 이슈 및 PR에 달리는 소통용 댓글 알림
설정을 마친 후 맨 아래 ‘Add webhook’을 누르면 끝난다. 성공적으로 연결되면 깃허브 웹훅 리스트에 초록색 체크 표시(✔️)가 활성화된다.
묵묵히 쌓아 올린 커밋은 배신하지 않는다
자동화 시스템을 구축하는 것은 단순히 편리함을 넘어, 팀원 간의 신뢰를 시각화하는 과정이다.
디스코드 채널에 실시간으로 쌓이는 PR과 리뷰 알림을 보며, 우리는 서로가 각자의 자리에서 치열하게 달리고 있음을 확인한다.
내가 수정한 이슈가 팀원에게 실시간으로 공유되고, 팀원이 보낸 PR이 내 화면에 즉시 도달할 때 협업의 속도는 자연스럽게 빨라진다.
오늘 세팅한 이 작은 웹훅 하나가, 우리 팀의 프로젝트를 더 매끄럽고 단단하게 연결해 주는 좋은 윤활유가 되기를 바란다.
0 글이 마음에 드시면 하트를 눌러주세요! 행복한 고민이 됩니다!