این صفحه نحوه تنظیم و پاسخ به دستورات به عنوان یک برنامه چت گوگل را توضیح میدهد.
دستورات به کاربران کمک میکنند تا ویژگیهای کلیدی یک برنامه چت را کشف و استفاده کنند. فقط برنامههای چت میتوانند محتوای یک دستور را ببینند. به عنوان مثال، اگر کاربری پیامی با دستور اسلش ارسال کند، آن پیام فقط برای کاربر و برنامه چت قابل مشاهده است.
برای تصمیمگیری در مورد اینکه آیا باید دستوراتی بسازید یا خیر، و برای درک نحوه طراحی تعاملات کاربر، به بخش «تعریف همه مسیرهای کاربر» مراجعه کنید.
انواع دستورات برنامه چت
شما میتوانید دستورات برنامه چت را به صورت دستورات اسلش یا دستورات سریع بسازید. برای کشف دستورات، کاربران میتوانند در قسمت پاسخ یک اسلش/ تایپ کنند یا روی ابزارهای Google Workspace کلیک کنند.دستورات اسلش: کاربران میتوانند یک دستور اسلش را از منو انتخاب کنند یا یک اسلش (
/) و سپس یک متن از پیش تعریف شده، مانند/aboutتایپ کنند. برنامههای چت معمولاً برای دستور اسلش به متن آرگومان نیاز دارند.اگر برنامه چت شما به ورودی اضافی از کاربر نیاز دارد، یک دستور اسلش ایجاد کنید. برای مثال، میتوانید یک دستور اسلش به نام
/searchایجاد کنید که پس از وارد کردن عبارتی برای جستجو توسط کاربر، مانند/search receipts، اجرا شود.دستورات سریع: کاربران با باز کردن منو از قسمت پاسخ یک پیام چت، از دستورات استفاده میکنند. برای استفاده از یک دستور، روی افزودن کلیک میکنند.
و یک دستور را از منو انتخاب کنید.
اگر برنامه چت شما میتواند بلافاصله و بدون انتظار برای ورودی اضافی به کاربر پاسخ دهد، یک دستور سریع ایجاد کنید. برای مثال، میتوانید یک دستور سریع به نام تصویر تصادفی ایجاد کنید که بلافاصله با یک تصویر پاسخ میدهد.

پیشنیازها
نود جی اس
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.اسکریپت برنامهها
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی در Apps Script، این راهنمای سریع را تکمیل کنید.پایتون
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.جاوا
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.فرمان را تنظیم کنید
این بخش نحوه انجام مراحل زیر را برای تنظیم دستور توضیح میدهد:
نام و شرح دستور
نام یک دستور، چیزی است که کاربران برای فراخوانی برنامه چت تایپ یا انتخاب میکنند. توضیح کوتاهی نیز در زیر نام آن نمایش داده میشود تا کاربران را در مورد نحوه استفاده از دستور راهنمایی کند:

