Shopmonkey | ElevenLabs Documentation

웹훅 도구를 사용하면 발신자가 차량을 입고하고 싶을 때 리셉셔니스트가 Shopmonkey 캘린더에 예약을 추가할 수 있습니다.

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을 선택하세요.

테스트

오일 교환 예약을 하여 리셉셔니스트를 테스트하세요. 예약이 올바른 현지 시간으로 Shopmonkey 캘린더에 표시되는지 확인하세요.

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

제한 사항

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

문제 해결

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