MCP Tools Reference: chatmcp.googleapis.com

Alat: send_message

Mengirim pesan Google Chat ke percakapan dengan pemformatan Markdown.

Alat ini menggunakan ID percakapan, ID rangkaian pesan opsional, dan teks pesan sebagai input.

ID percakapan dapat ditemukan menggunakan alat search_conversations.

Fungsi ini menampilkan pesan yang dibuat.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP send_message.

Permintaan 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
}'

Skema Input

SendMessageRequest

Representasi JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Kolom
conversationId

string

Wajib. ID percakapan (misalnya, 'spaces/AAAA...') yang akan dikirimi pesan.
threadId

string

Opsional. ID rangkaian pesan (misalnya, 'spaces/AAAA.../threads/BBBB...') tujuan pengiriman pesan. Jika tidak disetel, pesan akan dikirim ke rangkaian pesan baru.
messageText

string

Wajib. Konten utama pesan. Pemformatan dapat ditambahkan menggunakan Markdown standar (perhatikan bahwa tabel TIDAK didukung). Format berikut didukung:

  • Tebal: **text**
  • Miring: *text* atau _text_
  • Coret: ~~text~~
  • Monospace: text
  • Blok monospace:
```
line 1
line 2
```
  • Daftar berbutir:
* item 1
* item 2
  • Daftar berurutan:
1. item 1
2. item 2
  • Kutipan panjang: > quoted text
  • Hyperlink: [label](url)
  • Menyebutkan pengguna: Gunakan tag HTML yang menutup sendiri chat-user dengan atribut data-email="user@example.com" atau data-user="users/USER_ID". Lebih memilih atribut data-user dengan USER_ID jika diketahui dan beralih ke atribut data-email dengan email pengguna jika tidak. Jika Anda menggunakan atribut data-user, pastikan untuk menyertakan awalan users/ yang terlihat di nilai yang ditampilkan alat lainnya. Catatan: Maksimum 10 sebutan yang diizinkan per pesan. Menyebutkan semua pengguna (misalnya, menggunakan @all atau tag HTML dengan users/all) sangat dilarang.
  • Aware Emoji kustom: Gunakan tag HTML yang menutup sendiri chat-emoji dengan atribut data-custom-emoji="customEmojis/abc" atau data-emoji-name=":xyz:".

Skema Output

Respons untuk mengirim pesan ke percakapan Google Chat.

SendMessageResponse

Representasi JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Kolom
message

object (ChatMessage)

Pesan yang dikirim.

ChatMessage

Representasi JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Kolom
messageId

string

Nama resource pesan. Format: spaces/{space}/messages/{message}
threadId

string

Rangkaian pesan yang menyertakan pesan ini. Kolom ini akan kosong jika pesan tidak dikelompokkan dalam rangkaian pesan. Format: spaces/{space}/threads/{thread}
plaintextBody

string

Isi teks pesan menggunakan pemformatan Markdown.
sender

object (User)

Pengirim pesan.
createTime

string

Hanya output. Stempel waktu saat pesan dibuat.
threadedReply

boolean

Apakah pesan adalah balasan rangkaian pesan.
attachments[]

object (ChatAttachmentMetadata)

Lampiran disertakan dalam pesan.
reactionSummaries[]

object (ReactionSummary)

Ringkasan reaksi emoji yang disertakan dalam pesan.

Pengguna

Representasi JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Kolom
userId

string

CWL pengguna Chat. Format: users/{user}.
displayName

string

Aware of the display name of a Chat user.
email

string

Alamat email pengguna. Kolom ini hanya diisi jika jenis pengguna adalah HUMAN.
userType

enum (UserType)

Jenis pengguna.

ChatAttachmentMetadata

Representasi JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Kolom
attachmentId

string

Nama resource lampiran. Format: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nama lampiran.
mimeType

string

Jenis konten (jenis MIME).
source

enum (Source)

Sumber lampiran.

ReactionSummary

Representasi JSON 
{
  "emoji": string,
  "count": integer
}
Kolom
emoji

string

String unicode emoji atau nama emoji kustom.
count

integer

Jumlah total reaksi menggunakan emoji terkait.

UserType

Jenis pengguna Google Chat.

Enum
USER_TYPE_UNSPECIFIED Tidak ditentukan.
HUMAN Pengguna manusia.
APP Pengguna aplikasi.

Sumber

Sumber lampiran.

Enum
SOURCE_UNSPECIFIED Dipesan.
DRIVE_FILE File adalah file Google Drive.
UPLOADED_CONTENT File diupload ke Chat.

स्फोटीकरण (Tool Annotations)

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim ke pengguna.

Selain string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ✅

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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