MCP Tools Reference: chatmcp.googleapis.com

ابزار: send_message

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

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

شناسه‌های گفتگو را می‌توان با استفاده از ابزار search_conversations پیدا کرد.

پیام ایجاد شده را برمی‌گرداند.

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

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

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

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

نمایش 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-user="users/USER_ID" استفاده کنید. در صورت شناخته شدن، ویژگی data-user را با USER_ID ترجیح دهید و در غیر این صورت به ویژگی data-email با ایمیل کاربر برگردید. اگر از ویژگی data-user استفاده می‌کنید، مطمئن شوید که پیشوند users/ که در مقادیر بازگشتی سایر ابزارها دیده می‌شود را وارد کنید. توجه: حداکثر 10 ذکر در هر پیام مجاز است. ذکر همه کاربران (مثلاً استفاده از @all یا تگ HTML با users/all ) اکیداً ممنوع است.
  • ایموجی سفارشی: از یک تگ HTML خودبسته شونده chat-emoji با ویژگی‌های data-custom-emoji="customEmojis/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 فایل در چت آپلود شد.

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

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

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

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

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