Google Actions Builder .NET Webhook报ExecuteHttpResponse错误求助
Google Assistant Webhook解析失败排查方案
直接触发
Invalid response from webhook: Failed to translate JSON to ExecuteHttpResponse错误的核心原因有三类,逐一修正即可解决:- 字段命名规则不匹配
.NET默认序列化输出的JSON字段为PascalCase(首字母大写的大驼峰格式),但Actions Builder的Webhook服务严格要求所有接口字段使用camelCase(首字母小写的小驼峰格式),字段名不匹配时服务端无法识别对应属性,直接判定结构非法。 - 响应外层多余嵌套
当前Webhook返回内容额外在最外层包裹了responseJson节点,将真正的响应对象塞到了该节点下。接口要求直接返回符合Fulfillment规范的响应JSON,无需额外的外层包装。 - Prompt结构不符合规范
当前的Prompt节点直接在根级放置了Override和FirstSimple字段,不符合接口结构要求——Prompt下必须通过items数组承载回复内容,简单文本回复是数组内的子项,不能和override属性平级。
- 字段命名规则不匹配
修正后的标准响应JSON参考:
{ "session": { "id": "ABwppHFkFuGBF-UawPmIkxWpkfM1Hb5An7h8KnjR302zukmBoKA1NqDp7DfePGzYsyxT5oy--wg5Jkjj", "params": { "Phone": 1234562869, "Zip": 37122, "FName": "john doe" } }, "prompt": { "override": false, "items": [ { "simpleResponse": { "speech": "My webhook response", "text": "My response from webhook" } } ] }, "scene": { "name": "Start", "slotFillingStatus": "FINAL", "slots": { "Phone": { "mode": "REQUIRED", "status": "SLOT_UNSPECIFIED", "updated": true, "value": 1234562869 }, "FName": { "mode": "REQUIRED", "status": "SLOT_UNSPECIFIED", "updated": false, "value": "john doe" }, "Zip": { "mode": "REQUIRED", "status": "SLOT_UNSPECIFIED", "updated": false, "value": 37122 } }, "next": { "name": "actions.scene.END_CONVERSATION" } } }
- .NET端适配要点:
- 配置JSON序列化规则时,将输出属性名统一转换为camelCase:如果使用内置的System.Text.Json,设置
JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;如果使用Newtonsoft.Json,设置ContractResolver = new CamelCasePropertyNamesContractResolver()即可自动适配字段命名要求。 - 移除响应最外层额外的包装节点,直接输出规范的响应对象。
- 严格按照接口结构定义实体类,不要遗漏Prompt下的
items数组层级。
- 配置JSON序列化规则时,将输出属性名统一转换为camelCase:如果使用内置的System.Text.Json,设置
内容的提问来源于stack exchange,提问作者Dileep John
相关产品推荐
相关产品推荐

