커스텀 DB 시작하기
커스텀 DB란?
커스텀 DB(Custom Database)는 자신의 비즈니스 모델에 맞춰 직접 데이터베이스를 설계하고 데이터를 수집·관리할 수 있는 맞춤형 데이터베이스 기능입니다. 정해진 틀에 구애받지 않고 필요한 데이터 형태를 자유롭게 정의하며 유연하게 확장할 수 있습니다.
엑셀로 쉽게 이해하는 커스텀 DB
커스텀 DB | 엑셀 | 설명 |
컬렉션 | 테이블 (시트) | 연관된 데이터들의 집합체 (예: 매장/지점 목록 — 지점명, 주소, 연락처, 영업시간 등) |
필드 | 열 (Column) | 데이터의 항목 및 속성 (예: 이름, 이메일, 전화번호 등) |
리소스 | 행 (Row) | 실제로 저장된 개별 데이터 1건 (예: ‘강남점’의 상세 데이터) |
커스텀 DB(데이터베이스) 만들기
컬렉션 추가하기
컬렉션은 최대 5개까지 추가할 수 있습니다.
컬렉션 설정
•
컬렉션 ID
◦
API에서 컬렉션을 구분하는 고윳값으로, 저장 후 수정할 수 없습니다.
◦
영문 소문자와 하이픈(-)만 입력해야 합니다.
◦
예시: 매장/지점 목록 → stores 또는 storelist
•
컬렉션 이름
◦
컬렉션 목록에서 해당 컬렉션을 확인할 수 있는 이름입니다.
◦
예시: 매장/지점 목록
컬렉션 설명
•
해당 컬렉션이 어떤 데이터를 다루는지에 대한 간단한 메모입니다.
•
예시: 전국 오프라인 매장 위치 및 영업시간 관리용 DB
알림 설정
•
방문자가 웹사이트에서 리소스를 생성하거나 수정하면 알림을 받을 수 있으며, 컬렉션마다 수신 여부를 각각 설정할 수 있습니다.
필드 구성하기
데이터 타입 살펴보기
수집하고자 하는 데이터의 성격에 맞춰 적절한 데이터 타입을 선택해 주세요.
•
단문형 텍스트
◦
한 줄 정도의 짧은 문자열을 입력합니다.
•
장문형 텍스트
◦
단순 줄글 형태로 긴 본문 텍스트를 입력합니다.
•
텍스트 에디터
◦
굵게, 글자 색상, 서식 등 스타일을 적용할 수 있는 에디터를 제공합니다.
•
숫자
◦
정수 형태의 숫자 데이터를 입력합니다.
◦
소수점은 입력할 수 없습니다.
•
날짜·시간
◦
날짜와 시간을 선택·입력합니다.
•
스위치
◦
ON/OFF 형태의 스위치 버튼으로 값을 선택합니다.
•
선택 박스
◦
드롭다운 메뉴 형태로 미리 지정한 옵션 중 하나를 선택합니다.
•
리스트
◦
여러 개의 하위 필드를 한 세트로 묶어 반복해서 수집·관리합니다.
◦
리스트 안에 들어갈 하위 필드의 데이터 타입(단문형 텍스트, 장문형 텍스트, 숫자, 날짜·시간, 스위치, 선택 박스)을 선택해 추가할 수 있습니다.
◦
하위 필드는 최대 20개까지 추가할 수 있습니다.
◦
예시: 매장 영업시간을 요일·오픈 시간·마감 시간 세트로 여러 개 등록할 때 사용
•
파일 첨부
◦
이미지, 문서 등의 파일을 등록 및 업로드합니다.
◦
필드를 만들 때 공개 또는 비공개를 선택하며, 생성 후에는 변경할 수 없습니다.
▪
공개는 파일 주소로 누구나 접근할 수 있고, 비공개는 일회용 주소로만 열람할 수 있습니다.
◦
비회원이 첨부한 파일은 공개·비공개 여부와 관계없이 14일간만 유효하며, 기간이 지나면 다운로드할 수 없습니다. 회원이 첨부한 파일에는 이 제한이 없습니다.
◦
장기 보관이 필요한 파일은 회원 권한으로 받는 것을 권장합니다.
•
휴대폰 번호
◦
휴대폰 번호를 수집합니다.
필드 설정하기
•
필드 ID
◦
API에서 필드를 구분하는 고윳값으로, 저장 후 수정할 수 없습니다.
◦
필드 ID는 영문 대소문자, 숫자, 밑줄(_)만 입력할 수 있으며 숫자로 시작할 수 없습니다.
◦
id, createdAt, updatedAt, customer는 필드 ID로 사용할 수 없습니다.
•
필드 이름
◦
해당 필드를 알아보기 쉽게 표시하는 이름입니다.
•
필수 여부
◦
선택: 리소스를 추가할 때 해당 필드를 입력하지 않아도 됩니다.
◦
필수: 리소스를 추가할 때 해당 필드를 반드시 입력해야 합니다.
•
기본 값 설정
◦
리소스를 추가할 때 값을 입력하지 않으면 설정한 기본 값이 등록됩니다.
권한 설정하기
[식스샵 프로 > 커스텀 DB]에서 컬렉션을 선택한 뒤 권한 항목에서 설정합니다. 회원과 비회원 각각의 스위치를 켜고 허용할 동작을 선택한 다음, 오른쪽 상단의 저장을 클릭합니다.
스위치를 끄면 체크해 둔 권한도 적용되지 않으며, 해당 방문자 유형은 이 컬렉션의 데이터에 접근할 수 없습니다.
컬렉션에 필드를 추가하면 비회원 권한이 켜진 상태로 단건 조회·목록 조회·개수 조회가 허용되어 있습니다. 개인정보를 수집하는 컬렉션은 저장하기 전에 비회원 권한을 반드시 확인하세요. 조회를 허용한 필드의 값은 모든 방문자에게 공개됩니다.회원이 본인이 등록한 리소스만 보도록 하려면 비회원의 조회 권한(단건 조회·목록 조회·개수 조회)을 해제하세요. 비회원 조회를 허용하면 회원도 모든 리소스를 볼 수 있습니다.
회원
회원 권한은 로그인한 회원이 본인이 등록한 리소스에만 적용되며, 다른 회원이 등록한 리소스는 조회·수정·삭제할 수 없습니다. 이 범위는 변경할 수 없습니다.
다른 회원의 글까지 보여주려면 회원 권한이 아니라 비회원 권한의 조회를 허용하세요.
•
단건 조회
◦
본인이 등록한 리소스의 상세 정보를 조회할 수 있습니다.
◦
예시: 회원이 본인이 접수한 신청 내역 상세 정보를 확인할 때 설정
•
목록 조회
◦
본인이 등록한 리소스의 목록을 볼 수 있습니다.
◦
예시: 마이페이지에서 내가 접수한 신청 내역을 나열해서 보여줘야 할 때 설정
•
개수 조회
◦
본인이 등록한 리소스의 개수를 확인할 수 있습니다.
◦
예시: "내가 접수한 신청 3건"과 같이 숫자로 표현해 보여줘야 할 때 설정
◦
페이지 번호, 글 번호 매기기, '총 N건' 표시처럼 전체 개수가 필요한 기능에 사용합니다. 목록만 보여준다면 허용하지 않아도 됩니다.
•
생성
◦
방문자(회원)가 웹사이트에서 새 리소스를 직접 등록할 수 있습니다.
◦
회원 권한으로 등록한 리소스는 작성자가 회원으로 기록되어, 이후 본인이 조회·수정·삭제할 수 있습니다.
◦
예시: 문의 접수, 이벤트 응모, 신청서 작성처럼 방문자가 직접 입력하는 기능을 만들 때 설정
•
수정
◦
회원이 직접 등록한 리소스의 내용을 수정할 수 있습니다.
•
삭제
◦
회원이 직접 등록한 리소스를 삭제할 수 있습니다.
로그인한 회원이 본인이 등록한 글을 다시 조회·수정·삭제하게 하려면, 회원 권한의 생성을 허용하고 글 등록 폼이 회원 권한으로 등록하도록 블록을 만들어야 합니다.
비회원
비회원 권한은 로그인하지 않은 방문자뿐 아니라 로그인한 회원을 포함한 모든 방문자에게 적용됩니다. 회원 권한을 모두 해제해도 비회원 권한이 켜져 있으면 회원도 조회와 등록을 할 수 있습니다.
•
단건 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스의 상세 정보를 조회할 수 있습니다.
◦
예시: 매장 상세 정보나 공지사항 상세 내용을 모든 방문자에게 보여줘야 할 때 설정
•
목록 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스 목록을 볼 수 있습니다.
◦
예시: 웹사이트에 후기나 공지사항을 나열해서 보여줘야 할 때 설정
•
개수 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스의 개수를 확인할 수 있습니다.
◦
예시: "지금까지 접수된 신청 128건"과 같이 전체 개수를 보여줘야 할 때 설정
◦
페이지 번호, 글 번호 매기기, '총 N건' 표시처럼 전체 개수가 필요한 기능에 사용합니다. 목록만 보여준다면 허용하지 않아도 됩니다.
•
생성
◦
로그인 여부와 관계없이 모든 방문자가 웹사이트에서 새 리소스를 직접 등록할 수 있습니다.
◦
비회원 권한으로 등록한 글은 로그인한 회원이 작성하더라도 작성자가 '비회원'으로 기록되어, 회원 권한의 조회·수정·삭제 대상이 되지 않습니다.
◦
파일 첨부 필드가 있는 경우, 비회원이 첨부한 파일은 14일간만 유효합니다.
◦
예시: 로그인 없이 문의나 이벤트 응모를 받을 때 설정
필드별 권한 설정
리소스 권한에서 허용한 동작에 한해, 필드마다 아래 권한을 따로 설정할 수 있습니다. 허용하지 않은 동작의 필드 권한은 회색으로 표시되어 설정할 수 없습니다.
•
조회: 방문자에게 해당 필드의 값을 보여줄지 설정합니다. 단건 조회 또는 목록 조회를 허용한 경우에 설정할 수 있습니다.
•
입력: 방문자가 리소스를 등록할 때 해당 필드를 입력할 수 있는지 설정합니다. 생성을 허용한 경우에 설정할 수 있습니다.
•
수정: 회원이 본인이 등록한 리소스의 해당 필드를 수정할 수 있는지 설정합니다. 수정을 허용한 경우에 설정할 수 있으며, 회원 권한에만 있습니다.
•
삭제는 필드별 설정이 없습니다.
•
예시: 문의·신청 접수 폼에서 이름·연락처·이메일은 입력만 허용하고 조회는 허용하지 않아, 다른 방문자가 개인정보를 볼 수 없게 할 때 설정
권한 선택 가이드
만들려는 기능 | 필요한 권한 |
모든 방문자에게 보여주는 게시판 (다른 회원의 글 포함) | 비회원: 목록 조회, 단건 조회 |
페이지 번호나 '총 N건'을 표시 | 위 권한에 개수 조회 추가 |
로그인 없이 쓰는 문의·방명록·신청서 폼 | 비회원: 생성 |
로그인한 회원이 쓰는 폼 (작성자가 회원으로 기록) | 회원: 생성 |
내가 쓴 글 목록 | 회원: 목록 조회 |
내 글 수정·삭제 | 회원: 단건 조회, 수정, 삭제 |
생년월일 등 입력만 받고 노출은 막기 | 필드별 권한: 입력 허용, 조회 해제 |
API 정보 활용하기
컬렉션 구성과 권한 설정을 마쳤다면, 웹사이트에 데이터를 수집하거나 보여주는 블록을 추가합니다.
API 정보 복사하기
1.
[식스샵 프로 > 커스텀 DB]에서 컬렉션을 선택한 뒤, 오른쪽 상단의 API 정보를 클릭합니다.
2.
복사 버튼을 클릭합니다.
3.
상단의 에디터 바로가기를 클릭하면 디자인 에디터로 이동합니다.
API 정보에는 현재 허용된 동작만 포함됩니다. 권한을 변경한 뒤에는 API 정보를 다시 복사해 블록을 새로 만들어 주세요. 허용되지 않은 동작을 사용하는 블록은 정상적으로 동작하지 않습니다.
데이터 수집용 블록 만들기
1.
디자인 에디터로 이동합니다. API 정보 화면에서 에디터 바로가기를 클릭하거나, [식스샵 프로 > 웹사이트 - 디자인]에서 템플릿 우측 디자인 편집하기를 클릭합니다.
2.
블록을 추가할 페이지로 이동합니다.
3.
섹션 메뉴로 이동하고, 섹션 추가 아이콘(+)을 클릭한 뒤 AI 블록 생성에 복사한 API를 붙여넣습니다.
4.
프롬프트를 추가로 입력하고 블록을 생성합니다.
•
예시: "문의 접수 폼 블록을 만들어줘"
데이터 관리하기
데이터(리소스) 등록하기
컬렉션과 필드 구성을 마쳤다면, 이제 컬렉션에 실제 데이터(리소스)를 등록할 수 있습니다. 등록할 데이터의 수량에 따라 단건 등록 또는 엑셀 일괄 등록 방식을 선택해 진행합니다.
[식스샵 프로 > 커스텀 DB]에서 데이터를 추가할 컬렉션을 선택한 뒤, 우측 상단의 버튼을 통해 등록을 진행합니다.
•
엑셀로 리소스 추가 (다건 일괄 등록)
◦
등록할 데이터가 여러 건인 경우 엑셀로 리소스 추가를 클릭하여 엑셀 템플릿 양식을 다운로드하고, 데이터를 일괄 작성한 뒤 업로드합니다.
•
리소스 추가하기 (단건 등록)
◦
등록할 데이터가 1건인 경우 리소스 추가하기를 클릭하여 데이터를 등록합니다.
데이터 필터링 및 정렬
•
[식스샵 프로 > 커스텀 DB]에서 컬렉션 상세의 필터, 정렬 설정을 통해 선택한 필드를 오름차순·내림차순으로 정렬하거나 필터링할 수 있습니다.
•
필터와 정렬에 사용할 수 있는 필드는 각각 최대 3개이며, 장문형 텍스트·텍스트 에디터·파일 첨부·리스트는 사용할 수 없습니다.
알림 설정하기
운영자 수신 설정하기
1.
알림을 받을 컬렉션의 알림 설정을 활성화합니다.
2.
[식스샵 프로 > 설정 > 알림]에서 커스텀 DB의 리소스 생성과 리소스 수정 앞 체크 박스에 체크하고 알림톡·문자·이메일로도 추가 수신 설정할 수 있습니다.
리소스 수정·생성 시 고객에게 알림톡/문자 자동 발송하기
기능 한눈에 보기
•
리소스가 생성되거나 수정되면 설정해 둔 알림톡/문자가 고객에게 자동으로 발송됩니다. 웹사이트, 관리자 화면, 엑셀 일괄 등록 등 생성·수정 경로와 관계없이 조건에 따라 발송할 수 있습니다.
•
받는 사람은 컬렉션의 휴대폰 번호 필드 값 또는 작성한 회원의 휴대폰 번호 중에서 선택할 수 있습니다.
•
컬렉션마다 설정하며, 생성 알림과 수정 알림을 각각 켜고 끌 수 있습니다.
•
수정 알림은 지정한 필드의 값이 바뀔 때만 발송할 수 있으며, 필드마다 다른 템플릿을 연결할 수 있습니다.
◦
예시(생성 알림): 견적 요청이 접수되면 신청자에게 '접수 완료' 알림톡 발송
◦
예시(수정 알림): 진행 상태 필드가 '견적 완료'로 바뀌면 신청자에게 안내 문자 발송
알림톡/문자 템플릿 준비하기
1.
리소스 생성, 리소스 수정 알림 시점 사용 설정 확인하기
[식스샵 프로 > 설정 > 고객 알림 > 카카오 알림톡/문자 발신]에서 커스텀 DB의 알림 시점인 리소스 생성, 리소스 수정이 사용으로 설정되어 있는지 확인해 주세요.
리소스 생성, 리소스 수정 발신 시점은 기본적으로 사용으로 설정되어 있습니다.
컬렉션에서 알림 발신을 사용 안 함으로 설정하면 이 시점이 사용 중이어도 알림이 발송되지 않으니 유의해 주세요.
2.
카카오 알림톡/문자 템플릿 등록하기
사용할 알림 시점(리소스 생성·수정)에 맞는 템플릿을 등록합니다. 템플릿은 [식스샵 프로 > 설정 > 고객 알림 > 카카오 알림톡/문자 발신]에서 추가합니다.
•
메시지 입력에서 변수 추가를 클릭해 변수를 선택하면 #{변수명} 형식으로 본문에 입력됩니다.
•
커스텀 DB 템플릿에서 사용할 수 있는 변수는 다음과 같습니다.
◦
customer.name: 리소스를 생성·수정한 회원의 이름입니다. 회원이 생성·수정한 경우에만 사용할 수 있습니다.
◦
createdAt: 리소스 생성일입니다. 컬렉션에 필드를 추가하지 않아도 사용할 수 있는 리소스 기본 정보입니다.
◦
updatedAt: 리소스 수정일입니다. 컬렉션에 필드를 추가하지 않아도 사용할 수 있는 리소스 기본 정보입니다.
◦
myCustomField: 컬렉션의 필드 값을 넣을 때 사용합니다. myCustomField를 연결할 컬렉션의 필드 ID로 바꿔 입력해 주세요. 컬렉션에 설정된 필드만 지정할 수 있습니다.
▪
예시: 필드 ID가 business_number이면 #{business_number}
◦
스토어이름: 상점 이름입니다.
◦
스토어도메인: 상점 도메인입니다.
•
템플릿을 추가할 때는 변수 사용에 제한이 없습니다. 템플릿을 컬렉션에 연결할 때 사용한 변수가 해당 컬렉션의 권한 설정과 필드 ID에 맞는지 확인하며, 맞지 않으면 연결할 수 없습니다.
•
문자 메시지에는 광고성 정보와 이모지를 포함할 수 없습니다.
•
변수를 포함해 전체 메시지가 90bytes를 초과하면 LMS로 변경되며 메시지 제목과 함께 발송됩니다.
3.
카카오 알림톡/문자 템플릿 사용하기
카카오 알림톡 템플릿은 검수가 완료된 후, 문자 템플릿은 등록 후 사용하기를 클릭합니다.
•
커스텀 템플릿은 여러 개를 동시에 사용 상태로 둘 수 있습니다. 컬렉션이나 상황마다 다른 템플릿을 사용하려면 필요한 만큼 등록해 주세요.
컬렉션에서 알림 발신 설정하기
[식스샵 프로 > 커스텀 DB]에서 컬렉션을 선택하고, 컬렉션 상세의 고객 알림 발신에서 설정합니다. 설정을 마치면 오른쪽 상단의 저장을 클릭합니다.
1.
알림 받을 번호 선택하기
알림 발신을 사용으로 설정하고 알림 받을 번호를 선택합니다. 알림 받을 번호는 필수 항목입니다.
•
컬렉션의 휴대폰 번호 필드
◦
휴대폰 번호 유형의 필드만 선택할 수 있습니다.
◦
리소스에 입력된 번호로 발송합니다.
•
회원 휴대폰 번호
◦
리소스를 작성한 회원의 휴대폰 번호로 발송합니다.
◦
컬렉션 권한에서 회원 스위치가 켜져 있고 생성 권한을 허용한 경우에만 선택할 수 있습니다.
◦
'회원 휴대폰 번호'로는 해당 회원이 작성한 경우에만 발송됩니다.
2.
리소스를 추가할 경우 알림 발신 여부 설정하기
새 리소스가 추가될 때 알림을 발송할지 설정합니다. 웹사이트, 관리자 화면, 엑셀 일괄 등록 등 어떤 경로로 추가해도 적용됩니다.
•
발신 수단을 선택합니다. (알림톡 및 문자 발신 / 알림톡 발신 / 문자 발신 / 발신 안 함)
◦
발신 안 함을 선택하면 리소스가 추가되어도 알림이 발송되지 않습니다.
•
선택한 발신 수단에 맞는 템플릿을 선택합니다.
•
템플릿을 선택하면 변수 필드에 템플릿에 사용된 변수가 표시됩니다. 각 변수는 이 컬렉션의 권한 설정과 필드 ID에 맞는지 확인되어 색상으로 구분되며, 안내 문구도 함께 표시됩니다.
◦
회색: 사용할 수 있는 변수입니다.
◦
ⓘ 아이콘이 있는 회색: 컬렉션에 추가하지 않아도 쓸 수 있는 리소스 기본 정보입니다. (예: createdAt)
◦
주황색: 컬렉션의 회원 권한이 꺼져 있어 customer.name을 사용할 수 없는 경우입니다. 컬렉션 권한 설정을 변경하거나, 템플릿에서 해당 변수를 제거해 주세요.
◦
빨간색: 컬렉션의 필드와 템플릿에 설정한 변수가 매칭되지 않은 경우입니다. 템플릿을 확인해 주세요.
•
주황색 또는 빨간색 변수가 있으면 저장할 수 없습니다.
•
엑셀로 여러 건을 한 번에 등록하면 설정에 따라 각 리소스의 휴대폰 번호로 알림톡/문자가 각각 발송됩니다. 건수만큼 발송되므로 사용하기 전에 알림톡/문자 메시지 충전금 잔액을 확인해 주세요.
3.
리소스를 수정할 경우 알림 발신 여부 설정하기
기존 리소스가 수정될 때 알림을 발송할지 설정합니다. 웹사이트, [식스샵 프로 > 커스텀 DB] 등 어떤 경로로 수정해도 적용됩니다.
•
알림 발신으로 설정하면 발신 시점을 하나 이상 추가해야 합니다. 발신 안 함을 선택하면 수정되어도 알림이 발송되지 않습니다.
•
발신 시점은 '어떤 필드가 바뀌면(알림 조건 필드) → 어떤 템플릿으로 발송할지'로 구성되며, 여러 개 추가할 수 있습니다.
① + 시점 추가하기를 클릭하고 알림 조건 필드를 선택합니다.
② 알림 조건을 선택합니다.
◦
값 변경: 선택한 필드의 값이 변경되면 발송합니다. 어떤 값으로 바뀌든 기존 값에서 달라지기만 하면 발송됩니다.
◦
값 지정: 선택한 필드의 값이 지정한 값으로 변경될 때만 발송합니다.
③ 발신 수단(알림톡 및 문자 / 알림톡 / 문자)을 선택합니다.
④ 발신 수단에 맞는 템플릿을 선택하고 저장을 클릭합니다.
(준비 중)
앱(기능)으로 돌아가기
식스샵 프로 가이드로 돌아가기