OpseerOpseer
Docs
Dashboard

알림

Slack, Discord, Telegram, Webhook을 통해 일일 통계 리포트와 수익 알림(광고 2채널 + 결제 3채널)을 설정하세요.

Last updated: 2026-05-18

Opseer는 두 가지 유형의 알림을 지원합니다: 프로젝트 알림 (일일 통계 리포트)과 개인 알림 (광고 2채널 + 결제 3채널 수익 리포트). 두 가지 모두 매일 설정된 시간에 자동으로 발송됩니다.

연결 방식이 OAuth 기반으로 통일되었습니다 (2026-05). 옛 방식(Webhook URL/Chat ID 직접 입력)으로 등록된 채널은 알림 페이지에서 다시 연결해주세요.

프로젝트 알림

프로젝트 알림은 설정된 통계 컬럼을 기반으로 일일 통계 리포트를 발송합니다. 통계가 수집되면 결과가 리포트로 정리되어 활성화된 채널로 전달됩니다.

지원 채널

Slack

1

"연결" 버튼 클릭

알림 설정 페이지의 Slack 카드에서 "연결" 버튼을 누릅니다. 새 탭(또는 모바일에서는 같은 탭)에서 Slack OAuth 인증 화면이 열립니다.

2

워크스페이스 선택 + 동의

본인 워크스페이스 선택 → 8가지 권한(commands, chat:write, chat:write.public, channels:read, groups:read, im:read, im:write, users:read) 동의 → Allow.

3

채널 선택

OAuth 완료 시 알림 페이지에서 채널 선택 picker가 자동으로 열립니다. public/private 채널 + DM(본인 1:1)이 표시됩니다. DM은 본인 실명으로 표시됩니다.

4

저장

선택 후 저장 버튼을 누르면 카드에 "연결됨" 뱃지가 표시됩니다.

Discord

1

"연결" 버튼 클릭

알림 카드의 "연결" 버튼 → Discord OAuth 인증 페이지로 이동합니다.

2

서버 선택 + 봇 추가

본인 Discord 서버 선택 → 봇 추가 동의 (ViewChannel + SendMessages + EmbedLinks 권한). 본인이 admin인 서버만 선택 가능합니다.

3

채널 선택

