soom

Posted on Aug 19, 2022 • Edited on Feb 23, 2023

GMAIL to Discord Channel Webhook Tutorial

#discord #gmail #slack #teams

Abstract

프로젝트를 진행하면서 Slack, Microsoft Teams, Discord 등 커뮤니케이션 툴은 원활한 프로젝트 진행을 위해 필수적인 요소 중에 하나다.

특히, 게임 보조 도구로 알려진 Discord의 경우 퍼포먼스에 민감한 게이머들을 만족시키는 강력한 커뮤니케이션 기능을 가지고 있다보니 이를 프로젝트 메인 커뮤니케이션 툴로 사용하는 경우도 점점 증가하고 있다.

이번 포스팅에서는 팀 메일이나 공식 메일이 올때마다 메일을 확인하는 것이 아닌 Discord의 하나의 채널에서 알림이 올수 있도록 웹훅 설정을 하는 과정을 소개하고자 한다.

Discord DOCs 링크: https://discord.com/developers/applications

Getting Started

Prerequisite

여기서는 Discord 계정이 있고 서버를 생성한 상태를 가정한다
서버에 해당하는 웹훅 권한이 필요하다

웹훅 권한 설정

Setting Discord Webhook

Integrations 메뉴에서 Webhooks 생성을 클릭

Integrations 메뉴

New Webhook을 선택해서 새로운 Webhook을 생성한 뒤 필요한 정보(Bot Name, Channel)를 입력해서 Noti-Bot을 생성

Discord 세팅은 여기까지 완료

Webhook 생성

Setting up Google App Script

구글 앱 스크립트 페이지 접속:
https://www.google.com/script/start/

새 프로젝트 생성

구글 앱 스크립트 메인 화면

메인 대쉬보드

새로운 프로젝트에 다음과 같이 코드를 작성

Note

webhooks 변수에는 Discord의 Webhook URL을 입력

Webhook 생성 화면

channel 변수에는 채널 이름을 등록

Discord 채널명

searchQuery 에는 구글 메일에서 쓰는 검색 쿼리를 사용한다. (하기 이미지 참조)

Gmail 쿼리 검색

Gmail에서는 Discord에 2000 자 이상되는 내용을 게시할수 없기 때문에 2000 자 넘는경우 제한하는 로직이 필요하다.

code.gs

function postDiscord(postMessage) {
    const webhooks = 'https://discord.com/api/webhooks/webhooks/{webhook.id}/{webhook.token}';
    const channel = '{channel name}';
    const parse = 'full';
    const method = 'post';

    const payload = {
        channel: channel,
        content: postMessage,
        parse: parse,
    };

    const params = {
        method: method,
        payload: payload,
        muteHttpExceptions: true,
    };

    response = UrlFetchApp.fetch(webhooks, params);
}

function sendMailsToDiscord() {
    const searchQuery = '{gmail query}';
    const date = new Date();
    const checkSpan = 30;
    date.setMinutes(date.getMinutes() - checkSpan);

    const threads = GmailApp.search(searchQuery);
    const msgs = GmailApp.getMessagesForThreads(threads);

    for (let i = 0; i < msgs.length; i++) {
        const lastMsgDate = threads[i].getLastMessageDate();

        if (lastMsgDate.getTime() < date.getTime()) break;

        for (let j = 0; j < msgs[i].length; j++) {
            const msgDate = msgs[i][j].getDate();
            const msgBody = msgs[i][j].getPlainBody();
            const subject = msgs[i][j].getSubject();

            const postMessage =
                'From mailing list' +
                '\n' +
                Utilities.formatDate(msgDate, 'America/New_York', 'MM/DD/yyyy hh:mm:ss') +
                '\n' +
                'Title:' +
                subject +
                '\n' +
                '[hr]' +
                msgBody;

            // 2000 Characters limits
            if (postMessage.length > 2000) {
                const stopPos = 1900; //
                const msg = '"Exceeded 2000 character limit."';
                postMessage = postMessage.substring(0, stopPos) + '\n' + msg;
            }

            postDiscord(postMessage);
        }
    }
}

trigger 를 설정

이후 새로운 메일이 올 경우 지정한 채널에 새로운 메세지가 푸시될 것이다.

Note

실행할 함수를 선택: sendMailsToDiscord

실행할 배포: Head

이벤트 소스 선택: 시간 기반

트리거 기반 시간 유형 선택: 분 단위 타이머

분 간격 선택: 30분마다

트리거 실패 알림 설정: 즉시 알림

trigger 화면

Conclusion

본 포스팅에서는 GMAIL에서 Discord 채널에 새로운 메일이 올때마다 푸시하는 webhook을 Google App Script를 통해 Set up해 보았다.

Discord는 퍼포먼스에 민감한 게이머를 만족시킬수 있을정도의 수준의 서비스를 제공하고 있고 앞으로 여러 프로젝트에서도 많이 쓰일 것이다. 여기에 전 세계 메일의 표준이라고도 할수 있는 GMAIL을 연동하는 것은 가장 많이 사용하는 Webhook 중 하나가 될것이며 본 포스팅이 그런 부분에 많은 도움이 되었으면 하는 바램이다.

본 포스팅에 쓰인 Method가 궁금하다면 하기의 Google App Script 링크에서 자세한 내용을 참고

Link: https://developers.google.com/apps-script/reference/document

DEV Community