رابط های چت گوگل بسازید

این صفحه نمای کلی از نحوه ایجاد رابط های کاربری (UI) برای افزونه های Google Workspace که گپ Google را گسترش می دهند، ارائه می دهد.

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

برای ایجاد رابط برای برنامه‌های چت، از اجزای افزودنی زیر استفاده می‌کنید:

  • راه‌اندازها : روش‌هایی که کاربران چت Google می‌توانند یک برنامه گپ را فراخوانی کنند، مانند افزودن آن به یک فضا یا ارسال پیام.
  • اشیاء رویداد : داده‌هایی که برنامه‌های گپ از راه‌اندازها یا تعاملات رابط کاربری دریافت می‌کنند.
  • کنش‌ها : روش‌هایی که برنامه‌های چت می‌توانند به تعاملات، مانند ارسال پیام یا بازگرداندن رابط کاربری مبتنی بر کارت پاسخ دهند.
برنامه چت یک شی رویداد را از یک ماشه Added to space دریافت می کند
شکل 1 : وقتی کاربر یک برنامه چت را به یک فضا اضافه می کند، ماشه Added to space فعال می شود و یک شی رویداد ارسال می کند. برای پاسخ دادن به پیام، برنامه Chat شی رویداد را مدیریت می کند و عملی را برمی گرداند که پیام را ایجاد می کند.

برنامه‌های چت می‌توانند کارت‌هایی را در رابط‌های زیر بسازند و نمایش دهند:

  • پیام هایی که می توانند حاوی متن، کارت های ثابت یا تعاملی و دکمه باشند.
  • دیالوگ‌هایی که کارت‌هایی هستند که در یک پنجره جدید باز می‌شوند و معمولاً از کاربران می‌خواهند اطلاعات ارسال کنند.
  • پیش‌نمایش‌های پیوند، کارت‌هایی هستند که اطلاعات یک سرویس خارجی را پیش‌نمایش می‌کنند.

محرک ها

این بخش محرک هایی را که افزونه های Google Workspace در چت استفاده می کنند توضیح می دهد.

راه‌اندازها روش‌های خاصی هستند که کاربران با استفاده از رابط کاربری چت، از برنامه Chat استفاده می‌کنند، مانند استفاده از @mentions یا دستورات برنامه.

جدول زیر محرک‌های چت، توضیحات و نحوه واکنش برنامه‌های چت را نشان می‌دهد:

ماشه توضیحات پاسخ معمولی
به فضا اضافه شد

کاربر برنامه Chat را به یک فضا اضافه می‌کند یا یک سرپرست Google Workspace برنامه Chat را در فضاهای پیام مستقیم برای کاربران سازمان خود نصب می‌کند. برای آشنایی با برنامه‌های گپ نصب‌شده توسط سرپرستان، به نصب برنامه‌های Marketplace در دامنه خود در اسناد راهنمای Google Workspace Admin مراجعه کنید.

 برنامه چت پیامی ارسال می کند که توضیح می دهد چه کاری انجام می دهد و چگونه کاربران در فضا می توانند با آن تعامل داشته باشند.
پیام

یک کاربر با برنامه چت از طریق پیام به یکی از روش های زیر تعامل برقرار می کند:

  • پیامی را در فضای پیام مستقیم (DM) با برنامه چت ارسال می کند.
  • @در هر فضایی از برنامه Chat نام می برد.
  • پیامی ارسال می‌کند که حاوی پیوندی است که با الگوی URL برای پیش‌نمایش پیوند مطابقت دارد.
  • متن را در منوی چند انتخابی ویجت selectionInput تایپ می کند.
 برنامه چت بر اساس محتوای پیام پاسخ می دهد. به عنوان مثال، یک برنامه چت به دستور اسلش /about با پیامی پاسخ می دهد که وظایفی را که برنامه چت می تواند انجام دهد را توضیح می دهد.
از فضا حذف شد

یک کاربر برنامه Chat را از یک فضا حذف می‌کند، یا یک سرپرست Google Workspace، برنامه Chat را برای کاربر در سازمانش حذف نصب می‌کند.

