Github와 Discord 채널 연동하기

Youngshin Park·2025년 3월 12일

잡담

목록 보기

3/4

팀플을 하다 보면 서로의 진행 상황을 공유하는 것이 필수이다.
그동안 대부분 나는 카톡에서 물어보거나 Github에 들어가 직접 확인하곤 했다.

BUT...
자동으로 한번에 확인할 순 없을ㄲㅏ?
있다 ㅎㅁㅎ

전제조건은 !!

프로젝트에서 Discord와 Github를 모두 사용하고 있어야 한다는 것이다.

Github의 레포지토리에 어떠한 변경사항이 생겼을 때 자동으로 Discord에 알림이 오도록 설정을 해보자 ! 이는 Discord의 Webhook 을 사용해서 해결할 수 있다.

주의사항

Discord: 웹후크를 설정하려면, 내가 서버 생성자여야 한다. 혹은, 서버 생성자에게 '웹후크 관리하기' 권한을 달라고 말해야 한다 !

Github: 레포지토리의 Owner로 설정되어 있어야 한다. 즉, 레포지토리 안에 Settings 카테고리가 떠야 한다.

Discord 설정하기

'서버 접속 > 서버 설정 > 연동'에 들어가서'웹후크'를 클릭한다.

그 다음 '새 웹후크'를 클릭한다.

그러면 새로 뜬 웹후크를 눌러, '이름'을 원하는 대로 변경하고 어떤 채널에 연결할 것인지 선택한다.
⭐️ 그리고 웹후크 URL 복사를 클릭하여 복사한다 !!!
이는 깃허브에서 사용되기 때문에 꼭 복사해야 한다.

설정 후, 하단의 '변경사항 저장하기'를 해야 저장이 된다 !

이제 깃허브에서 설정을 마저 해보자 !

Github 설정하기

레포지토리 내의 'Settings'에 접속한다.

왼쪽 카테고리들 중 'Webhooks'를 선택한다.

오른쪽 상단의 'Add webhook'를 클릭한다.

⭐️ Discord에서 복사한 웹후크 URL을 Payload URL에 붙여넣는다.
이때, URL을 붙여넣고 끝이 아니다 !
URL 뒤에 /github를 붙여줘야 한다.

그리고 Content type은 뭐.. 나는 json으로 했다.
Secret이랑 SSL verification은 건들지 않았다.

마지막 항목이다. 언제 웹후크를 사용할 것이냐 묻는다. 세 가지 선택지가 있다.
1️⃣ push 했을 때만
2️⃣ 전부 다
3️⃣ 커스터마이징
원하는 걸 선택하면 된다. 나는 보통 2 아니면 3을 하는 것 같다.
3을 할 때는 Issue, PR, Commit + Comment 등이 있을 때 알림이 오도록 했다.