هنگام انتخاب نام و توضیحات برای دستور خود، توصیههای زیر را در نظر بگیرید:
برای نامگذاری یک دستور:
- از کلمات یا عبارات کوتاه، توصیفی و کاربردی استفاده کنید تا دستورات برای کاربر واضح باشند. برای مثال، به جای نام
Create a reminder،Remind meاستفاده کنید. - استفاده از یک نام منحصر به فرد یا رایج برای دستور خود را در نظر بگیرید. اگر دستور شما یک تعامل یا ویژگی معمولی را توصیف میکند، میتوانید از یک نام رایج که کاربران آن را میشناسند و انتظار دارند، مانند
SettingsیاFeedback، استفاده کنید. در غیر این صورت، سعی کنید از نامهای دستور منحصر به فرد استفاده کنید، زیرا اگر نام دستور شما برای سایر برنامههای چت یکسان باشد، کاربر باید دستورات مشابه را فیلتر کند تا دستور شما را پیدا کرده و از آن استفاده کند.
برای توصیف یک دستور:
- توضیحات را کوتاه و واضح نگه دارید تا کاربران بدانند هنگام استفاده از دستور چه انتظاری داشته باشند.
- اگر الزامات قالببندی برای دستور وجود دارد، به کاربران اطلاع دهید. برای مثال، اگر یک دستور اسلش ایجاد میکنید که به متن آرگومان نیاز دارد، توضیحات را روی چیزی مانند
Remind me to do [something] at [time]تنظیم کنید. - به کاربران اطلاع دهید که آیا برنامه چت به همه افراد حاضر در فضا پاسخ میدهد یا به صورت خصوصی به کاربری که دستور را فراخوانی میکند. به عنوان مثال، برای دستور سریع
About»، میتوانید آن را به صورتLearn about this app (Only visible to you)توصیف کنید.
دستور را در کنسول Google Cloud پیکربندی کنید
برای ایجاد یک اسلش یا دستور سریع، اطلاعات مربوط به دستور را در پیکربندی برنامه چت خود برای Google Chat API مشخص میکنید.
برای پیکربندی یک دستور در Google Chat API، مراحل زیر را انجام دهید:
در کنسول گوگل کلود، روی منو > APIها و خدمات > APIها و خدمات فعالشده > Google Chat API کلیک کنید.
روی پیکربندی کلیک کنید.
در قسمت دستورات ، روی افزودن یک دستور کلیک کنید.
شناسه فرمان، توضیحات، نوع فرمان و نام آن را وارد کنید:
- شناسه فرمان: عددی از ۱ تا ۱۰۰۰ که برنامه چت شما برای تشخیص فرمان و بازگرداندن پاسخ از آن استفاده میکند.
- توضیحات: متنی که عملکرد دستور را شرح میدهد. توضیحات میتواند تا ۵۰ کاراکتر باشد و میتواند شامل کاراکترهای ویژه نیز باشد.
- نوع دستور: یکی از دو دستور Quick یا Slash را انتخاب کنید.
- یک نام برای دستور quick یا دستور slash مشخص کنید:
- نام دستور سریع: نام نمایشی که کاربران از منو برای فراخوانی دستور انتخاب میکنند. میتواند تا ۵۰ کاراکتر باشد و شامل کاراکترهای ویژه باشد. برای مثال،
Remind me. - نام دستور اسلش: متنی که کاربران برای فراخوانی دستور در یک پیام تایپ میکنند. باید با یک اسلش شروع شود، فقط شامل متن باشد و میتواند تا ۵۰ کاراکتر باشد. برای مثال،
/remindMe.
- نام دستور سریع: نام نمایشی که کاربران از منو برای فراخوانی دستور انتخاب میکنند. میتواند تا ۵۰ کاراکتر باشد و شامل کاراکترهای ویژه باشد. برای مثال،
اختیاری: اگر میخواهید برنامه چت شما با یک کادر محاورهای به دستور پاسخ دهد، کادر انتخاب «باز کردن یک کادر محاورهای» را علامت بزنید.
روی ذخیره کلیک کنید.
اکنون دستور برای برنامه چت پیکربندی شده است.
پاسخ به یک فرمان
وقتی کاربران از یک دستور استفاده میکنند، برنامه چت شما یک رویداد تعاملی دریافت میکند. این رویداد شامل ابردادههایی با جزئیاتی در مورد دستوری که فراخوانی شده است (از جمله شناسه دستور و نوع دستور) است، به طوری که میتوانید پاسخ مناسبی را برگردانید.

