Shopify

  이 통합을 통해 Botpress 챗봇을 선도적인 전자상거래 플랫폼인 Shopify와 연결할 수 있습니다. 이 통합을 통해 챗봇에서 직접 스토어 운영과 관련된 원활한 상호 작용을 촉진할 수 있습니다.

통합 기능을 효과적으로 사용하려면 Shopify 스토어 이름(브라우저/URL에 표시됨)과 Shopify 앱을 생성한 후 생성된 액세스 토큰을 제공해야 합니다.

## 설정 비디오
[![이미지](https://i.imgur.com/mWb0uV9.png)](https://youtu.be/yjvsoaCvjmU)

## 구성 설정

 Botpress 에서 Shopify 통합을 설정하려면 다음 구성이 필요합니다:

1. **샵/스토어 이름**: Shopify 스토어에 액세스할 때 URL에서 찾을 수 있습니다. 예를 들어, 스토어 관리자의 URL이 \`https://admin.shopify.com/store/botpress-test-store\`인 경우 입력할 스토어 이름은 \`botpress-test-store\`입니다.
2. **API 액세스 토큰**: 이 토큰은 Botpress 이 Shopify 스토어와 통신할 수 있도록 허용하는 데 필수적입니다. 토큰을 받으려면 새 Shopify 앱을 생성해야 합니다(아래 지침 참조).

## Shopify 앱 생성
1. Shopify 대시보드에서 '앱 및 판매 채널'로 이동합니다.
2. '앱 개발'을 클릭합니다.
3. 3. '앱 생성'을 선택하고 앱 이름을 지정합니다.
4. 'API 자격 증명'을 클릭하고 '액세스 토큰'에서 '관리자 API 범위 구성'을 선택합니다.
5. 이 연동을 위해서는 '고객', '주문', '제품'에 대한 '읽기' 액세스 확인란을 선택해야 합니다. 이렇게 하면 봇이 각 속성을 읽을 수 있는 액세스 권한이 부여됩니다.
6. '저장'을 클릭한 다음 '앱 설치'를 클릭하여 설치를 완료합니다. 
7. 설치 후 'API 자격증명' 및 '관리자 API 액세스 토큰'으로 이동하여 토큰을 확인/복사할 수 있습니다. 

## 통합 활성화

Shopify 통합을 활성화하려면 Botpress:

1. Botpress  관리자 대시보드에 액세스합니다.
2. 2. "통합" 탭으로 이동합니다.
3. 3. Shopify 통합을 검색하고 "사용" 또는 "구성"을 선택합니다.
4. 4. 필수 상점/스토어 이름 및 관리자 API 액세스 토큰을 입력합니다.
5. 구성을 저장합니다.

## 사용법

### 작업
통합을 활성화하면 Botpress 챗봇이 아래 작업을 사용하여 제품 및 고객 쿼리에 대해 Shopify와 통신할 수 있습니다:

- 고객 목록 가져오기: 고객 목록을 반환합니다.
- 고객 주문 목록 가져오기: 특정 고객의 주문 목록을 상태별(진행 중, 마감됨, 취소됨 등)로 반환합니다.
- 제품 목록 가져오기: ID, 제목 또는 제품 유형을 사용하여 제품 목록을 반환합니다.
- 제품 이형 상품 목록 가져오기: Id를 기준으로 제품의 이형 상품 목록을 반환합니다.

### 이벤트
통합을 활성화하면 Botpres 챗봇은 아래 이벤트를 사용하여 Shopify로부터 이벤트를 수신할 수 있습니다:

- 주문 생성됨: 주문이 생성되면 트리거됩니다.
- 주문 업데이트됨: 주문 업데이트됨: 주문이 업데이트될 때 트리거됩니다. 
- 주문 취소됨: 주문이 취소되면 트리거됩니다. 
- 고객 생성됨: 고객이 생성되면 트리거됩니다.
- 고객 업데이트됨: 고객이 업데이트되면 트리거됩니다. 

 참고: 이러한 이벤트를 특정 대화에 연결할 수 없습니다. 이러한 이벤트는 챗봇 내에 이벤트 정보를 저장하기 위한 것입니다(예: 쿼리할 고객/주문 데이터를 테이블에 저장).

제한 사항 ## 제한 사항
1. Shopify API에 의해 적용되는 속도 제한이 있을 수 있습니다.
2. 이벤트는 대화에 연결되지 않습니다.