Method: conversations.messages.create

  • Sends a message from an agent to a user within a specific conversation.

  • Returns a PERMISSION DENIED error if the conversation doesn't exist or the agent isn't authorized.

  • Allows sending fallback text instead of the main message content for non-launched agents using the forceFallback query parameter.

  • Requires the https://www.googleapis.com/auth/businessmessages OAuth scope for authorization.

  • Uses the POST method with the URL https://businessmessages.googleapis.com/v1/{parent=conversations/*}/messages to send the message.

Sends a message from an agent to a user. If a conversation doesn't exist or an agent tries to send a message in a conversation that it isn't authorized to participate in, returns a PERMISSION DENIED error.

HTTP request

POST https://businessmessages.googleapis.com/v1/{parent=conversations/*}/messages

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The conversation that contains the message. Resolves to "conversations/{conversationId}".

Query parameters

Parameters
forceFallback

boolean

Optional. A flag to send the specified fallback text instead of other message content. Only available to agents that aren't launched.

If the flag is true and fallback text isn't specified, Business Messages returns an error.

Request body

The request body contains an instance of Message.

Response body

If successful, the response body contains a newly created instance of Message.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.