앱 설치와 관리

앱은 상점에 설치해서 씁니다. 설치할 때 앱이 쓸 권한·보낼 곳·받을 이벤트에 동의하고, 그 뒤 앱은 동의한 범위 안에서만 상점을 다룹니다. 설치·설정·제거는 상점의 소유자·관리자가 합니다.

설치

상점 플랫폼 앱 › 앱 목록에서 앱 카드를 누르면 앱 상세가 열립니다. 개발자가 쓴 README와 정보·Scope·Hook을 보고 **[설치]**를 누릅니다. 지금은 내가 속한 개발자 조직이 만든 앱만 목록에 보입니다.

1. 설치 화면에서 아래 항목을 확인합니다. 지금 보고 있는 상점에 설치합니다.
   • Scope — 앱이 할 수 있는 일을 문장으로 보여 줍니다. 쓰기 권한(「수정합니다」·「처리합니다」)은 따로 표시됩니다.
   • 이 앱이 데이터를 보내는 곳 — 앱 코드가 호출할 수 있는 외부 호스트입니다. 여기 없는 곳으로는 데이터가 나가지 않습니다.
   • Hook — 주문·클레임 등 앱에 전달되는 이벤트입니다.
   • Sayren이 확인하지 않은 앱 경고 — 심사를 거치지 않은 앱입니다. 개발자를 아는 경우에만 설치하십시오.
2. 설정을 채웁니다. 필수 항목이 비어 있으면 설치할 수 없습니다. 설정은 설치 뒤에도 바꿀 수 있습니다.
3. **[설치]**를 누르면 **앱 › 설치한 앱 › {앱}**으로 이동합니다.

개발자가 준 설치 버튼이나 링크(developer.sayren.app [내 상점에 설치])로 오면 Sayren 계정의 동의 화면이 열립니다. 설치할 상점(내가 소유자·관리자인 상점)을 고르고 같은 항목을 확인해 동의하면 상점 플랫폼으로 이동합니다. 필수 설정이 있으면 설정 폼이 먼저 보입니다.

내 역할이 가진 권한을 넘는 앱은 설치할 수 없습니다(예: 관리자는 매출 리포트 권한을 요청하는 앱을 설치하지 못합니다). 한 상점에 같은 앱은 하나만 설치됩니다.

앱 화면과 설정

상점 플랫폼 앱 공간에 설치한 앱이 나옵니다.

앱이 상점에 한 모든 변경은 감사 로그에 행위자 앱으로 남습니다. 구성원 초대·결제 설정· 액세스 토큰 발급처럼 사람만 할 수 있는 작업은 앱이 권한을 가져도 거부됩니다.

권한 업데이트

개발자가 권한·외부 호스트·이벤트가 늘어난 새 버전을 내면 기존 설치는 옛 버전으로 계속 동작하고 목록과 앱 상세에 「권한 업데이트 필요」가 보입니다. **[권한 확인]**을 누르면 동의 화면에서 늘어난 항목을 확인하고 재동의합니다. 재동의하지 않아도 앱은 옛 범위로 계속 동작합니다.

제거

**앱 › {앱} › 정보 › [제거]**를 누릅니다. 제거하면 곧바로:

• 앱의 상점 접근이 끊깁니다. 진행 중이던 호출도 거부됩니다.
• 앱 화면이 사라지고 이벤트가 가지 않습니다.
• 앱에 제거 사실이 통지됩니다.

48시간 뒤 설정값이 지워지고, 앱에 상점 데이터를 지우라는 통지가 갑니다. sayren 밖(개발자 서비스)에 복사된 데이터의 삭제는 개발자 책임입니다. 제거한 앱은 다시 설치할 수 있고 설정은 처음부터 채웁니다. 제거 기록은 감사 로그에 남습니다.

구매자 탈퇴

구매자가 탈퇴하면 고객 정보 권한(customer:r·customer:rw)으로 설치된 앱에 그 고객의 데이터를 지우라는 통지가 갑니다.

앱이 동작하지 않을 때

관리 API

상점 플랫폼 전용입니다(액세스 토큰·AI 에이전트로는 조회만 됩니다).