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

# ServiceTitan

접수 담당자는 ServiceTitan에서 발신자를 조회하고, 새 작업을 통화 담당자가 검토할 예약으로 전송하며, 기존 고객에게 다음 예약 시간을 알려줄 수 있습니다. ServiceTitan의 API는 클라이언트 ID와 시크릿을 단기 토큰으로 교환하고 앱 키도 필요로 하는데 웹훅 도구에서는 이를 처리할 수 없으므로, Reception은 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 연결됩니다.

## 시작하기 전에

ServiceTitan의 Zapier 연동은 공개 베타 상태이며, ServiceTitan은 이를 있는 그대로 제공합니다. 연결하려면 다음 단계를 따르세요.

1. ServiceTitan 관리자가 ServiceTitan의 Zapier 등록 양식을 제출합니다. ServiceTitan에서 다음 단계에 관해 연락드립니다.
2. ServiceTitan에서 **Settings** → **Integrations** → **API Application Access**로 이동해 **Connect New App**을 선택하고 **Zapier 3.0.X**를 선택하세요.
3. 범위를 검토하고 **Booking Provider** 옵션을 선택한 다음 **Allow Access**를 선택하세요.
4. 클라이언트 시크릿을 생성하고 클라이언트 ID 및 테넌트 ID와 함께 복사하세요.

> **Warning**
>
> 클라이언트 시크릿으로 ServiceTitan 데이터에 액세스할 수 있습니다. 안전하게 보관하고 공유하지 마세요.

## 설정

### Zapier 연결

아직 연결하지 않았다면 Reception.ai에서 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 연결하세요.

### ServiceTitan 작업 추가

[mcp.zapier.com](https://mcp.zapier.com)의 Zapier MCP 서버에서 **ServiceTitan (3.0.X)** 앱의 아래 [작업](#actions)을 추가하세요. 연결하려면 테넌트 ID, 클라이언트 ID, 클라이언트 시크릿을 입력하고 프로덕션 환경을 선택하세요. 각 필드에는 고정 값을 설정하거나, 안내된 대로 AI가 입력하도록 하세요.

### 도구 할당

Reception.ai에서 Zapier 연동의 **도구** 탭을 열고 **도구 새로고침**을 선택한 다음, 각 작업을 **클라이언트**(접수 담당자)에 할당하세요.

### 테스트

수리가 필요한 신규 발신자인 것처럼 [접수 담당자를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 팀에서 검토할 수 있도록 ServiceTitan에 예약이 표시됩니다.

## 작업

### 발신자 찾기

| 필드              | 값                           |
| --------------- | --------------------------- |
| **Zapier 작업**   | **고객 검색**                   |
| **Zapier에서 설정** | 없음.                         |
| **AI가 입력**      | **전화번호**(발신자 번호) 또는 **이름**. |
| **할당 대상**       | **클라이언트**                   |

### 예약 전송

예약은 새 작업을 전송하는 가장 안전한 방법입니다. 통화 담당자가 ServiceTitan에서 이를 검토하고 작업으로 전환하므로, 접수 담당자가 배차 보드에 바로 예약을 넣지 않습니다.

| 필드              | 값                                                                                                    |
| --------------- | ---------------------------------------------------------------------------------------------------- |
| **Zapier 작업**   | **예약 만들기**                                                                                           |
| **Zapier에서 설정** | **예약 제공자**, **소스**(예: `Reception`), 그리고 선택적으로 **사업부**, **작업 유형**, **캠페인**.                           |
| **AI가 입력**      | **이름**, **요약**(문제, 발신자 전화번호, 가능한 시간), **첫 방문 클라이언트 여부**, 서비스 주소, **시작 시간**(발신자가 선호하는 시간), **외부 ID**. |
| **할당 대상**       | **클라이언트**                                                                                            |

**외부 ID**는 예약마다 고유해야 합니다. 접수 담당자가 발신자 전화번호 뒤에 현재 날짜와 시간을 사용하도록 안내하는 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하세요.

### 고객 예약 확인

| 필드              | 값                             |
| --------------- | ----------------------------- |
| **Zapier 작업**   | **예약 검색**                     |
| **Zapier에서 설정** | 없음.                           |
| **AI가 입력**      | **고객 ID**, **고객 검색**에서 가져옵니다. |
| **할당 대상**       | **클라이언트**                     |

## 제한 사항

* Zapier의 ServiceTitan 앱은 수용 가능 인원이나 기술자 가능 여부를 확인할 수 없으므로, 예약 시간은 확정된 시간이 아니라 발신자가 선호하는 시간입니다.
* **작업 만들기**와 **예약 만들기**에는 위치, 사업부, 작업 유형, 캠페인 ID가 필요하며 일정에 바로 예약됩니다. 통화 담당자에게 맡기세요.
* 이 연동은 공개 베타 상태이며 ServiceTitan에서 공식 지원하지 않습니다.
* 접수 담당자가 실행하는 각 작업은 Zapier 플랜의 태스크를 사용합니다. Zapier는 현재 성공한 호출당 태스크 2개를 계산하며, 실패한 호출은 계산하지 않습니다. 플랜 한도가 소진되면 재설정될 때까지 작업이 중지됩니다.

## 문제 해결

| 문제                                     | 확인할 사항                                                     |
| -------------------------------------- | ---------------------------------------------------------- |
| ServiceTitan 작업이 Reception.ai에 표시되지 않음 | Zapier에서 작업을 추가한 후 Zapier 연동에서 **도구 새로고침**을 선택하세요.         |
| 작업에 **변경됨**이 표시되고 사용되지 않음              | Zapier에서 작업을 수정했습니다. **도구** 탭에서 **업데이트**를 선택하세요.           |
| Zapier가 ServiceTitan에 연결할 수 없음         | 등록이 승인되었는지, 이전 API 키가 아닌 3.0.X 클라이언트 ID와 시크릿을 사용했는지 확인하세요. |
| 예약에서 `UniqueConstraint` 오류             | **외부 ID**가 이전 예약과 중복되었습니다. 날짜와 시간이 포함되어 있는지 확인하세요.         |
| 기존 고객을 찾을 수 없음                         | 발신자의 전화번호뿐 아니라 이름으로도 검색해 보세요.                              |