MCP Tools Reference: chatmcp.googleapis.com

Araç: send_message

Markdown biçimlendirmesiyle bir görüşmeye Google Chat mesajı gönderir.

Bu araç, giriş olarak sohbet kimliği, isteğe bağlı 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, send_message MCP aracını çağırmak için curl simgesinin nasıl kullanı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. Biçimlendirme, standart Markdown kullanılarak eklenebilir (tabloların desteklenmediğini unutmayın). Aşağıdaki biçimlendirme desteklenir:

  • Kalın: **text**
  • İtalik: *text* veya _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
  • Sıralı liste:
1. item 1
2. item 2
  • Blok alıntı: > quoted text
  • Köprü: [label](url)
  • Kullanıcıdan bahsetme: data-email="user@example.com" veya data-name="USER_ID" özelliklerine sahip, kendi kendini kapatan bir HTML etiketi chat-user kullanın. Biliniyorsa USER_ID ile data-name özelliğini, aksi takdirde kullanıcı e-postasıyla data-email özelliğini tercih edin. data-name özelliğini kullanıyorsanız ham sayısal USER_ID'yi kullandığınızdan ve diğer araç döndürme değerlerinde görülen users/ önekini eklemediğinizden emin olun. Not: İleti başına en fazla 10 bahsetmeye izin verilir. Tüm kullanıcılardan bahsetmek (ör. @all veya users/all içeren bir HTML etiketi kullanmak) kesinlikle yasaktır.
  • Özel emoji: data-uid="abc" ve data-emoji-name=":xyz:" özelliklerine sahip, kendi kendini kapatan bir HTML etiketi chat-custom-emoji kullanın.

Çıkış Şeması

Google Chat görüşmesine mesaj gönderme 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

Markdown biçimlendirmesi kullanılarak oluşturulan iletinin metin gövdesi.
sender

object (User)

Mesajın 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

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 Gerçek bir kullanıcı.
APP Uygulama kullanıcısı.

Kaynak

Ekin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Ayrılan
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: ✅