MCP Tools Reference: chatmcp.googleapis.com

ابزار: send_message

یک پیام گوگل چت را به مکالمه‌ای با قالب‌بندی Markdown ارسال می‌کند.

این ابزار از یک شناسه مکالمه، یک شناسه رشته (که اختیاری است) و یک متن پیام به عنوان ورودی استفاده می‌کند. شناسه‌های مکالمه را می‌توان با استفاده از ابزار search_conversations پیدا کرد. این ابزار پیام ایجاد شده را برمی‌گرداند.

نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار send_message MCP را نشان می‌دهد.

درخواست کرل 
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
}'

طرحواره ورودی

درخواست ارسال پیام به مکالمه گوگل چت.

ارسال درخواست پیام

نمایش JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
فیلدها
conversationId

string

الزامی. شناسه مکالمه (مثلاً 'فاصله/AAAA...') برای ارسال پیام.

threadId

string

اختیاری. شناسه‌ی رشته (مثلاً 'spaces/AAAA.../threads/BBBB...') که پیام به آن ارسال می‌شود. اگر تنظیم نشود، پیام به یک رشته‌ی جدید ارسال خواهد شد.

messageText

string

الزامی. محتوای اصلی پیام. قالب‌بندی را می‌توان با استفاده از Markdown استاندارد اضافه کرد (توجه داشته باشید که جداول پشتیبانی نمی‌شوند). قالب‌بندی زیر پشتیبانی می‌شود:

  • پررنگ: **text**
  • ایتالیک: *text* یا _text_
  • خط خورده: ~~text~~
  • تک‌فاصله: text
  • بلوک تک‌فضا: 
```
line 1
line 2
```
  • لیست گلوله‌ای: 
* item 1
* item 2
  • لیست سفارش داده شده: 
1. item 1
2. item 2
  • نقل قول بلوک: > quoted text
  • هایپرلینک: [label](url)
  • ذکر کاربر: از یک تگ HTML خود-بسته chat-user با ویژگی‌های data-email="user@example.com" یا data-name="USER_ID" استفاده کنید. در صورت شناخته شدن، ویژگی data-name را با USER_ID ترجیح دهید و در غیر این صورت از ویژگی data-email با ایمیل کاربر استفاده کنید. اگر از ویژگی data-name استفاده می‌کنید، حتماً از عدد خام USER_ID استفاده کنید و پیشوند users/ که در مقادیر بازگشتی سایر ابزارها دیده می‌شود را وارد نکنید. توجه: حداکثر 10 اشاره در هر پیام مجاز است. ذکر همه کاربران (مثلاً استفاده از @all یا تگ HTML با users/all ) اکیداً ممنوع است.
  • ایموجی سفارشی: از یک تگ HTML خودبسته شونده chat-custom-emoji با ویژگی‌های data-uid="abc" و data-emoji-name=":xyz:" استفاده کنید.

طرحواره خروجی

پاسخ به ارسال پیام به مکالمه گوگل چت.

ارسال پیامپاسخ

نمایش JSON 
{
  "message": {
    object (ChatMessage)
  }
}
فیلدها
message

object ( ChatMessage )

پیامی که ارسال شد.

چتپیام

نمایش JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
فیلدها
messageId

string

نام منبع پیام. قالب: فاصله‌ها/{فاصله}/پیام‌ها/{پیام}

threadId

string

رشته‌ای که این پیام به آن تعلق دارد. اگر پیام رشته‌بندی نشده باشد، این قسمت خالی خواهد بود. قالب: space/{space}/threads/{thread}

plaintextBody

string

متن اصلی پیام با استفاده از قالب‌بندی Markdown.

sender

object ( User )

فرستنده پیام.

createTime

string

فقط خروجی. مهر زمانی که پیام ایجاد شده است.

threadedReply

boolean

اینکه آیا پیام، پاسخ یک تاپیک است یا خیر.

attachments[]

object ( ChatAttachmentMetadata )

پیوست‌های موجود در پیام.

reactionSummaries[]

object ( ReactionSummary )

خلاصه واکنش‌های ایموجی در پیام گنجانده شده است.

کاربر

نمایش JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
فیلدها
userId

string

نام منبع یک کاربر چت. فرمت: users/{user}.

displayName

string

نام نمایشی کاربر چت.

email

string

آدرس ایمیل کاربر. این فیلد فقط زمانی پر می‌شود که نوع کاربر HUMAN باشد.

userType

enum ( UserType )

نوع کاربر.

فراداده پیوست چت

نمایش JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
فیلدها
attachmentId

string

نام منبع پیوست. قالب: space/{space}/messages/{message}/attachments/{attachment}.

filename

string

نام فایل پیوست.

mimeType

string

نوع محتوا (نوع MIME).

source

enum ( Source )

منبع پیوست.

خلاصه واکنش

نمایش JSON 
{
  "emoji": string,
  "count": integer
}
فیلدها
emoji

string

رشته یونیکد ایموجی یا نام ایموجی سفارشی.

count

integer

تعداد کل واکنش‌ها با استفاده از ایموجی مرتبط.

نوع کاربر

نوع کاربر گوگل چت.

انوم‌ها
USER_TYPE_UNSPECIFIED نامشخص.
HUMAN کاربر انسانی.
APP کاربر برنامه.

منبع

منبع پیوست.

انوم‌ها
SOURCE_UNSPECIFIED رزرو شده.
DRIVE_FILE فایل، فایل گوگل درایو است.
UPLOADED_CONTENT فایل در چت آپلود شد.

حاشیه‌نویسی ابزار

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ❌ | راهنمایی فقط خواندنی: ❌ | راهنمایی جهان باز: ✅