/help پاسخ میدهد تا نحوه دریافت پشتیبانی را توضیح دهد.برای پاسخ به هر نوع دستور، باید انواع مختلف رویداد و اشیاء فراداده را در payload رویداد مدیریت کنید:
| نوع فرمان | نوع رویداد | فرادادههای فرمان |
|---|---|---|
| دستور اسلش | MESSAGE | message.slashCommand یا message.annotation.slashCommand |
| دستور سریع | APP_COMMAND | appCommandMetadata |
برای یادگیری نحوه پاسخ به یک فرمان با یک پیام، به بخشهای زیر مراجعه کنید.
پاسخ به یک دستور اسلش
کد زیر نمونهای از یک برنامهی چت را نشان میدهد که به دستور اسلش /about پاسخ میدهد. برنامهی چت رویدادهای تعاملی MESSAGE مدیریت میکند، تشخیص میدهد که آیا رویداد تعاملی حاوی شناسهی دستور منطبق است یا خیر، و یک پیام خصوصی برمیگرداند:
نود جی اس
اسکریپت برنامهها
پایتون
جاوا
ABOUT_COMMAND_ID با شناسه دستوری که هنگام پیکربندی دستور در کنسول Google Cloud مشخص کردهاید، جایگزین کنید.
پاسخ سریع به یک دستور
کد زیر نمونهای از یک برنامه چت را نشان میدهد که به دستور سریع Help پاسخ میدهد. برنامه چت رویدادهای تعاملی APP_COMMAND را مدیریت میکند، تشخیص میدهد که آیا رویداد تعاملی حاوی شناسه دستور منطبق است یا خیر، و یک پیام خصوصی برمیگرداند:
نود جی اس
اسکریپت برنامهها
پایتون
جاوا
HELP_COMMAND_ID با شناسه دستوری که هنگام پیکربندی دستور در کنسول Google Cloud مشخص کردهاید، جایگزین کنید.
دستور را آزمایش کنید
برای آزمایش دستور و کد، به بخش «آزمایش ویژگیهای تعاملی برای برنامههای چت گوگل» مراجعه کنید.
برای آشنایی با نحوه آزمایش و استفاده از این دستور در رابط کاربری چت، به بخش «استفاده از برنامهها در گوگل چت» در مستندات راهنمای گوگل چت مراجعه کنید.
مباحث مرتبط
- مشاهده نمونههای برنامه چت که از دستورات استفاده میکنند
- ارسال پیام
- باز کردن پنجرههای محاورهای تعاملی
این صفحه نحوه تنظیم و پاسخ به دستورات به عنوان یک برنامه چت گوگل را توضیح میدهد.
دستورات به کاربران کمک میکنند تا ویژگیهای کلیدی یک برنامه چت را کشف و استفاده کنند. فقط برنامههای چت میتوانند محتوای یک دستور را ببینند. به عنوان مثال، اگر کاربری پیامی با دستور اسلش ارسال کند، آن پیام فقط برای کاربر و برنامه چت قابل مشاهده است.
برای تصمیمگیری در مورد اینکه آیا باید دستوراتی بسازید یا خیر، و برای درک نحوه طراحی تعاملات کاربر، به بخش «تعریف همه مسیرهای کاربر» مراجعه کنید.
انواع دستورات برنامه چت
شما میتوانید دستورات برنامه چت را به صورت دستورات اسلش یا دستورات سریع بسازید. برای کشف دستورات، کاربران میتوانند در قسمت پاسخ یک اسلش/ تایپ کنند یا روی ابزارهای Google Workspace کلیک کنند.دستورات اسلش: کاربران میتوانند یک دستور اسلش را از منو انتخاب کنند یا یک اسلش (
/) و سپس یک متن از پیش تعریف شده، مانند/aboutتایپ کنند. برنامههای چت معمولاً برای دستور اسلش به متن آرگومان نیاز دارند.اگر برنامه چت شما به ورودی اضافی از کاربر نیاز دارد، یک دستور اسلش ایجاد کنید. برای مثال، میتوانید یک دستور اسلش به نام
/searchایجاد کنید که پس از وارد کردن عبارتی برای جستجو توسط کاربر، مانند/search receipts، اجرا شود.دستورات سریع: کاربران با باز کردن منو از قسمت پاسخ یک پیام چت، از دستورات استفاده میکنند. برای استفاده از یک دستور، روی افزودن کلیک میکنند.
و یک دستور را از منو انتخاب کنید.
اگر برنامه چت شما میتواند بلافاصله و بدون انتظار برای ورودی اضافی به کاربر پاسخ دهد، یک دستور سریع ایجاد کنید. برای مثال، میتوانید یک دستور سریع به نام تصویر تصادفی ایجاد کنید که بلافاصله با یک تصویر پاسخ میدهد.

