如何在Power Automate中为DocuSign正确配置下拉列表标签（List Tab）

我有一个Power Automate流，可通过Microsoft Word文档创建DocuSign信封，步骤类似DocuSign官方博客所述。该流使用「为信封收件人添加标签」任务，将Word文档中的多个锚点字符串替换为DocuSign标签，预定义标签类型（如文本框）能正常使用。但尝试创建下拉列表标签（List Tab）时，因该类型未预定义，我输入了自定义值，测试时出现错误：

输出体：

"body": {
        "errorCode": "INVALID_REQUEST_BODY",
        "message": "The request body is missing or improperly formatted. No tabs specified."
    }
}

我的任务输入为：

{
  "accountId": "448859da---------",
  "envelopeId": "f165e375--------",
  "recipientId": "50887345",
  "tabType": "List",
  "tabDetails/tabs": [
    {
      "tabLabel": "ListTab",
      "anchorString": "/Department/",
      "Items": [
        {
          "text": "HR",
          "value": "HR"
        },
        {
          "text": "ICT",
          "value": "ICT"
        },
        {
          "text": "Logistics",
          "value": "Logistics"
        }
      ]
    }
  ]
}

方案一：修正「为信封收件人添加标签」任务的输入格式 #

该预定义任务的参数结构需匹配DocuSign API规范，调整以下几点即可解决错误：

• 字段名改为驼峰式，Items替换为listItems
• 将tabDetails/tabs从数组改为对象，内部用listTabs数组存放下拉列表标签（API要求的标准结构）
• 补充documentId（默认值为1，对应上传的Word文档）

修正后的输入示例：

{
  "accountId": "448859da---------",
  "envelopeId": "f165e375--------",
  "recipientId": "50887345",
  "tabType": "List",
  "tabDetails/tabs": {
    "listTabs": [
      {
        "tabLabel": "ListTab",
        "anchorString": "/Department/",
        "documentId": "1",
        "recipientId": "50887345",
        "listItems": [
          {
            "text": "HR",
            "value": "HR"
          },
          {
            "text": "ICT",
            "value": "ICT"
          },
          {
            "text": "Logistics",
            "value": "Logistics"
          }
        ]
      }
    ]
  }
}

方案二：用HTTP任务直接调用DocuSign API #

如果预定义任务仍无法满足需求，可直接调用DocuSign REST API实现：

1. 添加「HTTP」动作，配置参数：
   • 方法：PUT
   • URI：https://demo.docusign.net/restapi/v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs（替换占位符为实际值）
2. 配置请求头：
   • Authorization: Bearer {accessToken}（通过DocuSign连接器获取OAuth令牌，需确保令牌有envelopes:edit权限）
   • Content-Type: application/json
3. 请求体使用标准API格式：

{
  "listTabs": [
    {
      "tabLabel": "ListTab",
      "anchorString": "/Department/",
      "documentId": "1",
      "recipientId": "50887345",
      "listItems": [
        {
          "text": "HR",
          "value": "HR"
        },
        {
          "text": "ICT",
          "value": "ICT"
        },
        {
          "text": "Logistics",
          "value": "Logistics"
        }
      ]
    }
  ]
}

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