WordPress 表单如何通过 Bearer Token 直连 REST API？

可以选择由 WordPress 服务器发起请求、支持自定义请求头和 JSON 请求体的表单连接器。现有信息还不足以确认 Contact Form to Any API 处理嵌套 JSON 和大量提交是否可靠，也不足以推荐某个替代插件。可以继续把它列为候选，但需要验证实际发出的请求以及失败后的处理方式。

先检查现有表单工具的连接能力

先查看当前安装的 Gravity Forms、Elementor 及其扩展是否提供 Webhook 或 API 请求功能，再确认当前版本和授权范围是否允许：

• 设置 Authorization 等自定义请求头。
• 将表单字段映射为 JSON 对象、数组和不同的数据类型。
• 查看请求结果，处理发送失败的记录。

如果现有工具已经满足需求，就可以少装插件。如果只能发送固定字段或简单键值对，再评估独立连接器。

“无需注册账号”不能证明数据不会经过第三方服务器。需要确认请求是否由 WordPress 服务器发往 CRM，以及插件是否会另外上传表单内容。

验证 Bearer Token 和嵌套 JSON

Bearer Token 通常通过请求头传递，示意如下：

Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

具体认证要求以目标 CRM 的接口说明为准；v2 只是接口版本标识，不能单凭它推断认证方式。

以下 JSON 仅用于说明需要验证的结构，不代表目标 CRM 的实际字段：

{
  "contact": {
    "name": "张三",
    "email": "user@example.com"
  },
  "custom_fields": {
    "lead_source": "website",
    "estimated_budget": 10000
  },
  "tags": ["website", "inquiry"]
}

在连接器中配置映射后，应检查接收端实际收到的原始请求体，确认：

• contact 是对象，没有变成包含 JSON 文本的字符串。
• tags 是数组，没有变成逗号分隔的字符串。
• 数值、布尔值、空字符串和 null 符合 CRM 的字段要求。
• 中文、引号、反斜杠和换行经过编码后仍能正确还原。

配置界面显示 contact.email，不一定意味着最终会生成嵌套对象；它也可能被作为普通字段名发送。应以实际请求为准。

大量提交时，重点检查交付机制

单次请求成功只能说明基本连接可用。大量提交时，还需要检查：

尤其要测试“CRM 已写入数据，但 WordPress 没收到响应”的情况。此时直接重试可能产生重复记录。

如果连接器采用后台队列，还应确认队列如何触发，失败任务能否被发现和重新处理。测试并发量应根据实际提交规模和 CRM 限流设置确定，现有信息不足以得出可靠的吞吐量结论。

如何决定是否继续使用候选插件

对于 Contact Form to Any API，可以先选一个包含嵌套对象、数组和特殊字符的代表性表单，进行实际发送、错误响应和重复提交测试。测试时应使用虚构信息；如需请求检查工具，优先使用自己控制的接收端。

如果它能正确生成请求体、直接连接 CRM，并提供满足业务要求的失败恢复机制，就有了继续评估的基础。如果缺少关键能力，可以按同一标准比较其他连接器，或将公共认证、字段转换和发送逻辑集中到一个可复用的集成层，减少每个表单单独维护 PHP hooks 的工作。

Token 应保存在服务端，排查日志时也应避免记录完整 Token 和不必要的客户信息。最终选择应以当前版本的功能和实际测试结果为依据。

备注：内容仅供参考。