پیشنیازها
نود جی اس
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.اسکریپت برنامهها
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی در Apps Script، این راهنمای سریع را تکمیل کنید.پایتون
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.جاوا
یک برنامه چت گوگل که رویدادهای تعاملی را دریافت و به آنها پاسخ میدهد. برای ایجاد یک برنامه چت تعاملی با استفاده از سرویس HTTP، این راهنمای سریع را تکمیل کنید.فرمان را تنظیم کنید
این بخش نحوه انجام مراحل زیر را برای تنظیم دستور توضیح میدهد:
نام و شرح دستور
نام یک دستور، چیزی است که کاربران برای فراخوانی برنامه چت تایپ یا انتخاب میکنند. توضیح کوتاهی نیز در زیر نام آن نمایش داده میشود تا کاربران را در مورد نحوه استفاده از دستور راهنمایی کند:

هنگام انتخاب نام و توضیحات برای دستور خود، توصیههای زیر را در نظر بگیرید:
برای نامگذاری یک دستور:
- از کلمات یا عبارات کوتاه، توصیفی و کاربردی استفاده کنید تا دستورات برای کاربر واضح باشند. برای مثال، به جای نام
Create a reminder،Remind meاستفاده کنید. - استفاده از یک نام منحصر به فرد یا رایج برای دستور خود را در نظر بگیرید. اگر دستور شما یک تعامل یا ویژگی معمولی را توصیف میکند، میتوانید از یک نام رایج که کاربران آن را میشناسند و انتظار دارند، مانند
SettingsیاFeedback، استفاده کنید. در غیر این صورت، سعی کنید از نامهای دستور منحصر به فرد استفاده کنید، زیرا اگر نام دستور شما برای سایر برنامههای چت یکسان باشد، کاربر باید دستورات مشابه را فیلتر کند تا دستور شما را پیدا کرده و از آن استفاده کند.
برای توصیف یک دستور:
- توضیحات را کوتاه و واضح نگه دارید تا کاربران بدانند هنگام استفاده از دستور چه انتظاری داشته باشند.
- اگر الزامات قالببندی برای دستور وجود دارد، به کاربران اطلاع دهید. برای مثال، اگر یک دستور اسلش ایجاد میکنید که به متن آرگومان نیاز دارد، توضیحات را روی چیزی مانند
Remind me to do [something] at [time]تنظیم کنید. - به کاربران اطلاع دهید که آیا برنامه چت به همه افراد حاضر در فضا پاسخ میدهد یا به صورت خصوصی به کاربری که دستور را فراخوانی میکند. به عنوان مثال، برای دستور سریع
About»، میتوانید آن را به صورتLearn about this app (Only visible to you)توصیف کنید.
دستور را در کنسول Google Cloud پیکربندی کنید
برای ایجاد یک اسلش یا دستور سریع، اطلاعات مربوط به دستور را در پیکربندی برنامه چت خود برای Google Chat API مشخص میکنید.
برای پیکربندی یک دستور در Google Chat API، مراحل زیر را انجام دهید:
در کنسول گوگل کلود، روی منو > APIها و خدمات > APIها و خدمات فعالشده > Google Chat API کلیک کنید.
روی پیکربندی کلیک کنید.
در قسمت دستورات ، روی افزودن یک دستور کلیک کنید.
شناسه فرمان، توضیحات، نوع فرمان و نام آن را وارد کنید:
- شناسه فرمان: عددی از ۱ تا ۱۰۰۰ که برنامه چت شما برای تشخیص فرمان و بازگرداندن پاسخ از آن استفاده میکند.
- توضیحات: متنی که عملکرد دستور را شرح میدهد. توضیحات میتواند تا ۵۰ کاراکتر باشد و میتواند شامل کاراکترهای ویژه نیز باشد.
- نوع دستور: یکی از دو دستور Quick یا Slash را انتخاب کنید.
- یک نام برای دستور quick یا دستور slash مشخص کنید:
- نام دستور سریع: نام نمایشی که کاربران از منو برای فراخوانی دستور انتخاب میکنند. میتواند تا ۵۰ کاراکتر باشد و شامل کاراکترهای ویژه باشد. برای مثال،
Remind me. - نام دستور اسلش: متنی که کاربران برای فراخوانی دستور در یک پیام تایپ میکنند. باید با یک اسلش شروع شود، فقط شامل متن باشد و میتواند تا ۵۰ کاراکتر باشد. برای مثال،
/remindMe.
- نام دستور سریع: نام نمایشی که کاربران از منو برای فراخوانی دستور انتخاب میکنند. میتواند تا ۵۰ کاراکتر باشد و شامل کاراکترهای ویژه باشد. برای مثال،
اختیاری: اگر میخواهید برنامه چت شما با یک کادر محاورهای به دستور پاسخ دهد، کادر انتخاب «باز کردن یک کادر محاورهای» را علامت بزنید.
روی ذخیره کلیک کنید.
اکنون دستور برای برنامه چت پیکربندی شده است.
پاسخ به یک فرمان
وقتی کاربران از یک دستور استفاده میکنند، برنامه چت شما یک رویداد تعاملی دریافت میکند. این رویداد شامل ابردادههایی با جزئیاتی در مورد دستوری که فراخوانی شده است (از جمله شناسه دستور و نوع دستور) است، به طوری که میتوانید پاسخ مناسبی را برگردانید.

