Method: projects.conversations.messages.batchCreate

Batch ingests messages to conversation. Customers can use this RPC to ingest historical messages to conversation.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. Resource identifier of the conversation to create message. Format: projects/<Project ID>/locations/<Location ID>/conversations/<Conversation ID>.

Authorization requires the following IAM permission on the specified resource parent:

  • dialogflow.messages.batchCreate

Request body

The request body contains data with the following structure:

JSON representation
  "requests": [
      object (CreateMessageRequest)

object (CreateMessageRequest)

Required. A maximum of 1000 Messages can be created in a batch. [CreateMessageRequest.message.send_time][] is required. All created messages will have identical Message.create_time.

Response body

If successful, the response body contains an instance of BatchCreateMessagesResponse.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.