إرسال رسالة نصية

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

الرسائل الأساسية غير المنسَّقة

يتم تمثيل أي رسالة في Google Chat كعنصر JSON. يمكن أن تظهر الرسالة الأساسية التي تحدد نصًا عاديًا بسيطًا كما يلي:

{
  "text": "Your pizza delivery is here!"
}

إذا تم النشر في Google Chat (مثلاً من خلال الردود التلقائية الواردة على الويب)، سيبدو على النحو التالي:

استخدام النص المنسَّق في الرسائل

يتيح لك Google Chat إضافة تنسيق أساسي إلى نص الرسالة، بما في ذلك غامق ومائل وتتوسطه خط. لتنسيق النص، عليك لفّه مع الرموز التالية:

الشكل الرمز مثال النتيجة
غامق * *مرحبًا* مرحبًا
مائل _ (شرطة سفلية) _مرحبًا، مرحبًا
يتوسطه خط ~ مرحبًا~ مرحبًا
أحادي المسافة ` (فاصلة اقتباس) "مَرْحَبًا" hello
أحادي المسافة ``` (ثلاث علامات اقتباس خلفية) ```
مرحبًا
العالم
```
Hello
World

على سبيل المثال، جرِّب JSON التالي:

{
  "text": "Your pizza delivery *has arrived*!\nThank you for using _Pizza Bot!_"
}

يؤدي هذا إلى وضع رسالة من هذا النوع في مساحة Chat:

إنّ بنية ترميز النص هذه هي البنية نفسها التي تنطبق على الرسائل التي يكتبها المستخدمون، ولهذا السبب تكون مختلفة عن التنسيق المستند إلى HTML والمطبّقة على النص داخل البطاقات.

إذا ضمّنت عنوان URL لرابط عادي في نص رسالتك، مثل http://example.com/foo، سيستخدم Google Chat هذا النص كنص الرابط ويضيف تلقائيًا رابطًا تشعّبيًا إلى هذا النص إلى عنوان URL المحدد.

لتوفير نص رابط بديل للرابط، استخدِم البنية التالية:

البنية العرض
<https://example.com/foo|my link text> نص الرابط الخاص بي

ويكون نص الرابط أنبوب اختياريًا، بحيث يكون <https://example.com/foo> وhttps://example.com/foo مكافئَين.

الرسائل التي يشير إليها مستخدمون محدّدون باستخدام الرمز @

يمكن لتطبيق Chat الإشارة إلى مستخدم في رسالة باستخدام @، مع تقديم رقم تعريف المستخدم في البنية التالية:

<users/USER_ID>

سيتم استبدال هذه السلسلة بعلامة @للمستخدم المحدّد. على سبيل المثال، ننصحك باستخدام ملف JSON التالي:

{
    "text": "Hey <users/123456789012345678901>! Thank you for using _Pizza bot!_"
}

وستؤدي هذه الحمولة إلى نتيجة، مثل ما يلي:

الرسائل التي تشير باستخدام @إلى جميع المستخدمين

يمكنك استخدام رقم تعريف المستخدم الخاص all للإشارة باستخدام @إلى جميع المستخدمين البشرية في مساحة عمل. مثلاً:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}