MCP Tools Reference: chatmcp.googleapis.com

Araç: send_message

Bir görüşmeye Google Chat mesajı gönderir.

Bu araç, giriş olarak bir sohbet kimliği, isteğe bağlı bir ileti dizisi kimliği ve ileti metni kullanır. Görüşme kimlikleri, search_conversations aracı kullanılarak bulunabilir. Oluşturulan mesajı döndürür.

Aşağıdaki örnekte, curl kullanılarak send_message MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--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 tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

Google Chat görüşmesine mesaj gönderme isteği.

SendMessageRequest

JSON gösterimi 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Alanlar
conversationId

string

Zorunlu. Mesajın gönderileceği görüşmenin kimliği (ör. "spaces/AAAA...").
threadId

string

İsteğe bağlı. İletinin gönderileceği ileti dizisinin kimliği (ör. "spaces/AAAA.../threads/BBBB..."). Ayarlanmazsa ileti yeni bir ileti dizisine gönderilir.
messageText

string

Zorunlu. İletinin ana içeriği. Temel biçimlendirme, Markdown'ın bir alt kümesi kullanılarak eklenebilir. İletileri biçimlendirme hakkında bilgi edinmek için İletileri biçimlendirme başlıklı makaleyi inceleyin. Aşağıdaki biçimlendirme desteklenir:

  • Kalın: *text*
  • İtalik: _text_
  • Üstü çizili: ~text~
  • Tek aralıklı: text
  • Tek aralıklı yazı tipi bloğu:
```
line 1
line 2
```
  • Madde işaretli liste:
* item 1
* item 2
  • Blok alıntı: > quoted text
  • Köprü: <url|display text>
  • Kullanıcıdan bahsetme: <users/{user_id}>

Çıkış şeması

Google Chat görüşmesine mesaj göndermeye verilen yanıt.

SendMessageResponse

JSON gösterimi 
{
  "message": {
    object (ChatMessage)
  }
}
Alanlar
message

object (ChatMessage)

Gönderilen mesaj.

ChatMessage

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

string

İletinin kaynak adı. Biçim: spaces/{space}/messages/{message}
threadId

string

Bu iletinin ait olduğu ileti dizisi. İleti işlenmemişse bu alan boş olur. Biçim: spaces/{space}/threads/{thread}
plaintextBody

string

İletinin düz metin gövdesi.
sender

object (User)

İletinin göndereni.
createTime

string

Yalnızca çıkış. İletinin oluşturulduğu zaman damgası.
threadedReply

boolean

İletinin ileti dizisi yanıtı olup olmadığı.
attachments[]

object (ChatAttachmentMetadata)

İletiye eklenen dosyalar.
reactionSummaries[]

object (ReactionSummary)

Mesaja eklenen emoji tepkilerinin özeti.

Kullanıcı

JSON gösterimi 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Alanlar
userId

string

Chat kullanıcısının kaynak adı. Biçim: users/{user}.
displayName

string

Bir Chat kullanıcısının görünen adı.
email

string

Kullanıcının e-posta adresi. Bu alan yalnızca kullanıcı türü HUMAN olduğunda doldurulur.
userType

enum (UserType)

Kullanıcının türü.

ChatAttachmentMetadata

JSON gösterimi 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Alanlar
attachmentId

string

Ekin kaynak adı. Biçim: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Ekin adı.
mimeType

string

İçerik türü (MIME türü).
source

enum (Source)

Ekin kaynağı.

ReactionSummary

JSON gösterimi 
{
  "emoji": string,
  "count": integer
}
Alanlar
emoji

string

Emoji Unicode dizesi veya özel emoji adı.
count

integer

İlişkili emoji kullanılarak verilen toplam tepki sayısı.

UserType

Google Chat kullanıcısının türü.

Sıralamalar
USER_TYPE_UNSPECIFIED Belirtilmedi.
HUMAN İnsan kullanıcı.
APP Uygulama kullanıcısı.

Kaynak

Ekin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Rezervasyon yapıldı.
DRIVE_FILE Dosya, Google Drive dosyasıdır.
UPLOADED_CONTENT Dosya Chat'e yüklenir.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ❌ | Salt Okunur İpucu: ❌ | Açık Dünya İpucu: ✅