최근 프로젝트에서 Knock.app을 사용해 알림 시스템을 구축한 경험을 공유하고자 한다. 복잡한 알림 관리 요구사항을 해결하기 위해 여러 솔루션을 검토하다가 Knock라는 서비스를 발견했고, 이를 통해 카카오 알림톡과 인앱 알림을 효과적으로 구현할 수 있었다.

프로젝트의 시작: 알림 시스템 선택 과정

처음 알림 시스템을 구축할 때는 직접 구현해야 할까, 아니면 기존 서비스를 활용할까 고민이 많았다. 여러 옵션을 검토한 결과, Knock가 제공하는 특징들이 프로젝트에 딱 맞다고 판단했다.

왜 Knock를 선택했나?

┌─────────────────┐    ┌────────────────┐    ┌────────────────┐
│                 │    │                │    │                │
│  애플리케이션      │───▶│  Knock.app API │───▶│  카카오 알림톡     │
│                 │    │                │    │                │
└─────────────────┘    └────────────────┘    └────────────────┘
        │                      │                     │
        │                      │                     │
        ▼                      ▼                     ▼
┌─────────────────┐    ┌────────────────┐    ┌────────────────┐
│                 │    │                │    │                │
│  웹훅 엔드포인트    │◀───│   스케줄러       │    │      SMS       │
│                 │    │                │    │                │
└─────────────────┘    └────────────────┘    └────────────────┘

Knock의 특징 중에서 가장 마음에 들었던 것은:

• 멀티 채널 지원: 하나의 워크플로우로 여러 채널에 알림 발송 가능
• 사용자 식별: 다양한 식별자를 통해 수신자 관리
• 템플릿 기반 디자인: 알림 템플릿을 통한 일관된 메시지 관리
• 스케줄링: 알림 예약 및 지연 발송 기능
• 배치 처리: 여러 알림을 묶어서 처리하는 기능

2. Knock 워크플로우 생성 단계

Knock 알림 시스템을 처음 구축할 때는 Knock 대시보드에서 워크플로우를 생성하고 구성해야 했다. 다음은 워크플로우 생성 및 설정에 대한 상세 가이드이다.

2.1 Knock 계정 및 프로젝트 설정

1. Knock 계정 생성
   • Knock.app 웹사이트에 접속하여 계정 생성
   • 이메일 인증 완료
2. 프로젝트 생성
   • 대시보드에서 "Create Project" 버튼 클릭
   • 프로젝트 이름 입력 (예: "플랫폼 알림 시스템")
   • 필요한 경우 팀 멤버 초대
3. API 키 확인
   • 프로젝트 설정 → API Keys 메뉴로 이동
   • 개발용(Development)과 프로덕션용(Production) API 키 확인 및 저장
   • 이 키는 서버에서 Knock API를 호출할 때 필요하다.

// 서버 환경 변수 설정 예시
// 개발 환경
KNOCK_DEV_API_KEY = sk_dev_xxxxxxxxxxxxxxxxxxxx;
// 프로덕션 환경
KNOCK_PROD_API_KEY = sk_prod_xxxxxxxxxxxxxxxxxxxx;
// 클라이언트용 공개 키
KNOCK_PUBLIC_API_KEY = pk_xxxxxxxxxxxxxxxxxxxx;

2.2 채널 설정