구글시트 제출, 팀즈에서 바로 확인하기 #웹훅

뉴스레터 피드백, 잘 관리되고 있나요?

Jun 2. 2022

프롤로그

우리 회사는 주식·경제 관련 뉴스레터를 매주 화, 목 아침마다 발송하고 있다.

이번 글은 뉴스레터를 운영하면서 독자들의 '피드백'을 놓치지 않고 잘 체크하는 법에 대한 이야기라, 뉴스레터 고도화에 대한 이야기는 다음 기회에 할 예정이다.

우리 팀은 투자자들에게 중요한 정보를 빠르고 정확하게 전달하기 위해 끊임없이 노력하고 있다. '어떻게 하면 부족한 점을 더 개선할 수 있을까?', '어떤 주제를 독자들이 좋아할까?', '제목을 어떻게 지어야 많은 사람들이 궁금해할까?'와 같은 고민을 한다.

그렇게 때문에 독자들의 직접적인 의견을 들을 수 있는 피드백을 수집하여 분석, 반영하는 것을 가장 중요하게 생각하고 있다.

우리 팀이 보내는 뉴스레터(알파 레터) 하단 부 내용

우리 팀은 피드백 수집 툴로 '구글 시트'를 활용하고 있는데, 메일로 알람을 설정할 수 있지만 많은 업무 메일들에 섞여 놓치는 경우가 발생하기도 하고 아직 초기 프로덕트라 피드백이 그리 많지 않아 매일 찾아가서 트래킹 하기가 번거롭다고 느껴졌다.

그래서 어떻게 하면 피드백이 왔을 때 놓치지 않고, 매번 불필요하게 구글시트를 켜보는 일을 줄일 수 있을까?를 고민하다가 팀즈 봇을 만들어보기로 했다.

웹훅(Webhook)

큰 도움을 준(거의 다 떠먹여 주신) 개발자 동료 준형 님께 감사 인사를 드리며, 내가 배운 것들을 정리해보려고 한다.

웹훅은 쉽게 말해 특정 이벤트가 발생했을 때 다른 서비스나 응용프로그램으로 알림을 보내는 기능이다. 이번 같은 경우에는 구글 시트에 '설문 제출'이라는 이벤트가 발생하면 팀즈에 그 내용을 쏘는(알림을 보내는) 기능을 구현한 것이다.

크게 웹훅은 Incoming Webhook과 Outgoing Webhook이 있는데

- Incoming Webhook: 외부 서비스에서 특정 이벤트가 발생했을 때 내부 서비스(팀즈)에서 확인하는 기능

- Outgoing Webhook: 내부 서비스(팀즈)에서 메시지를 작성해 외부 서비스에 데이터를 요청하는 기능

비개발자 입장에서는 이 정도로만 이해해도 충분한 것 같다.

팀즈에서 Incoming Webhook 구현하기

사내에서 실제로 활용하는 팀즈이기 때문에 캡처가 조심스럽다.

내가 Incoming Webhook을 팀즈에 설치할 때 도움받았던 몇 가지 문서를 첨부해본다.

1. 공식문서: microsoft 공식 문서

https://docs.microsoft.com/en-us/microsoftteams/platform/webhooks-and-connectors/how-to/add-incoming-webhook

2. 상세한 step by step이 궁금하다면? 전봉근 님 포스팅

https://bkjeon1614.github.io/blog/teams-web-hook-api-example

위의 내용을 차근차근 따라 하면 웹훅 url 뽑는데 까지는 큰 어려움이 없을 것이다.

혹시나 안된다면 댓글 부탁드립니다!

① 위의 포스팅을 참고하여 팀즈에 incoming 웹훅 설치 후 채널 url 생성하기

② 실시간 알람을 받을 google sheet를 켜서 확장 프로그램 → App Script 클릭

③ 편집기에 함수를 선언한다.

클릭해보셔요!

function sendLetter() {
var teamsUrl="여기에 teams webhook url 넣어주세요";

try {
const spreadsheet = SpreadsheetApp.openById("여기에 googlesheetid를 넣어주세요");

const sheet = spreadsheet.getSheetByName("여기에 시트 이름을 넣어주세요");
var range = sheet.getRange("A:C");
var answers = []

for (i = 1; i <= 4; i++) {
answers[i] = range.getCell(sheet.getLastRow(), i).getValue()
}
} catch (err) {
// TODO (developer) - Handle exception
Logger.log('Failed with error %s', err.message);
}

var questions = [null, "이번 알파레터가 도움이 되셨나요?", "좋았던 점은 무엇인가요?","알파레터가 다뤄줬으면 하는 이슈가 있나요?"]

var text = ""
for (i = 1; i <= 4; i++) {
text += "**"+ questions[i] + "** \n" + answers[i] + " \n \n"
}
Logger.log(text)

var title = "피드백이 도착했습니다";
var card = {
"@context": "https://schema.org/extensions",
"@type": "MessageCard",
"themeColor": "D01411",
"title": title,
"text": text,
"potentialAction": [
{ "@type": "OpenUri",
"name": "바로가기",
"targets": [
{ "os": "default", "uri": "https://docs.google.com/spreadsheets/d/1ejbuMeuaa7U_VXRHwhkatYMjP9Cc4tKI8W8kf47c4rQ/edit#gid=0" }
]
}
]
};

payload = JSON.stringify(card);
var option = {
"contentType": "application/json",
"method": "post",
"payload": payload
};

UrlFetchApp.fetch(teamsUrl, option);
}