Method: phones.dialogflowMessages.create

Fordert einen Dialogflow-Agent auf, Nachrichten über einen RCS for Business-Agent zu senden.

Wenn die Dialogflow-Integration für einen RCS for Business-Agent nicht aktiviert ist, wird mit dieser Methode 403 PERMISSION_DENIED zurückgegeben.

Wenn ein RCS for Business-Agent in einen Dialogflow-Agent eingebunden ist, wird mit dieser Methode ein Ereignis im Dialogflow-Agent ausgelöst. Die RCS for Business-Plattform leitet Antworten von Dialogflow an das Gerät des Nutzers und Nachrichten vom Nutzer zurück an den Dialogflow-Agent weiter.

Wenn in einem Dialogflow-Intent mehrere Antworten definiert sind, sendet die RCS for Business-Plattform Nutzern eine Nachricht pro definierter Antwort.

Wenn Sie einen Webhook mit der Auftragsausführung von Dialogflow kontaktieren, enthält die Anfrage zur Auftragsausführung die folgenden Informationen in der Nutzlast:

Feld Beschreibung

rbm_user_phone_number

 Die Telefonnummer des Nutzers.

rbm_share_location_response

 Der Standort des Nutzers, wenn er auf die vorgeschlagene Aktion „Standort teilen“ getippt hat.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

„phones/{E.164}“, wobei {E.164} die Telefonnummer des Nutzers ist.

Abfrageparameter

Parameter
messageIdPrefix

string

Ein eindeutiges Präfix von RCS for Business-Nachrichten-IDs, die aus dem Dialogflow-Ereignis resultieren. Dialogflow unterstützt mehrere Antworten für ein bestimmtes Ereignis. Wenn ein Ereignis mehrere Antworten auslöst, leitet RCS for Business jede Antwort als separate Nachricht weiter. Alle Nachrichten-IDs haben dasselbe Präfix.
agentId

string

Erforderlich. Die eindeutige ID des Agents.

Anfragetext

Der Anfragetext enthält eine Instanz von DialogflowEvent.

Antworttext

Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von DialogflowEvent.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter OAuth 2.0 Overview.