ServiceM8 | ElevenLabs Documentation

아래 웹훅 도구를 사용하면 발신자에게 작업이 필요할 때 접수 담당자가 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을 선택한 다음, 견적을 요청하여 접수 담당자를 테스트하세요. 새 견적이 ServiceM8에 표시됩니다.

제한 사항

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

연결된 클라이언트와 작업을 만들려면 Zapier를 통해 ServiceM8의 Create Client 및 Create Job 작업을 사용하세요.

문제 해결

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