Webhook.site中JSON提取变量映射的注意事项

在使用Webhook.site的Custom Actions功能时，JSON数据提取后的变量映射是一个常见需求。本文详细解析这一过程中的关键要点，帮助开发者避免常见错误。

JSON提取后的变量命名规则

Webhook.site平台在处理JSON提取时，对于数组类型的返回值会添加索引后缀。例如提取contact_id字段时：

• 如果返回值是单个值，变量名为$contact_id$
• 如果返回值是数组，变量名会变为$contact_id.0$（第一个元素）

新旧版本差异

平台存在两种JSON提取方式：

1. 传统Extract JSONPath：直接使用$变量名$格式
2. 新版Extract JSON：对于数组结果会自动添加索引后缀

这种差异容易导致开发者混淆，特别是在升级版本后出现变量映射失效的情况。

最佳实践建议

1. 使用平台提供的变量列表功能确认准确的变量名
2. 对于可能返回数组的字段，在引用时考虑添加.0索引
3. 测试时先输出完整变量列表验证数据结构
4. 在团队文档中明确标注使用的JSON提取方式版本

理解这些细节可以显著提高在Webhook.site中配置自动化流程的效率，减少调试时间。对于复杂JSON结构，建议先在小规模测试中验证变量命名规则，再应用到正式流程中。