Google Assistant接收用户输入后调用自有服务器webhook并返回响应的实现方法

实现逻辑概述 #

整个流程核心是通过Google官方的Actions平台绑定自定义对话逻辑，配置自动触发webhook回调，完成「用户输入→Google平台转发请求到你的服务器→服务器处理后返回结果→Google Assistant展示结果」的全链路流转。

具体操作步骤 #

• 1. 创建自定义Action
     登录Actions on Google控制台创建新项目，选择「自定义」对话类型，设置对应的调用触发词，比如“打开我的自定义服务”。进入意图配置页，创建捕获用户全量输入的意图，开启该意图的webhook调用权限，配置参数捕获规则为获取用户的完整原始输入内容。
• 2. 绑定自有Webhook接口
     进入项目的Webhook配置页面，填写你自有服务器的公网HTTPS接口地址，注意Google平台仅支持调用HTTPS加密的接口，不允许明文HTTP请求。测试阶段如果无公网服务，可以用内网穿透工具临时映射HTTPS端口供调试使用。
• 3. 适配请求与响应格式
     你需要按照Google平台的规范开发你的服务接口：

  Google平台发送的POST请求为标准JSON格式，用户输入内容存储在请求体的queryResult.queryText字段，你可以直接提取该字段进行业务处理，这里被大于号包裹的内容就是块引用格式的说明。
  处理完成后需要按照规定结构返回响应，示例返回代码如下：

  {
    "fulfillmentText": "接口返回的响应内容",
    "payload": {
      "google": {
        "expectUserResponse": true,
        "richResponse": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "语音播报内容",
                "displayText": "*助理展示*端呈现给用户的文本内容"
              }
            }
          ]
        }
      }
    }
  }
  

  其中displayText字段的内容就是最终会在Google Assistant界面展示给用户的内容，你可以直接把业务处理结果填充到该字段即可。
• 4. 测试验证
     用Actions控制台自带的测试工具输入测试内容，查看请求是否正常触达你的服务接口，返回结果是否符合预期，确认无误后就可以正式发布使用。

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