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

# ServiceM8

아래 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 발신자에게 작업이 필요할 때 접수 담당자가 ServiceM8에서 견적 또는 작업을 만들고, 새 발신자를 클라이언트로 추가할 수 있습니다.

## 시작하기 전에

ServiceM8에서 **Settings** → **API Keys**를 열고 키를 만드세요. 아래의 모든 도구는 이를 `X-Api-Key` 요청 헤더로 전송합니다. 키를 가진 사람은 누구나 ServiceM8 데이터를 읽고 변경할 수 있으므로 공유 문서에 넣지 마세요.

## 도구 만들기

각 도구에서 **Integrations**로 이동해 **Add integration**을 선택하고, **Webhook Tool**을 선택한 다음 **Assign to agents**를 **Receptionist**로 설정하세요.

### 작업 만들기

| 필드          | 값                                                                                                                                                                                                           |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이름**      | `create_servicem8_job`                                                                                                                                                                                      |
| **설명**      | "발신자에게 작업이 필요하거나 견적을 원할 때 작업을 만듭니다."                                                                                                                                                                        |
| **메서드**     | POST                                                                                                                                                                                                        |
| **URL**     | `https://api.servicem8.com/api_1.0/job.json`                                                                                                                                                                |
| **요청 헤더**   | `X-Api-Key`: API 키                                                                                                                                                                                          |
| **본문 파라미터** | `status` (string, required): "항상 정확히 `Quote` 값으로 설정합니다."  `job_address` (string, required): "우편번호를 포함해 작업이 필요한 전체 주소입니다."  `job_description` (string, required): "발신자의 이름과 전화번호, 그리고 필요한 작업과 제공한 세부 정보입니다." |

통화가 바로 일정이 잡힌 작업으로 연결되어야 한다면 `Quote` 대신 `Work Order`를 사용하세요.

### 새 클라이언트 추가

| 필드          | 값                                                                                                |
| ----------- | ------------------------------------------------------------------------------------------------ |
| **이름**      | `create_servicem8_client`                                                                        |
| **설명**      | "발신자가 이전에 서비스를 이용한 적이 없다고 말하면 새 클라이언트로 추가합니다."                                                   |
| **메서드**     | POST                                                                                             |
| **URL**     | `https://api.servicem8.com/api_1.0/company.json`                                                 |
| **요청 헤더**   | `X-Api-Key`: API 키                                                                               |
| **본문 파라미터** | `name` (string, required): "발신자의 전체 이름 또는 업체명입니다."  `address` (string): "우편번호를 포함한 클라이언트 주소입니다." |

각 도구에서 **Enable**을 선택한 다음, 견적을 요청하여 [접수 담당자를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 새 견적이 ServiceM8에 표시됩니다.

## 제한 사항

* ServiceM8는 두 도구 모두에 `OK`만 응답합니다. 새 레코드의 ID는 접수 담당자가 읽을 수 없는 응답 헤더에 있으므로, 작업을 클라이언트에 연결할 수 없습니다. 팀에서 ServiceM8 내에서 연결해야 합니다.
* ServiceM8는 전화번호와 이메일을 클라이언트의 연락처에 저장합니다. 이는 클라이언트 도구로 만들 수 없는 별도 레코드입니다. 대신 작업 설명에 발신자 번호가 저장됩니다.
* 기존 클라이언트를 검색하려면 `$filter` 파라미터가 필요하지만 웹훅 도구 파라미터 이름에는 `$`를 포함할 수 없으므로, 접수 담당자가 발신자를 조회할 수 없습니다.

연결된 클라이언트와 작업을 만들려면 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 ServiceM8의 **Create Client** 및 **Create Job** 작업을 사용하세요.

## 문제 해결

| 문제                 | 확인할 사항                                                                       |
| ------------------ | ---------------------------------------------------------------------------- |
| ServiceM8에서 401 반환 | 헤더 이름이 `X-Api-Key`이고 현재 유효한 키가 포함되어야 합니다.                                    |
| 상태 관련 400 오류       | `status`는 정확히 `Quote`, `Work Order`, `Unsuccessful`, `Completed` 중 하나여야 합니다. |
| 작업에 주소가 없음         | 작업을 만들기 전에 접수 담당자가 전체 주소를 묻도록 설명에 명시하세요.                                     |
| ServiceM8에서 429 반환 | ServiceM8의 요청 한도에 도달했습니다. 1분 후 다시 시도하세요.                                     |