REST Resource: conversations.messages

{
  "name": string,
  "messageId": string,
  "representative": {
    object (Representative)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ],
  "fallback": string,
  "containsRichText": boolean,

  // Union field content can be only one of the following:
  "text": string,
  "image": {
    object (Image)
  },
  "richCard": {
    object (RichCard)
  }
  // End of list of possible types for union field content.
}

string

Tên của tin nhắn, do Business Messages thiết lập. Phân giải thành "conversations/{conversationId}/messages/{messageId}", trong đó {conversationId} là mã nhận dạng duy nhất của cuộc trò chuyện và {messageId} là mã nhận dạng duy nhất của tin nhắn.

string

Bắt buộc. Mã nhận dạng duy nhất của tin nhắn, do nhân viên hỗ trợ chỉ định. Nếu một thư cố gắng sử dụng cùng một messageId như thư trước, thì việc gửi thư đúng cách có thể bị ảnh hưởng.

object (Representative)

Thông tin chi tiết về người đại diện (người hoặc bot trò chuyện) đã gửi tin nhắn.

object (Suggestion)

Danh sách câu trả lời đề xuất xuất hiện dưới dạng danh sách các khối đề xuất theo tin nhắn liên quan. Tối đa 13 đề xuất.

Các khối này chỉ xuất hiện khi tin nhắn liên quan là tin nhắn gần đây nhất trong cuộc trò chuyện (bao gồm cả tin nhắn của nhân viên hỗ trợ và người dùng). Người dùng có thể nhấn vào một câu trả lời đề xuất để gửi nội dung tin nhắn trả lời đó cho nhân viên hỗ trợ.

string

Không bắt buộc. Văn bản dự phòng sẽ hiển thị nếu thiết bị của người dùng không hỗ trợ loại thông báo hoặc nội dung. Tối đa 3.072 ký tự.

boolean

Không bắt buộc. Nếu là true, cho biết thư chứa văn bản đa dạng thức. Nếu tin nhắn có định dạng không hợp lệ, thì Business Messages sẽ trả về thông báo lỗi.

string

Tin nhắn văn bản. Tối đa 3.072 ký tự.

object (Image)

Tin nhắn hình ảnh.

object (RichCard)

Tin nhắn thẻ thông tin.

