카테고리와 상품
다중 통화 가격, 재고, 기능을 포함해 카테고리와 상품을 추가, 수정, 삭제하는 모든 /catalog 옵션이에요.
카테고리
- /catalog category-add
- name(필수), description, emoji(드롭다운에 표시), thumbnail, position(정렬 순서), visible.
- /catalog category-remove
- 카테고리를 삭제해요. keep_products:true이면 상품을 삭제하지 않고 다른 곳으로 옮겨요.
- /catalog category-list
- 각 카테고리의 id와 상품 수를 보여 줘요. 다른 명령어의 자동 완성은 이 id를 사용해요.
상품
- /catalog product-add
- category와 name은 필수예요. 가격은 price_usd, price_eur, price_inr 중 하나로 입력하거나, 가격 하나와 auto_currency:true를 함께 입력해 나머지를 변환할 수 있어요. description(최대 1024자), features(한 줄에 하나), price_display(숫자 대신 표시할 텍스트, 예: “from”), stock, position, available을 설정할 수 있어요.
- /catalog product-remove
- id로 상품을 삭제해요.
- /catalog product-list
- id, 가격, 재고가 포함된 상품 목록을 보여 줘요. 특정 카테고리만 볼 수도 있어요.
- 상품 페이지(대시보드)
- 어떤 항목이든 그 자리에서 수정하고, 드래그로 순서를 바꾸고, 판매 여부를 한 번에 전환할 수 있어요. 상품 이미지도 여기서 설정해요.
재고와 판매 가능 여부
stock은 show_stock이 켜져 있을 때 장바구니에 표시되는 숫자예요. 0이면 장바구니가 “재고가 없어요”와 함께 상품을 거부해요. 봇이 스스로 재고를 줄이지는 않으므로, 배송할 때마다 상품 페이지에서 직접 수정하세요. 무제한이면 비워 두세요. available:false이면 상품은 목록에 남지만 주문할 수 없어요. 숨겨진 카테고리는 그 안의 모든 상품을 숨겨요.
가격
카탈로그는 /catalog currency로 활성화된 통화를 보여 줘요. auto_currency를 쓰면 봇은 캐시된 환율로 기본 통화에서 다른 통화를 계산해요. 깔끔한 숫자를 원하면 다른 가격을 직접 입력하세요. 바우처는 카탈로그 가격이 아니라 인보이스를 만들 때 적용돼요.
상품과 카테고리는 설정 복사로 복사되지 않으며, 어떤 모듈 스위치에도 속하지 않아요. 카탈로그 모듈을 끄면 카탈로그는 숨겨지지만 데이터는 남아요.