使用Sunshine Conversations passControl API时，如何指定Zendesk Support工单表单？

是可以指定自定义工单表单的，你之前的参数写法方向没错，但可能踩了这几个坑：

• 参数结构要严格对应：正确的参数嵌套应该是dataCapture.systemField.ticket_form_id，请求体示例如下：

{
  "passControl": {
    "dataCapture": {
      "systemField": {
        "ticket_form_id": "123456" // 替换成你的工单表单数字ID
      },
      "ticketField": {
        "subject": "测试工单",
        "description": "来自WhatsApp机器人的工单"
      }
    }
  }
}

• 确认工单表单ID的正确性：别用表单名称，要取Zendesk后台工单表单编辑页面URL里的数字ID，比如页面URL是https://你的账户.zendesk.com/admin/ticket_forms/123456，那123456就是正确ID。

• 检查权限与必填字段：

  • 确保Sunshine用的Zendesk授权账号有编辑工单表单的权限，且该表单对工单所属组可见；
  • 如果自定义表单有必填字段，必须在dataCapture.ticketField里把这些字段都填上，否则API会自动 fallback到标准表单。

• 排查验证步骤：

  1. 调用API后，查看返回的工单数据，确认ticket_form_id是否被正确返回；
  2. 先用Zendesk Core API测试创建工单并指定ticket_form_id，如果能成功，说明问题出在Sunshine API的参数结构或权限上。

内容的提问来源于stack exchange，提问作者Otávio Augusto