如何调用ServiceM8 JobContact API获取客户邮箱对接Zoho CRM？

一、正确的ServiceM8 JobContact API端点与参数 #

获取作业关联的客户邮箱，核心用JobContact相关接口：

• 核心端点：GET /api_1.0/jobcontact.json
• 必填参数：
  • job_uuid：从作业创建/更新的Webhook payload中直接提取作业唯一UUID
• 可选参数：
  • contact_uuid：指定单个联系人UUID查询；不传则返回该作业下所有关联联系人
• 请求头要求：
  • 必须携带授权头：Authorization: Basic [你的ServiceM8账号邮箱:密码的Base64编码值]

示例curl请求：

curl -X GET "https://api.servicem8.com/api_1.0/jobcontact.json?job_uuid=YOUR_JOB_UUID" \
  -H "Authorization: Basic YOUR_BASE64_ENCODED_CREDENTIALS"

响应结果里的联系人对象会包含email字段，这就是你需要的客户邮箱。

二、常见调用错误排查 #

1. 401 Unauthorized：
   • 检查Base64编码格式：必须是邮箱:密码的组合后再编码，而非单独编码密码
   • 确认ServiceM8后台已开启API访问权限，且账号密码未过期
2. 404 Not Found：
   • 核对job_uuid的大小写与正确性，UUID区分大小写
   • 检查端点路径拼写，确保是jobcontact.json而非其他变体
3. 返回空数组：
   • 该作业未关联任何联系人，需在ServiceM8后台确认作业已绑定客户后再测试

三、对接Zoho CRM的后续流程 #

拿到客户邮箱后：

• 调用Zoho CRM的联系人搜索接口，用email:客户邮箱作为条件判断客户是否存在
• 存在则调用更新接口修改备注；不存在则先创建客户，再添加备注
• 注意Zoho CRM需配置对应授权（OAuth2或API密钥），并在请求头中携带认证信息

内容的提问来源于stack exchange，提问作者Cabal