> 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.

# WooCommerce

접수 담당자는 WooCommerce 스토어에서 발신자의 주문을 조회하고 상태를 알려줄 수 있습니다. [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)는 WooCommerce REST API를 통해 스토어의 주문을 검색합니다.

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

## 시작하기 전에

### 스토어 설정 확인

스토어는 HTTPS를 사용해야 하며, 고유주소가 활성화되어 있어야 합니다. WordPress에서 **설정** → **고유주소**를 열고 **기본** 이외의 옵션을 선택하세요.

### 읽기 전용 API 키 생성

WordPress에서 **WooCommerce** → **설정** → **고급** → **REST API**를 열고 **키 추가**를 선택하세요. "Reception"과 같은 설명을 입력하고 사용자를 선택한 다음, **권한**을 **읽기**로 설정하고 **API 키 생성**을 선택하세요. **Consumer key**와 **Consumer secret**을 복사하세요. secret은 한 번만 표시됩니다.

### 헤더 값 만들기

WooCommerce는 HTTP basic auth로 키를 인증합니다. 컴퓨터에서 헤더 값을 만드세요.

```bash
printf 'CONSUMER_KEY:CONSUMER_SECRET' | base64
```

## 웹훅 도구 만들기

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

| 필드           | 값                                                                                                                                                                        |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **이름**       | `find_woocommerce_order`                                                                                                                                                 |
| **설명**       | "발신자가 주문에 관해 문의하면 주문을 조회합니다. 먼저 주문 번호와 주문에 등록된 이메일 주소를 요청하고, 이메일 주소를 철자대로 말하게 하세요. 주문 번호와 청구 이메일이 모두 발신자가 말한 정보와 일치하는 주문의 세부 정보만 공유하세요. 그렇지 않으면 찾을 수 없다고 말하고 콜백을 제안하세요." |
| **메서드**      | GET                                                                                                                                                                      |
| **URL**      | `https://YOUR-STORE.com/wp-json/wc/v3/orders`                                                                                                                            |
| **요청 헤더**    | `Authorization`을 `Basic ` 뒤에 인코딩된 값을 붙여 설정                                                                                                                               |
| **쿼리 매개변수**  | `search`(문자열, 필수): "발신자가 제공한 이메일 주소."  `per_page`(숫자, 필수): "항상 정확히 `5`로 설정합니다."                                                                                          |
| **에이전트에 할당** | **Receptionist**                                                                                                                                                         |

**Enable**을 선택한 다음 테스트 주문으로 [접수 담당자 테스트](/docs/ko/reception-ai/receptionist/testing)를 진행하세요. 올바른 주문 번호와 이메일로 주문을 문의한 뒤 잘못된 이메일로 다시 문의하고, 두 번째 통화에서는 세부 정보를 받지 못하는지 확인하세요.

> **Tip**
>
> 응답에는 주소를 포함해 각 주문의 모든 필드가 포함됩니다. 접수 담당자가 전화로 공유할 수 있는 정보를 정하는 [규칙 또는 절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하세요. 예를 들어 상태, 주문 날짜, 배송 추적 번호만
> 공유하도록 설정할 수 있습니다.

## 문제 해결

| 문제                     | 확인할 사항                                                                                          |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| WooCommerce에서 401을 반환함 | 헤더 값을 다시 인코딩하세요. 일부 호스트는 WordPress가 확인하기 전에 `Authorization` 헤더를 제거합니다. 호스트에 해당 헤더를 전달하도록 요청하세요. |
| 404 `rest_no_route`    | URL의 스토어 주소와 고유주소가 **기본**으로 설정되어 있지 않은지 확인하세요.                                                  |
| 알고 있는 주문을 찾을 수 없음      | 검색은 주문에 저장된 청구 세부 정보를 기준으로 일치합니다. 발신자가 결제 시 사용한 이메일을 제공했는지 확인하세요.                               |
| 방화벽 또는 보안 플러그인이 차단함    | 플러그인이나 호스트의 방화벽에서 `/wp-json/wc/` 요청을 허용하세요.                                                     |