PLD-1118 Phase 1 · 2026-10-15 · 프로토타입 https://orderhero-cs-wam-order-select.pages.dev/ · 만드는 방법은 채널톡 공식 문서(4절)를 따르고, 이 문서는 요구사항·연결 지점·확인 필요 사항만 담음
[고객: 오더히어로 앱 → 채널톡 메신저]
│ 유형 버튼(워크플로우) → [주문 상품 선택] 버튼
▼
[채널톡] ──(Function 호출, x-signature 서명)──▶ [우리 앱 서버 Function Endpoint]
│ │ 채널톡 user → 회원 ID → 주문 조회 API
│ 선택 창 열기 ◀─ {type:"wam"} 응답 ─────────────┤
│ 선택 창 UI ◀─ WAM Endpoint(React 정적) ──────┤
│ [이 상품으로 문의하기] ─ callFunction ─────────▶│ 선택값(주문번호·히어로코드) 수신
│ ① DESK 기록 ◀── PATCH /open/user-chats/{id} ─┤ description · profile · tags
│ ② 첨부 메시지 ◀── POST …/messages ─────────────┘
│ ③ 워크플로우 다음 단계 = 고객 ALF 응대 → 필요 시 상담사
▼
[상담사 DESK] 주문/코드 자동 · 문의/처리만 작성
| 프로토타입 | 구현 | 상태 |
|---|---|---|
| ② 유형 버튼 → [주문 상품 선택] | 워크플로우 응답 버튼. 반품,교환·배송문의 분기에서 봇 메시지 + 버튼 → 앱 커맨드(WAM) 실행 | 버튼→커맨드 직접 실행 여부 채널톡 확인 중. 불가 시: 웹훅 수신 → 우리 서버가 Open API로 버튼 메시지 전송(action type wam) — 명세 확정 |
| ③ 상품 선택 창 | Function이 {type:"wam", attributes:{appId,name,wamArgs}} 반환 → WAM Endpoint의 React 화면. useWamData로 chatId·userId 수신 → 주문 조회 API → 배송(받은 날)별 상품 체크 UI. 완료 시 useCallFunction으로 선택값 전송 | 확정(SDK 문서·샘플) |
| 고객 식별 | 채널톡 userId → getUser(네이티브) 또는 GET /open/users/{id} → profile의 회원 ID → 오더히어로 회원 | 프로필에 회원 ID 필드 있는지 개발팀 확인(2024 앱↔채널톡 연동 시 저장 필드) |
| 주문 조회 API | 회원 ID → 최근 배송 N건의 상품(주문번호·hero_product_code·상품명·수량·보관구분·배송일). 원천 member_order_details | 신규 1개. 조회 범위 결정 필요 |
| ⑤ DESK 자동 기입 (①, 가장 먼저) | PATCH /open/user-chats/{userChatId} body {description:"주문: … / 코드: …", profile:{주문번호, 히어로코드, 문의유형}, tags:["주문연동"]} | 확정. profile 키는 채널 설정 > 상담 프로필에 선생성(CX) |
| ④ 자동 첨부 메시지 (②) | POST /open/user-chats/{userChatId}/messages?botName=오더히어로 body {plainText 또는 blocks} | 확정 |
| ④ ALF 응대 → 상담사 (③) | 워크플로우 "고객 ALF 응대" 액션. ALF 시작 조건 = 태그 '주문연동', 지시문에서 상담 프로필 주문번호 참조. 처리 필요 시 상담사 연결(기존 규칙). ALF 제외 대상(VIP·프랜차이즈 등)은 바로 상담사 | 설정(CX). ①→②→③ 순서 고정 — ①이 먼저여야 ALF가 주문을 아는 상태로 시작 |
| 예외 건너뛰기 | 창 닫고 봇 메시지 "상품명을 입력해 주세요" → 기존 수기 흐름 | — |
x-access-key/x-access-secret(CS 미기재 알림이 쓰는 키와 동일 발급 경로). 앱 서버는 App ID·Secret·Signing Key, 모든 Function 요청 x-signature 검증| 누가 | 내용 | 안 되면 |
|---|---|---|
| 채널톡 | 워크플로우·ALF 버튼에서 우리 앱 커맨드(WAM) 바로 실행 가능? | 웹훅 → Open API 버튼 메시지로 대체(확정) |
| 채널톡 | 오더히어로 앱 안의 채널톡 모바일 SDK 메신저(iOS·Android)에서 WAM 창 뜨는지? (카페24 사례는 웹) | 선택 창만 오더히어로 앱 화면으로 대체, 기록 API는 동일 |
| 채널톡 | ALF가 앱 봇의 첨부 메시지를 대화 맥락으로 읽는지? | 상담 프로필 주문번호 참조로 설계(영향 없음) |
| 개발팀 | 채널톡 유저 프로필에 오더히어로 회원 ID 필드 존재 여부 | 앱→채널톡 진입 시 updateUser(profile)로 저장 추가 |
| CX | 상담 프로필 필드 3개 생성(주문번호·히어로코드·문의유형) · 워크플로우 유형 버튼 복귀 · ALF 시작 조건을 태그 기준으로 | — |
| 기획 | 주문 조회 범위: 최근 7일 vs 최근 배송 5건 | — |