{

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

object (ContentInfo)

Thông tin về một hình ảnh, bao gồm cả URL của hình ảnh và URL của hình thu nhỏ của hình ảnh.

{
  "fileUrl": string,
  "thumbnailUrl": string,
  "forceRefresh": boolean,
  "altText": string
}

string

URL có thể truy cập công khai của tệp. Nền tảng này xác định loại MIME của tệp từ trường loại nội dung trong tiêu đề HTTP khi nền tảng tìm nạp tệp. Trường content-type phải hiện diện và chính xác trong phản hồi HTTP từ URL.

Tối đa 5 MB.

Các loại nội dung được hỗ trợ: hình ảnh/jpeg, hình ảnh/jpg, hình ảnh/png, hình ảnh/webp

string

Không bắt buộc. URL có thể truy cập công khai của hình thu nhỏ.

Nếu bạn không cung cấp URL của hình thu nhỏ, nền tảng sẽ hiển thị một hình thu nhỏ phần giữ chỗ trống cho đến khi thiết bị của người dùng tải tệp xuống.

Tối đa 25 KB.

Các loại nội dung được hỗ trợ: hình ảnh/jpeg, hình ảnh/jpg, hình ảnh/png, hình ảnh/webp

boolean

Nếu được đặt, nền tảng sẽ tìm nạp tệp và hình thu nhỏ từ các URL được chỉ định, ngay cả khi nền tảng đã lưu các bản sao của tệp vào bộ nhớ đệm (và/hoặc hình thu nhỏ).

string

Văn bản mô tả chi tiết về nội dung nghe nhìn nhằm mục đích hỗ trợ tiếp cận.

{

  // Union field card can be only one of the following:
  "standaloneCard": {
    object (StandaloneCard)
  },
  "carouselCard": {
    object (CarouselCard)
  }
  // End of list of possible types for union field card.
}

object (StandaloneCard)

Thẻ độc lập.

object (CarouselCard)

Băng chuyền thẻ.

{
  "cardContent": {
    object (CardContent)
  }
}

object (CardContent)

Nội dung thẻ.

{
  "title": string,
  "description": string,
  "media": {
    object (Media)
  },
  "suggestions": [
    {
      object (Suggestion)
    }
  ]
}

string

Không bắt buộc. Tiêu đề thẻ. Tối đa 200 ký tự.

string

Không bắt buộc. Nội dung mô tả thẻ. Tối đa 2.000 ký tự.

object (Media)

Không bắt buộc. Nội dung nghe nhìn để thêm vào thẻ.

object (Suggestion)

Không bắt buộc. Danh sách các đề xuất đưa vào thẻ. Tối đa 4 đề xuất.

{
  "height": enum (Height),

  // Union field content can be only one of the following:
  "contentInfo": {
    object (ContentInfo)
  }
  // End of list of possible types for union field content.
}

enum (Height)

Chiều cao của nội dung đa phương tiện trong thẻ thông tin.

object (ContentInfo)

Thông tin về một tệp, bao gồm cả URL của tệp và URL hình thu nhỏ của tệp.

{

  // Union field option can be only one of the following:
  "reply": {
    object (SuggestedReply)
  },
  "action": {
    object (SuggestedAction)
  },
  "liveAgentRequest": {
    object (LiveAgentRequest)
  },
  "authenticationRequest": {
    object (AuthenticationRequest)
  }
  // End of list of possible types for union field option.
}

object (SuggestedReply)

Đề xuất để người dùng trả lời bằng văn bản được chỉ định.

object (SuggestedAction)

Một hành động đề xuất để bắt đầu một hành động gốc trên thiết bị.

object (LiveAgentRequest)

Yêu cầu mời nhân viên hỗ trợ tham gia cuộc trò chuyện.

object (AuthenticationRequest)

Yêu cầu bắt đầu quy trình xác thực.

{
  "text": string,
  "postbackData": string
}

string

Văn bản xuất hiện trong câu trả lời đề xuất và được gửi tới nhân viên hỗ trợ khi người dùng nhấn vào văn bản đó. Tối đa 25 ký tự.

string

Chuỗi mà nhân viên hỗ trợ nhận được khi người dùng nhấn vào câu trả lời đề xuất. Tối đa 2.048 ký tự.

{
  "text": string,
  "postbackData": string,

  // Union field action can be only one of the following:
  "openUrlAction": {
    object (OpenUrlAction)
  },
  "dialAction": {
    object (DialAction)
  }
  // End of list of possible types for union field action.
}

string

Văn bản xuất hiện trong hành động đề xuất. Tối đa 25 ký tự.

string

Chuỗi mà tác nhân nhận được khi người dùng nhấn vào thao tác được đề xuất. Tối đa 2.048 ký tự.

object (OpenUrlAction)

Mở URL được chỉ định.

object (DialAction)

Mở ứng dụng gọi điện mặc định của người dùng.

{
  "url": string
}

string

URL

{
  "phoneNumber": string
}

string

Bắt buộc. Số điện thoại được chỉ định, ở định dạng RFC 3966. Ví dụ: "+1-201-555-0123".

{

  // Union field authentication_type can be only one of the following:
  "oauth": {
    object (Oauth)
  }
  // End of list of possible types for union field authentication_type.
}

object (Oauth)

Thông tin chi tiết về việc xác thực qua OAuth.

{
  "clientId": string,
  "codeChallenge": string,
  "scopes": [
    string
  ],
  "codeChallengeMethod": string
}

string

Bắt buộc. Mã của ứng dụng yêu cầu uỷ quyền.

string

Bắt buộc. Thử thách mã dùng để trao đổi mã truy cập.

string

Bắt buộc. Một mảng chỉ định phạm vi của yêu cầu.

string

Không bắt buộc. Phương thức thử thách mã dùng để tạo thử thách mã. Nếu tham số này bị bỏ qua, máy chủ sẽ giả định là plain.

{
  "cardWidth": enum (CardWidth),
  "cardContents": [
    {
      object (CardContent)
    }
  ]
}

enum (CardWidth)

Chiều rộng của thẻ trong băng chuyền.

object (CardContent)

Danh sách nội dung của từng thẻ trong băng chuyền. Một băng chuyền có thể có tối thiểu 2 thẻ và tối đa 10 thẻ.