/help پاسخ میدهد تا نحوه دریافت پشتیبانی را توضیح دهد.برای پاسخ به هر نوع دستور، باید انواع مختلف رویداد و اشیاء فراداده را در payload رویداد مدیریت کنید:
| نوع فرمان | نوع رویداد | فرادادههای فرمان |
|---|---|---|
| دستور اسلش | MESSAGE | message.slashCommand یا message.annotation.slashCommand |
| دستور سریع | APP_COMMAND | appCommandMetadata |
برای یادگیری نحوه پاسخ به یک فرمان با یک پیام، به بخشهای زیر مراجعه کنید.
پاسخ به یک دستور اسلش
کد زیر نمونهای از یک برنامهی چت را نشان میدهد که به دستور اسلش /about پاسخ میدهد. برنامهی چت رویدادهای تعاملی MESSAGE مدیریت میکند، تشخیص میدهد که آیا رویداد تعاملی حاوی شناسهی دستور منطبق است یا خیر، و یک پیام خصوصی برمیگرداند:
نود جی اس
اسکریپت برنامهها
پایتون
جاوا
ABOUT_COMMAND_ID با شناسه دستوری که هنگام پیکربندی دستور در کنسول Google Cloud مشخص کردهاید، جایگزین کنید.
پاسخ سریع به یک دستور
کد زیر نمونهای از یک برنامه چت را نشان میدهد که به دستور سریع Help پاسخ میدهد. برنامه چت رویدادهای تعاملی APP_COMMAND را مدیریت میکند، تشخیص میدهد که آیا رویداد تعاملی حاوی شناسه دستور منطبق است یا خیر، و یک پیام خصوصی برمیگرداند:
نود جی اس
اسکریپت برنامهها
پایتون
جاوا
HELP_COMMAND_ID با شناسه دستوری که هنگام پیکربندی دستور در کنسول Google Cloud مشخص کردهاید، جایگزین کنید.
دستور را آزمایش کنید
برای آزمایش دستور و کد، به بخش «آزمایش ویژگیهای تعاملی برای برنامههای چت گوگل» مراجعه کنید.
برای آشنایی با نحوه آزمایش و استفاده از این دستور در رابط کاربری چت، به بخش «استفاده از برنامهها در گوگل چت» در مستندات راهنمای گوگل چت مراجعه کنید.
مباحث مرتبط
- مشاهده نمونههای برنامه چت که از دستورات استفاده میکنند
- ارسال پیام
- باز کردن پنجرههای محاورهای تعاملی