> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# BigCommerce

리셉셔니스트는 BigCommerce 스토어에서 발신자의 주문을 조회하고 상태를 알려줄 수 있습니다. [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)는 BigCommerce Orders API를 통해 고객의 이메일 주소로 주문을 찾습니다.

> **Warning**
>
> 주문에는 고객의 이름, 주소, 전화번호 및 구매 내역이 포함됩니다. 리셉셔니스트는 정보를 공유하기 전에
> 발신자가 해당 고객인지 확인해야 합니다. 아래 도구 설명은 주문 번호와 주문에 등록된 이메일 주소를 모두
> 요청하도록 하며, 둘 다 일치할 때만 주문에 대해 안내합니다.

## 시작하기 전에

### 읽기 전용 API 계정 만들기

BigCommerce 제어판에서 **Settings** → **Store-level API accounts**를 열고 API 계정을 만드세요. "Reception"과 같은 이름을 지정하고 **Orders** 범위를 **read-only**로 설정한 뒤, 다른 모든 범위는 **None**으로 설정하세요. 나중에 범위를 변경할 수 없습니다.

### 자격 증명 복사

계정을 저장하고 **Access token**과 **API path**를 복사하세요. API 경로는 `https://api.bigcommerce.com/stores/STORE_HASH/v3/`와 같으며, `/stores/` 뒤의 부분이 스토어 해시입니다. 액세스 토큰은 비밀 정보로 취급하세요.

## 웹훅 도구 만들기

**Integrations**로 이동해 **Add integration**을 선택한 다음 **Webhook Tool**을 선택하세요.

| 필드           | 값                                                                                                                                                                          |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이름**       | `find_bigcommerce_order`                                                                                                                                                   |
| **설명**       | "발신자가 주문에 관해 문의할 때 주문을 조회합니다. 먼저 주문 번호와 주문에 등록된 이메일 주소를 물어보고, 이메일은 철자를 말해 달라고 요청하세요. 주문 ID와 청구 이메일이 모두 발신자가 말한 정보와 일치하는 주문의 세부 정보만 공유하세요. 그렇지 않으면 찾을 수 없다고 말하고 콜백을 제안하세요." |
| **메서드**      | GET                                                                                                                                                                        |
| **URL**      | `https://api.bigcommerce.com/stores/STORE_HASH/v2/orders`                                                                                                                  |
| **요청 헤더**    | `X-Auth-Token`: 액세스 토큰  `Accept`: `application/json`                                                                                                                       |
| **쿼리 매개변수**  | `email` (string, 필수): "발신자가 제공한 이메일 주소입니다."  `sort` (string, 필수): "항상 정확히 `date_created:desc` 값을 사용합니다."  `limit` (number, 필수): "항상 정확히 `5` 값을 사용합니다."                     |
| **에이전트에 할당** | **Receptionist**                                                                                                                                                           |

`sort` 및 `limit` 값은 가장 오래된 주문 대신 고객의 최신 주문부터 반환합니다.

**Enable**을 선택한 다음 테스트 주문으로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 올바른 주문 번호와 이메일로 문의한 뒤 잘못된 이메일로 다시 문의하여, 두 번째 통화에서는 세부 정보가 제공되지 않는지 확인하세요.

> **Tip**
>
> 응답에는 각 주문의 청구 주소와 결제 정보가 포함됩니다. 리셉셔니스트가 전화로 공유할 수 있는 정보를 위한 [규칙 또는 절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하세요. 예를 들어 상태와 주문 날짜만 공유하도록 설정할 수 있습니다.

## 문제 해결

| 문제                   | 확인할 사항                                                                |
| -------------------- | --------------------------------------------------------------------- |
| BigCommerce에서 401 반환 | 헤더 이름은 `X-Auth-Token`이어야 하며 클라이언트 ID나 클라이언트 시크릿이 아닌 액세스 토큰을 포함해야 합니다. |
| BigCommerce에서 403 반환 | API 계정에 **Orders** 읽기 전용 범위가 없습니다. 해당 범위로 새 계정을 만드세요.                 |
| BigCommerce에서 404 반환 | URL의 스토어 해시와 URL이 `/v2/orders`를 사용하는지 확인하세요.                          |
| 응답이 비어 있음            | 해당 이메일의 주문이 없습니다. 발신자가 결제 시 사용한 이메일을 제공했는지 확인하세요.                     |