OAuth 후 채널 picker가 자동으로 열립니다. 봇이 메시지를 보낼 텍스트 채널을 고릅니다 (기본 #general 사용 가능).

Telegram

Telegram은 두 가지 형태로 연결할 수 있습니다. "연결" 버튼을 누르면 선택 다이얼로그가 표시됩니다.

  • **1:1** — 봇과의 다이렉트 메시지로 알림 받기 (가장 단순, 본인만)
  • **Group** — 본인이 참여한 그룹에 봇 추가, 그룹에 알림 발송 (팀원과 공유 가능)

봇 추가 즉시 자동 연결됩니다. Group은 사용자가 admin인 그룹들이 모달에 자동 표시되며, 모바일 Telegram에서는 새 그룹 생성도 즉석에서 가능합니다.

그룹에서 짧은 슬래시 명령(/revenue 등)을 직접 타이핑으로 받으려면 봇을 그룹 admin으로 승격해주세요. 그렇지 않으면 자동완성(`/`로 시작 시 명령 목록 메뉴)을 사용해 명령에 `@OpseerBot`이 자동 부착되도록 사용합니다.

Webhook

커스텀 HTTPS 엔드포인트로 리포트를 받습니다. 알림 카드의 "연결" 버튼을 누르면 URL 입력 다이얼로그가 표시됩니다. URL은 AES-256-GCM으로 암호화되어 저장됩니다. Zapier, Make, 자체 시스템 등 어디든 사용 가능합니다.

슬래시 커맨드

채널 연결 후 Telegram/Slack/Discord에서 슬래시 명령으로 매출/통계를 즉시 조회할 수 있습니다.

  • `/opseer` — 명령 목록 + 도움말 (Free, 잠긴 명령은 🔒 표시)
  • `/revenue [채널] [기간]` — 연동된 수익 채널 매출 조회 (모든 기간에서 실시간 API 호출)
  • `/stats [프로젝트] [기간]` — 프로젝트 통계 (today=실시간 사용자 DB 쿼리, 그 외=`project_stats_data` 집계)

**Multi-step picker** — 인자를 생략하면 버튼으로 선택할 수 있습니다 (2026-05-14 통합):

  • 채널/프로젝트가 **2개 이상 연동**되어 있으면 첫 화면에 `[All]` 옵션 + 연동된 것만 노출 → 기간 picker
  • 채널/프로젝트가 **1개만 연동**되어 있으면 첫 picker 자동 스킵 → 바로 기간 picker로 직진
  • **기간 6개**: `today` / `yesterday` / `7d` / `this-month` / `last-month` / `30d`
  • **Free 플랜**은 `today`만 사용 가능. 나머지 5개 기간은 Starter+ 전용 (🔒 표시)
  • `/revenue all`은 연동된 모든 채널을 병렬로 조회해 각 채널 섹션을 한 메시지에 합쳐 보냅니다. `/stats all`은 채팅방에 묶인 프로젝트 전체를 병렬 조회합니다 (응답이 메시지 길이 한도 초과 시 자동 truncate + 안내)

채팅방 컨텍스트 분리

각 명령은 그 채팅방에 어떤 알림이 연결되었는지에 따라 동작 여부가 정해집니다 (2026-05-14):

  • **개인(수익) 알림 연결된 채팅방** → `/revenue` 동작. `/stats`는 거부
  • **프로젝트 알림 연결된 채팅방** → `/stats` 동작 (그 채팅방에 묶인 프로젝트만 listing). 수익 명령은 거부
  • **개인 + 프로젝트 모두 연결된 채팅방** → 모든 명령 동작 (`/stats`는 그 채팅방에 묶인 프로젝트만)
  • **알림이 연결되지 않은 채팅방** → 봇이 "notLinked" 오류 메시지로 응답 (데이터 반환 없음)

본인(알림 연결한 사용자)만 데이터 조회가 가능합니다. 그룹/채널의 다른 멤버가 슬래시 보내면 거부됩니다. 응답은 채팅방에 공개되어 팀원이 함께 봅니다 (팀 공유 정책).

같은 채팅방에 여러 사용자가 각자 개인 알림을 연결한 경우(예: A 그룹에 사용자1·사용자2 모두 연결) 각자 본인 매출만 응답 받습니다.

Telegram 그룹에서는 명령 뒤에 `@OpseerBot`을 붙여야 봇이 받습니다 (예: `/revenue@OpseerBot`). 또는 `/`로 자동완성을 사용하면 Telegram이 자동으로 `@OpseerBot`을 부착합니다. 봇을 그룹 admin으로 승격하면 짧은 `/revenue` 직접 타이핑도 받습니다.

알림 시간

각 프로젝트마다 자체 알림 시간을 설정할 수 있습니다. 타임존과 원하는 시간 (시, 분)을 선택합니다. Opseer가 UTC로 변환하여 매일 해당 시간에 수집 + 리포트 발송을 실행합니다.

알림 시간은 통계 수집과 리포트 발송에 공유됩니다. 알림 시간이 되면 Opseer가 먼저 통계를 수집한 후, 최신 데이터로 리포트를 발송합니다.

발송 테스트

채널 설정 후 "테스트" 버튼을 클릭하여 샘플 리포트를 발송합니다. 메시지가 성공적으로 전달되는지 확인할 수 있습니다. 수익 알림 테스트 발송은 오늘 데이터 + 어제 대비 등락폭으로 표기됩니다 (계정의 시간대 기준).

개인 알림 (수익 리포트)

개인 알림은 프로젝트 알림과 별도이며, 광고 2채널(AdMob/AdSense)과 결제 3채널(Stripe/RevenueCat/Polar)의 어제 매출을 한 메시지에 묶어 발송합니다. 결제 3채널은 5 metric 통일(MRR / Revenue / Orders / New Subs / Churned)로 표기됩니다. 프로젝트 단위가 아닌 사용자 단위로 설정됩니다.

  • 유료 플랜 필요 (Starter / Plus / Max) — 채널 활성화 + 5채널 중 1개 이상 선택 시에만 플랜 체크
  • AdMob/AdSense는 Google OAuth, Stripe는 Restricted API Key, RevenueCat·Polar는 OAuth (모두 read-only)
  • 사이드바의 "개인 알림" 메뉴에서 구성 (/dashboard/alert)
  • 독립적인 알림 시간과 채널 설정
  • Slack, Discord, Telegram, Webhook 채널 지원

자세한 설정 방법은 AdMob, AdSense, Stripe, RevenueCat, Polar 연동 가이드를 참고하세요.

알림 활성화 방식

프로젝트에 하나 이상의 채널이 활성화되어 있으면 알림이 자동으로 활성 상태가 됩니다. 별도로 알림을 켜거나 끌 필요가 없습니다. 채널을 활성화하고 알림 시간을 설정하면 다음 예약 시간부터 리포트가 도착합니다.