슬랙 웹훅 만들기: Incoming Webhook 설정과 알림 연동

안녕하세요. 사랑받는 IT 프로덕트의 첫걸음, 똑똑한개발자입니다.

오늘의 인사이트 요약

1. 웹훅이란 이벤트가 생기면 정해진 주소로 HTTP 요청을 보내는 방식이고, 슬랙의 Incoming Webhook은 채널 하나에 연결된 주소입니다.

2. 슬랙 웹훅 만들기는 앱 생성, Incoming Webhooks 활성화, 채널 선택, URL 복사 네 단계면 끝납니다.

3. 웹훅 URL은 비밀값이고 발송은 채널당 초당 1건이 기준이라, 보관법과 발송량을 먼저 정합니다.

서비스를 열면 가입이 들어왔는지, 결제가 실패했는지 보려고 관리자 화면을 자주 열게 됩니다. 이 확인을 팀 채널로 옮기는 가장 짧은 길이 슬랙 웹훅 만들기인데, 봇을 띄우지 않아도 서버 요청 한 번이면 메시지가 올라옵니다. 고객에게 보내는 문자·푸시 알림은 이전 글에서 다뤘으니 이번에는 팀이 받아 보는 사내 알림만 다룹니다.

웹훅이란 무엇이고, 슬랙 웹훅 알림은 어떻게 도착하나요

웹훅은 이벤트가 생기면 정해진 주소로 요청을 밀어 넣는 방식입니다.

일이 생긴 순간 보내는 쪽이 먼저 알려 주는 구조라, 슬랙 웹훅 알림에서는 우리 서버가 보내고 슬랙이 받습니다.

Incoming Webhook은 슬랙 채널 하나에 묶인 전용 주소입니다.

Slack 공식 문서 기준으로 웹훅 URL은 설치할 때 고른 채널에 고정되고, 요청에서 채널·표시 이름·아이콘을 바꿀 수 없습니다. 채널을 나누려면 웹훅도 채널 수만큼 만듭니다.

슬랙 웹훅 만들기: 앱 생성부터 채널 연결까지

첫째, api.slack.com에서 앱을 만듭니다.

슬랙 웹훅 만들기의 첫 화면은 앱 목록이고, 여기서 앱 생성 버튼을 눌러 빈 앱을 고른 뒤 이름과 워크스페이스를 정하면 설정 화면이 열립니다.

둘째, Incoming Webhooks를 켭니다.

왼쪽 메뉴의 Incoming Webhooks에 들어가 Activate Incoming Webhooks 스위치를 켭니다.

셋째, 알림을 받을 채널을 고르고 허용합니다.

Add New Webhook to Workspace를 누르고 채널을 고른 뒤 허용합니다. 비공개 채널은 먼저 그 채널에 들어가 있어야 목록에 뜹니다.

넷째, 슬랙 웹훅 url 확인은 같은 화면에서 합니다.

Webhook URLs for Your Workspace 아래에 주소가 생기면 슬랙 웹훅 url 만들기는 끝입니다. hooks.slack.com/services/ 뒤에 식별자 세 덩어리가 붙은 형식입니다.

슬랙 웹훅 연동, 첫 알림은 curl 한 줄로 확인합니다

SLACK_WEBHOOK_URL 환경변수에 발급받은 주소를 설정한 뒤 다음처럼 JSON을 보냅니다. 실제 URL은 코드나 공개 저장소에 적지 않습니다.

curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"신규 가입 1건"}' \
  "$SLACK_WEBHOOK_URL"

가입·결제·에러 알림은 채널을 나눠 받습니다.

한 채널에 몰아 두면 에러가 가입 알림에 묻힙니다. 자주 오는 가입 알림과 바로 봐야 하는 결제 실패는 따로 두고, 슬랙 웹훅 연동 코드도 이벤트 종류별로 주소를 고르게 짭니다.

Block Kit을 쓰면 알림을 한눈에 읽히게 만들 수 있습니다.

Slack 문서를 보면 웹훅에서도 Block Kit의 서식·레이아웃 블록을 그대로 쓸 수 있습니다. 주문 번호와 금액은 blocks 배열에 나눠 넣고, text는 미리보기 문구로 남기면 됩니다.

슬랙 웹훅 알림을 운영할 때 미리 정할 세 가지

웹훅 URL은 비밀번호처럼 보관합니다.

웹훅 URL에는 비밀값이 들어 있어 공개 저장소에 올리면 안 되고, Slack은 유출된 값을 찾아서 폐기한다고 밝힙니다. 환경 변수에 두고 코드에는 적지 않습니다.

발송량은 채널당 1초에 1건을 기준으로 잡습니다.

Slack 요청 제한 문서상 웹훅 한도는 초당 1건이고, 잠깐 몰리는 정도는 허용됩니다. 넘치면 HTTP 429와 Retry-After 헤더가 돌아오므로 에러가 쏟아질 때는 묶어서 보내야 합니다.

메시지 수정·삭제가 필요하면 Web API를 검토합니다.

이 글은 앱 기반 Incoming Webhook을 기준으로 설명합니다. 웹훅 URL 자체에는 메시지 수정·삭제 메서드가 없습니다. 보낸 메시지를 관리해야 한다면 필요한 권한과 메시지 식별자를 관리하는 Web API 구성을 검토합니다. Slack Incoming Webhooks 안내

알림 담당자와 대응 기준을 정해 두면 메시지를 받은 뒤의 행동도 명확해집니다. 오류 종류·발생 시각·확인할 관리 화면 링크를 담고, 같은 오류가 몰리면 묶어서 발송할 수 있습니다. 고객의 민감한 정보는 메시지에 불필요하게 포함하지 않습니다.

팀이 놓치기 쉬운 소식을 알림으로

관리 화면을 여러 번 열어 보던 정보를 익숙한 채널에서 받으면 업무 흐름이 한결 단순해질 수 있습니다. 똑똑한개발자는 서비스의 운영 흐름을 살펴보며 알림과 관리 기능을 함께 설계합니다.

가입·결제·오류 가운데 어떤 소식을 먼저 받고 싶은지 들려주세요. 슬랙 채널과 기존 서비스를 연결하는 운영 알림을 함께 구체화해 보겠습니다.

감사합니다. :)