Method: phones.dialogflowMessages.create

Dialogflow エージェントに、RCS for Business エージェント経由でメッセージを送信するよう指示します。

RCS for Business エージェントで Dialogflow との統合が有効になっていない場合、このメソッドは 403 PERMISSION_DENIED を返します。

RCS for Business エージェントが Dialogflow エージェントと統合されている場合、このメソッドは Dialogflow エージェントでイベントをトリガーします。RCS for Business プラットフォームは、Dialogflow からのレスポンスをユーザーのデバイスに転送し、ユーザーからのメッセージを Dialogflow エージェントに転送します。

Dialogflow のインテントで複数のレスポンスが定義されている場合、RCS for Business プラットフォームは、定義されたレスポンスごとに 1 つのメッセージをユーザーに送信します。

Dialogflow のフルフィルメントを使用して Webhook に接続する場合、フルフィルメント リクエストのペイロードには次の情報が含まれます。

フィールド 説明

rbm_user_phone_number

 ユーザーの電話番号。

rbm_share_location_response

 ユーザーが位置情報の共有の提案アクションをタップした場合のユーザーの位置情報。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

「phones/{E.164}」。{E.164} はユーザーの電話番号です。

クエリ パラメータ

パラメータ
messageIdPrefix

string

Dialogflow イベントの結果として生成される RCS for Business メッセージ ID の一意の接頭辞。Dialogflow は、特定のイベントに対して複数のレスポンスをサポートしています。イベントが複数のレスポンスをトリガーした場合、RCS for Business は各レスポンスを個別のメッセージとして転送します。各メッセージ ID は同じ接頭辞を共有します。
agentId

string

必須。エージェントの固有識別子。

リクエストの本文

リクエストの本文には DialogflowEvent のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された DialogflowEvent のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、OAuth 2.0 Overview をご覧ください。