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

# Shopmonkey

[웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 발신자가 차량을 입고하고 싶을 때 리셉셔니스트가 Shopmonkey 캘린더에 예약을 추가할 수 있습니다.

> **Warning**
>
> Shopmonkey는 이 방법으로 예약을 만들 때 충돌을 확인하지 않으므로 리셉셔니스트가
> 같은 시간대를 중복 예약할 수 있습니다. 해당 시간은 정비소에서 확인할 요청이라고 발신자에게 안내하거나,
> 리셉셔니스트의 지침에 영업시간과 작업 베이 한도를 제공하세요.

## 설정

### API 키 만들기

Shopmonkey에서 관리자가 **Settings** → **Integration** → **API Keys**를 열고 **Get Started** 또는 **Add New Key**를 선택합니다. **Create API Key**를 선택하고 즉시 키를 복사하세요. Shopmonkey는 키를 한 번만 표시합니다. 이 키에는 생성한 사용자와 동일한 권한이 부여됩니다.

### 웹훅 도구 만들기

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

| 필드           | 값                                                                                                                                                                                                                                                                                                                                                        |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이름**       | `create_shopmonkey_appointment`                                                                                                                                                                                                                                                                                                                          |
| **설명**       | "발신자가 날짜와 시간을 선택한 후 정비소 캘린더에 예약을 추가합니다. 먼저 발신자에게 시간을 확인받으세요."                                                                                                                                                                                                                                                                                            |
| **메서드**      | POST                                                                                                                                                                                                                                                                                                                                                     |
| **URL**      | `https://api.shopmonkey.cloud/v3/appointment`                                                                                                                                                                                                                                                                                                            |
| **요청 헤더**    | `Authorization`: `Bearer ` 뒤에 API 키를 입력                                                                                                                                                                                                                                                                                                                  |
| **본문 매개변수**  | `name` (문자열, 필수): "서비스와 발신자 이름(예: Oil change - Jane Doe)."  `startDate` (문자열, 필수): "UTC 기준 ISO 8601 형식의 시작 시간(예: 2026-11-04T15:00:00.000Z)."  `endDate` (문자열, 필수): "동일한 형식의 종료 시간입니다. 발신자의 서비스에 더 긴 시간이 필요하지 않다면 시작 시간에서 1시간 후로 설정하세요."  `color` (문자열, 필수): "항상 정확히 `blue` 값으로 설정하세요."  `note` (문자열, 필수): "발신자의 이름, 전화번호, 차량 연식, 제조사 및 모델, 그리고 필요한 서비스." |
| **에이전트에 할당** | **Receptionist**                                                                                                                                                                                                                                                                                                                                         |

**Enable**을 선택하세요.

### 테스트

오일 교환 예약을 하여 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 예약이 올바른 현지 시간으로 Shopmonkey 캘린더에 표시되는지 확인하세요.

`color`는 `aqua`, `black`, `blue`, `brown`, `gray`, `green`, `orange`, `purple`, `red`, `yellow` 중 하나여야 합니다. 팀에서 다른 예약에 사용하지 않는 색상을 사용하면 전화 예약을 쉽게 구분할 수 있습니다.

## 제한 사항

* Shopmonkey의 고객 검색은 전화번호 목록을 받는데, 웹훅 도구는 이를 전송할 수 없습니다. 따라서 리셉셔니스트는 발신자를 조회하거나 예약을 고객 또는 차량 기록에 연결할 수 없습니다. 대신 메모에 발신자 세부 정보를 저장합니다.
* 이 도구로는 예약을 변경하거나 취소할 수 없습니다. 이러한 작업에는 URL에 예약 ID가 필요합니다.

## 문제 해결

| 문제                  | 확인할 사항                                                    |
| ------------------- | --------------------------------------------------------- |
| Shopmonkey에서 401 응답 | 헤더는 `Bearer ` 뒤에 현재 키가 와야 하며, `Bearer` 뒤에 공백이 있어야 합니다.    |
| 예약 시간이 잘못 설정됨       | 시간은 UTC여야 합니다. 올바르게 변환할 수 있도록 리셉셔니스트 지침에 정비소의 시간대를 추가하세요. |
| `color` 관련 400 오류   | Shopmonkey의 색상 이름 중 하나를 소문자로 사용하세요.                       |
| 예약에 고객 세부 정보가 없음    | 설명에서 리셉셔니스트가 먼저 발신자의 이름, 전화번호, 차량 정보를 수집하도록 안내하세요.        |