Method: phones.dialogflowMessages.create

提示 Dialogflow 代理通过 RCS Business Messaging 代理发送消息。

如果未为 RCS for Business 代理启用 Dialogflow 集成,此方法会返回 403 PERMISSION_DENIED

当 RCS for Business 代理与 Dialogflow 代理集成时,此方法会在 Dialogflow 代理中触发事件。RCS Business Messaging 平台将 Dialogflow 的响应路由到用户设备,并将用户发送的消息路由回 Dialogflow 代理。

如果 Dialogflow intent 定义了多个响应,RCS 商务平台会针对每个定义的响应向用户发送一条消息。

如果您通过 Dialogflow fulfillment 联系网络钩子,fulfillment 请求会在载荷中包含以下信息:

字段 说明

rbm_user_phone_number

用户的电话号码。

rbm_share_location_response

用户的位置信息(如果用户点按了“分享位置信息”建议操作)。

HTTP 请求

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/dialogflowMessages

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

“phones/{E.164}”,其中 {E.164} 是用户的电话号码

查询参数

参数
messageIdPrefix

string

由 Dialogflow 事件生成的 RCS 商务消息 ID 的唯一前缀。Dialogflow 支持为指定事件提供多种响应。如果某个事件触发了多条响应,RCS 商家私信会转发每条响应,并将其作为单独的消息发送。每个消息 ID 共享相同的前缀。

agentId

string

必需。代理的唯一标识符。

请求正文

请求正文包含一个 DialogflowEvent 实例。

响应正文

如果成功,响应正文将包含一个新创建的 DialogflowEvent 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

如需了解详情,请参阅 OAuth 2.0 Overview