MCP Tools Reference: chatmcp.googleapis.com

Công cụ: send_message

Gửi tin nhắn trò chuyện Google Chat đến một cuộc trò chuyện có định dạng Markdown.

Công cụ này sử dụng mã nhận dạng cuộc trò chuyện, mã nhận dạng luồng không bắt buộc và văn bản tin nhắn làm dữ liệu đầu vào.

Bạn có thể tìm thấy mã nhận dạng cuộc trò chuyện bằng công cụ search_conversations.

Phương thức này trả về thông báo đã tạo.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ send_message MCP.

Yêu cầu Curl 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "send_message",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

SendMessageRequest

Biểu diễn dưới dạng JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Trường
conversationId

string

Bắt buộc. Mã nhận dạng của cuộc trò chuyện (ví dụ: "spaces/AAAA...") để gửi tin nhắn đến.
threadId

string

Không bắt buộc. Mã nhận dạng của chuỗi (ví dụ: "spaces/AAAA.../threads/BBBB...") để gửi tin nhắn đến. Nếu bạn không đặt giá trị này, thì thư sẽ được gửi đến một chuỗi thư mới.
messageText

string

Bắt buộc. Nội dung chính của thông báo. Bạn có thể thêm định dạng bằng cách sử dụng Markdown tiêu chuẩn (xin lưu ý rằng bảng KHÔNG được hỗ trợ). Bạn có thể sử dụng các định dạng sau:

  • In đậm: **text**
  • In nghiêng: *text* hoặc _text_
  • Gạch ngang chữ: ~~text~~
  • Monospace: text
  • Khối đơn cách:
```
line 1
line 2
```
  • Danh sách có dấu đầu dòng:
* item 1
* item 2
  • Danh sách có thứ tự:
1. item 1
2. item 2
  • Khối trích dẫn: > quoted text
  • Siêu liên kết: [label](url)
  • Đề cập đến người dùng: Sử dụng thẻ HTML tự đóng chat-user có thuộc tính data-email="user@example.com" hoặc data-user="users/USER_ID". Ưu tiên thuộc tính data-user có USER_ID nếu đã biết và quay lại thuộc tính data-email có email của người dùng nếu không. Nếu bạn sử dụng thuộc tính data-user, hãy nhớ thêm tiền tố users/ xuất hiện trong các giá trị trả về của công cụ khác. Lưu ý: Mỗi tin nhắn được phép có tối đa 10 lượt đề cập. Chúng tôi hoàn toàn nghiêm cấm việc đề cập đến tất cả người dùng (ví dụ: sử dụng @all hoặc thẻ HTML có users/all).
  • Biểu tượng cảm xúc tuỳ chỉnh: Sử dụng thẻ HTML tự đóng chat-emoji có thuộc tính data-custom-emoji="customEmojis/abc" hoặc data-emoji-name=":xyz:".

Giản đồ đầu ra

Phản hồi khi gửi tin nhắn đến một cuộc trò chuyện trên Google Chat.

SendMessageResponse

Biểu diễn dưới dạng JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Trường
message

object (ChatMessage)

Tin nhắn đã được gửi.

ChatMessage

Biểu diễn dưới dạng JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Trường
messageId

string

Tên tài nguyên của thông báo. Định dạng: spaces/{space}/messages/{message}
threadId

string

মহিলা ও শিশু বিষয়ক মন্ত্রণালয় Tham số này sẽ trống nếu tin nhắn không được phân luồng. Định dạng: spaces/{space}/threads/{thread}
plaintextBody

string

Nội dung văn bản của thông báo bằng cách sử dụng định dạng Markdown.
sender

object (User)

Người gửi tin nhắn.
createTime

string

Chỉ có đầu ra. Dấu thời gian cho biết thời điểm tạo thông báo.
threadedReply

boolean

Tin nhắn có phải là tin nhắn trả lời trong một chuỗi hay không.
attachments[]

object (ChatAttachmentMetadata)

Tệp đính kèm có trong thư.
reactionSummaries[]

object (ReactionSummary)

Bản tóm tắt về các lượt thể hiện cảm xúc bằng biểu tượng trong tin nhắn.

Người dùng

Biểu diễn dưới dạng JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Trường
userId

string

Tên tài nguyên của một người dùng Chat. Định dạng: users/{user}.
displayName

string

Tên hiển thị của người dùng Chat.
email

string

Địa chỉ email của người dùng. Trường này chỉ được điền sẵn khi loại người dùng là HUMAN.
userType

enum (UserType)

Loại người dùng.

ChatAttachmentMetadata

Biểu diễn dưới dạng JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Trường
attachmentId

string

Tên tài nguyên của tệp đính kèm. Định dạng: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Tên của tệp đính kèm.
mimeType

string

Loại nội dung (loại MIME).
source

enum (Source)

Nguồn của tệp đính kèm.

ReactionSummary

Biểu diễn dưới dạng JSON 
{
  "emoji": string,
  "count": integer
}
Trường
emoji

string

Chuỗi unicode biểu tượng cảm xúc hoặc tên biểu tượng cảm xúc tuỳ chỉnh.
count

integer

Tổng số lượt thể hiện cảm xúc bằng biểu tượng cảm xúc liên quan.

UserType

Loại người dùng Google Chat.

Enum
USER_TYPE_UNSPECIFIED Không xác định.
HUMAN Người dùng thực.
APP Người dùng ứng dụng.

Nguồn

Nguồn của tệp đính kèm.

Enum
SOURCE_UNSPECIFIED Đã đặt trước.
DRIVE_FILE Tệp này là tệp trên Google Drive.
UPLOADED_CONTENT plaza.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ này có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý thế giới mở: ✅

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create