BigCommerce | ElevenLabs Documentation

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

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

시작하기 전에

읽기 전용 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을 선택한 다음 테스트 주문으로 리셉셔니스트를 테스트하세요. 올바른 주문 번호와 이메일로 문의한 뒤 잘못된 이메일로 다시 문의하여, 두 번째 통화에서는 세부 정보가 제공되지 않는지 확인하세요.

응답에는 각 주문의 청구 주소와 결제 정보가 포함됩니다. 리셉셔니스트가 전화로 공유할 수 있는 정보를 위한 규칙 또는 절차를 추가하세요. 예를 들어 상태와 주문 날짜만 공유하도록 설정할 수 있습니다.

문제 해결

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