کاربران نمی‌توانند برنامه‌های چت را که توسط سرپرستشان نصب شده است حذف کنند. اگر کاربری قبلاً برنامه Chat را نصب کرده باشد، برنامه Chat بدون در نظر گرفتن اینکه آیا سرپرست Google Workspace سعی در حذف نصب داشته باشد، همچنان نصب می‌شود.

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

کاربر از دستور برنامه Chat استفاده می کند.

 برنامه چت به این فرمان پاسخ می دهد. به عنوان مثال، با یک پیام پاسخ می دهد یا یک گفتگو را باز می کند.

بر خلاف سایر افزونه‌های Google Workspace، شما باید با استفاده از Google Chat API، عملکردهای پاسخ به تماس را برای این راه‌اندازها پیکربندی کنید. برای راهنمایی، به پیکربندی برنامه چت Google مراجعه کنید.

برای پاسخ به یک محرک، به راهنماهای زیر مراجعه کنید:

اشیاء رویداد

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

برای آشنایی با مدیریت اشیاء رویداد، به راهنماهای زیر مراجعه کنید:

برای آشنایی با اشیاء رویداد افزودنی در Chat و سایر برنامه‌های Google Workspace، به اشیاء رویداد مراجعه کنید.

اقدامات چت

این بخش توضیح می‌دهد که چگونه برنامه‌های چت می‌توانند از اقدامات افزودنی برای پاسخگویی به تعاملات کاربر استفاده کنند.

برای پاسخ دادن با یک کنش افزودنی، یک برنامه چت باید ظرف 30 ثانیه پاسخ دهد و پاسخ باید در فضایی که تعامل رخ داده است پست شود. در غیر این صورت، برنامه چت باید احراز هویت را تنظیم کند و برای پاسخگویی با Google Chat API تماس بگیرد .

برنامه‌های چت می‌توانند به طرق مختلف تعاملات را مدیریت کنند و به آن پاسخ دهند. در بسیاری از موارد، برنامه های چت با یک پیام پاسخ می دهند. برنامه‌های چت همچنین می‌توانند برخی از اطلاعات را از منبع داده جستجو کنند، اطلاعات شی رویداد یا تقریباً هر چیز دیگری را ضبط کنند. این رفتار پردازشی اساساً همان چیزی است که برنامه Google Chat را تعریف می کند.

برای پاسخ به تعاملات کاربر، برنامه‌های چت باید شی رویداد مربوطه را مدیریت کرده و یکی از اشیاء JSON زیر را برگردانند:

پاسخ برنامه چت اقدام لازم برای بازگشت
پیام ارسال یا به روز رسانی کنید . DataActions
یک گفتگو را باز کنید، به‌روزرسانی کنید یا ببندید. RenderActions
برای جمع‌آوری اطلاعات از یک کارت یا گفتگو، موارد انتخابی را بر اساس آنچه کاربران در منوی چند انتخابی تایپ می‌کنند، پیشنهاد دهید. RenderActions
پیش نمایش پیوندها در پیام هایی که کاربران چت در یک فضا ارسال می کنند. DataActions

با استفاده از Google Chat API پاسخ دهید

به‌جای بازگرداندن یک کنش افزودنی، ممکن است برنامه‌های گپ نیاز به استفاده از Google Chat API در پاسخ به یک تعامل داشته باشند. برای مثال، برنامه‌های چت باید با Google Chat API تماس بگیرند تا یکی از موارد زیر را انجام دهند:

  • پس از 30 ثانیه به یک تعامل پاسخ دهید.
  • کارهایی را خارج از فضایی که تعامل انجام شده است انجام دهید.
  • کارهایی را در Chat انجام دهید که به عنوان کنش‌های افزودنی در دسترس نیستند. برای مثال، فضاهایی را فهرست کنید که کاربر یا برنامه چت در آن عضو است، یا کاربران را به فضا اضافه کنید.
  • انجام وظایف از طرف کاربر چت (که نیاز به احراز هویت کاربر دارد).

برای آشنایی با احراز هویت و تماس با Chat API، به نمای کلی Chat API مراجعه کنید.