ServiceM8 | ElevenLabs Documentation

借助以下 webhook 工具，当来电者需要服务时，接待员可以在 ServiceM8 中创建报价或工作任务，并将新来电者添加为客户。

开始前

在 ServiceM8 中，打开设置 → API 密钥 并创建密钥。以下每个工具都会在 X-Api-Key 请求标头中发送该密钥。持有密钥的人可以读取和更改 ServiceM8 数据，因此请勿将其放入共享文档。

对于每个工具，前往集成，选择 添加集成，选择 Webhook 工具，并将 分配给智能体 设为 接待员。

字段	值
名称	`create_servicem8_job`
描述	”当来电者需要服务或想要报价时，创建工作任务。“
方法	POST
URL	`https://api.servicem8.com/api_1.0/job.json`
请求标头	`X-Api-Key`：API 密钥
正文参数	`status`（字符串，必填）：“始终使用精确值 `Quote`。” `job_address`（字符串，必填）：“需要服务地点的完整地址，包括邮编。” `job_description`（字符串，必填）：“来电者姓名和电话号码，以及所需服务和提供的任何详细信息。”

如果应直接将来电安排为已排期工作，请使用 Work Order 而非 Quote。

字段	值
名称	`create_servicem8_client`
描述	”当来电者表示之前未使用过我们的服务时，将其添加为新客户。“
方法	POST
URL	`https://api.servicem8.com/api_1.0/company.json`
请求标头	`X-Api-Key`：API 密钥
正文参数	`name`（字符串，必填）：“来电者全名或企业名称。” `address`（字符串）：“客户地址，包括邮编。”

为每个工具选择启用，然后通过咨询报价来测试接待员。新报价会显示在 ServiceM8 中。

ServiceM8 对两个工具都仅返回 OK。新记录的 ID 位于接待员无法读取的响应标头中，因此无法将工作任务关联到客户。团队需要在 ServiceM8 中完成关联。
ServiceM8 将电话号码和电子邮件保存在客户联系人中，这是一条独立记录，客户工具无法创建。因此，来电者号码会保留在工作任务描述中。
搜索现有客户需要 $filter 参数，而 webhook 工具参数名称不能包含 $，因此接待员无法查询来电者。

如需创建关联的客户和工作任务，请通过 Zapier 使用 ServiceM8 的 创建客户 和 创建工作任务 操作。

问题	检查内容
ServiceM8 返回 401	标头名称必须是 `X-Api-Key`，且包含有效密钥。
状态相关的 400 错误	`status` 必须精确为 `Quote`、`Work Order`、`Unsuccessful` 或 `Completed`。
工作任务没有地址	确保描述要求接待员在创建工作任务前询问完整地址。
ServiceM8 返回 429	已达到 ServiceM8 的请求限制。等待 1 分钟后重试。