Method: conversations.messages.updateReceipt

  • The PATCH method is used to send a receipt for a message from an agent to a user.

  • The request URL uses gRPC Transcoding syntax and includes path parameters for receipt.name.

  • The request body contains an instance of Receipt.

  • The response body contains a receipt of the message, including its name and receiptType.

  • Authorization requires the https://www.googleapis.com/auth/businessmessages OAuth scope.

Sends a receipt for a message from an agent to a user.

HTTP request

PATCH https://businessmessages.googleapis.com/v1/{receipt.name=conversations/*/messages/*/receipt}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
receipt.name

string

The name of the receipt, as set by Business Messages. Resolves to "conversations/{conversationId}/messages/{messageId}/receipt", where {conversationId} is the unique ID for the conversation and {messageId} is the unique ID for the message.

Request body

The request body contains an instance of Receipt.

Response body

A receipt of the message.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "name": string,
  "receiptType": enum (ReceiptType)
}
Fields
name

string

The name of the receipt, as set by Business Messages. Resolves to "conversations/{conversationId}/messages/{messageId}/receipt", where {conversationId} is the unique ID for the conversation and {messageId} is the unique ID for the message.
receiptType

enum (ReceiptType)

A receipt type.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.

ReceiptType

Possible receipt types.

Enums
RECEIPT_TYPE_UNSPECIFIED Unspecified receipt type.
READ Message read.