使用 ServiceM8 REST API 发送邮件时返回 200 OK 且收件人正常接收，但邮件未出现在目标工单（Job）的日记中——根本原因在于参数命名错误：job_uuid 无效，必须改用 regardingJobUUID 字段并确保其值为合法 UUID 格式。
使用 servicem8 rest api 发送邮件时返回 200 ok 且收件人正常接收，但邮件未出现在目标工单（job）的日记中——根本原因在于参数命名错误：`job_uuid` 无效，必须改用 `regardingjobuuid` 字段并确保其值为合法 uuid 格式。
在 ServiceM8 平台中，通过 /platform_service_email 端点发送的外发邮件若需自动归档至特定工单的「日记（Job Diary）」，必须显式声明该邮件与工单的上下文关联关系。官方 API 文档已明确要求使用字段 regardingJobUUID（而非 job_uuid、job_id 或其他变体），且该字段为可选但关联必需项——仅当提供有效值时，系统才会将邮件条目写入对应工单的日记流。
✅ 正确请求示例（关键修正部分已高亮）：
{
"to": "client@example.com",
"from": "admin@company.com",
"subject": "It works",
"message": "This message confirms Email was sent correctly",
"htmlBody": "<p>This message confirms Email was sent correctly</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill9722" title="plan-hvac-service-company-local-seo-faq-cluster"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="plan-hvac-service-company-local-seo-faq-cluster" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill9722" title="plan-hvac-service-company-local-seo-faq-cluster">plan-hvac-service-company-local-seo-faq-cluster</a>
<p>调研本地问题，聚类分组，为暖通空调公司撰写可直接发布的FAQ，适用于本地SEO工作。</p>
</div>
<a href="/xiazai/skill9722" title="plan-hvac-service-company-local-seo-faq-cluster" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>",
"textBody": "This message confirms Email was sent correctly",
"regardingJobUUID": "7c950fdd-7cbf-4b87-ad9b-2294227485db"
}⚠️ 注意事项：
-
regardingJobUUID值必须为 完整、带连字符的 UUID 字符串（如xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx），大小写不敏感，但格式错误（如缺失连字符、长度不符、含非法字符）将导致关联静默失败； - 该字段不可与
template_uuid混用替代：模板仅控制内容渲染，不承载上下文绑定逻辑； - 身份认证方式（Basic Auth 用户名/密码）本身不影响日记关联，只要认证通过即可调用 API；但建议生产环境迁移到 OAuth 2.0 访问令牌以符合安全最佳实践；
- 若仍不显示，请检查目标工单状态：已归档（Archived）或已删除（Deleted）的工单不接受新日记条目，API 不会报错但会忽略
regardingJobUUID。
? 验证步骤建议：
- 使用
GET /job/{uuid}接口确认工单存在且status为active； - 在请求中临时移除
template_uuid，排除模板逻辑干扰； - 使用
curl -v或 Postman 查看响应头中的X-ServiceM8-Request-ID，便于向 ServiceM8 支持团队提交精准排查日志。
简言之：不是“邮件没发出去”，而是“邮件没说清楚它属于谁”。只需将 job_uuid 替换为语义准确、文档合规的 regardingJobUUID，即可让每封 API 邮件精准落位至业务工单日记，实现流程闭环与审计可追溯。
