장사왕 스프린트 대시보드

테마

Story: SmsForwarder 설정 + PoC ​

메타 ​

항목값
Story IDE-05-S-03
EpicE-05 연동 자동화
상태ready-for-dev
우선순위P0
규모S
담당 개발자하록 (BE), 운영팀

사용자 스토리 ​

As a 운영팀,
I want Android 업무폰에 SmsForwarder를 설치하고 설정하고 싶다,
So that SMS 수신 시 자동으로 서버에 전달된다.

수락 기준 (Acceptance Criteria) ​

AC-01: 앱 설치 ​

항목내용
GivenAndroid 업무폰이 있을 때
WhenSmsForwarder APK를 설치하면
Then앱이 정상적으로 설치되고 실행된다

AC-02: Webhook 채널 설정 ​

항목내용
GivenSmsForwarder가 설치된 상태에서
WhenWebhook 채널을 설정하면
Then지정된 URL로 SMS 내용이 전송된다

AC-03: 전달 규칙 설정 ​

항목내용
GivenWebhook 채널이 설정된 상태에서
When"인증번호" 또는 "쿠팡" 키워드를 포함한 SMS 수신 시
Then해당 SMS만 Webhook으로 전달된다

AC-04: PoC 테스트 ​

항목내용
Given설정이 완료된 상태에서
When테스트 인증 SMS를 수신하면
Then서버에서 정상적으로 수신되고 인증번호가 추출된다

태스크 분해 ​

Task 1: 환경 준비 AC-01 ​

  • [ ] 1.1: Android 업무폰 확보 (Android 7.0 이상)
  • [ ] 1.2: SmsForwarder APK 다운로드 (GitHub Releases)
  • [ ] 1.3: 앱 설치 및 권한 부여

Task 2: 앱 설정 AC-02, AC-03 ​

  • [ ] 2.1: Webhook 채널 생성
    • URL: https://api.sellerking.io/webhook/sms-forward
    • Method: POST
    • Content-Type: application/json
  • [ ] 2.2: 전달 규칙 설정
    • 조건: 내용에 "인증번호" 또는 "인증코드" 포함
    • 또는: 발신자에 "coupang" 포함
  • [ ] 2.3: Body 템플릿 설정

Task 3: PoC 테스트 AC-04 ​

  • [ ] 3.1: 테스트 SMS 발송 (다른 번호에서)
  • [ ] 3.2: 서버 로그에서 수신 확인
  • [ ] 3.3: 인증번호 추출 확인

Task 4: 문서화 ​

  • [ ] 4.1: 설정 가이드 문서 작성
  • [ ] 4.2: 장애 대응 가이드 작성

SmsForwarder 설정 가이드 ​

1. 다운로드 ​

2. Webhook 채널 설정 ​

발신자 채널 추가 > Webhook
- 이름: 장사왕 서버
- URL: https://api.sellerking.io/webhook/sms-forward
- 요청 방식: POST
- 내용 형식: application/json

3. Body 템플릿 ​

json
{
  "from": "{{발신번호}}",
  "content": "{{문자내용}}",
  "timestamp": "{{수신시간}}"
}

4. 전달 규칙 ​

규칙 추가
- 이름: 쿠팡 인증번호
- 조건: 문자 내용 포함 "인증번호" OR "인증코드"
- 발신자 채널: 장사왕 서버

Dev Notes ​

요구사항 ​

항목내용
Android 버전7.0 (API 24) 이상
네트워크Wi-Fi 상시 연결 권장
전원상시 충전
백그라운드배터리 최적화 제외 설정

의존성 ​

  • E-05-S-02: SMS Webhook 수신 API (서버 측)

생성일: 2026-01-20

장사왕 Product Team

© 2026 장사왕