MCP Tools Reference: chatmcp.googleapis.com

الأداة: send_message

يرسل هذا الإجراء رسالة Google Chat إلى محادثة بتنسيق Markdown.

تستخدم هذه الأداة معرّف محادثة ومعرّف سلسلة محادثات اختياريًا ونص رسالة كمدخلات. يمكن العثور على أرقام تعريف المحادثات باستخدام أداة search_conversations. تعرض هذه الطريقة الرسالة التي تم إنشاؤها.

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة send_message MCP.

طلب Curl 
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
}'

مخطط الإدخال

طلب إرسال رسالة إلى محادثة في Google Chat

SendMessageRequest

تمثيل JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
الحقول
conversationId

string

الحقل مطلوب. معرّف المحادثة (مثل spaces/AAAA...) التي سيتم إرسال الرسالة إليها
threadId

string

اختياريّ. معرّف سلسلة المحادثات (مثلاً، spaces/AAAA.../threads/BBBB...) التي سيتم إرسال الرسالة إليها. في حال عدم ضبط هذا الخيار، سيتم إرسال الرسالة إلى سلسلة محادثات جديدة.
messageText

string

الحقل مطلوب. تمثّل هذه السمة المحتوى الرئيسي للرسالة. يمكن إضافة التنسيق باستخدام Markdown العادي (يُرجى العِلم أنّه لا يمكن استخدام الجداول). يتوفّر التنسيق التالي:

  • غامق: **text**
  • مائل: *text* أو _text_
  • نص يتوسّطه خط: ~~text~~
  • Monospace: 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:".

مخطط النتائج

الردّ على إرسال رسالة إلى محادثة في Google Chat

SendMessageResponse

تمثيل JSON 
{
  "message": {
    object (ChatMessage)
  }
}
الحقول
message

object (ChatMessage)

الرسالة التي تم إرسالها

ChatMessage

تمثيل JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
الحقول
messageId

string

اسم مورد الرسالة التنسيق: spaces/{space}/messages/{message}
threadId

string

سلسلة المحادثات التي تنتمي إليها هذه الرسالة سيكون هذا الحقل فارغًا إذا كانت الرسالة غير مرتبطة بسلسلة محادثات. التنسيق: spaces/{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

اسم المورد لمستخدم Chat التنسيق: users/{user}.
displayName

string

الاسم المعروض لمستخدم Chat
email

string

عنوان البريد الإلكتروني للمستخدم لا تتم تعبئة هذا الحقل إلا عندما يكون نوع المستخدم HUMAN.
userType

enum (UserType)

نوع المستخدم

ChatAttachmentMetadata

تمثيل JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
الحقول
attachmentId

string

اسم المرفق التنسيق: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

اسم المرفق
mimeType

string

نوع المحتوى (نوع MIME)
source

enum (Source)

مصدر المرفق

ReactionSummary

تمثيل JSON 
{
  "emoji": string,
  "count": integer
}
الحقول
emoji

string

سلسلة يونيكود الإيموجي أو اسم الإيموجي المخصّص
count

integer

تمثّل هذه السمة إجمالي عدد التفاعلات باستخدام الإيموجي المرتبط.

UserType

نوع مستخدم Google Chat

عمليات التعداد
USER_TYPE_UNSPECIFIED غير محدد
HUMAN مستخدم بشري
APP مستخدم التطبيق

المصدر

مصدر المرفق

عمليات التعداد
SOURCE_UNSPECIFIED محجوز
DRIVE_FILE الملف هو ملف Google Drive.
UPLOADED_CONTENT يتم تحميل الملف إلى Chat.

تعليقات توضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