تعاملات با برنامه Google Chat خود را دریافت کرده و به آنها پاسخ دهید

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

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

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

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

برای هر نوع تعامل کاربر، Google Chat نوع متفاوتی از رویداد تعامل ارسال می‌کند. به عنوان مثال، Google Chat از نوع رویداد MESSAGE برای هر تعاملی که در آن کاربر برنامه Chat را در پیامی فراخوانی می‌کند، استفاده می‌کند. برای جزئیات، به انواع رویدادهای تعامل برنامه گپ Google مراجعه کنید.

در این صفحه نحوه انجام کارهای زیر توضیح داده شده است:

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

رویدادهای تعامل برنامه چت را دریافت کنید

این بخش نحوه دریافت و پردازش رویدادهای تعاملی را برای برنامه چت شما شرح می دهد.

برنامه چت خود را برای دریافت رویدادهای تعامل پیکربندی کنید

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

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

  1. در کنسول Google Cloud، صفحه Google Chat API را باز کنید:

    به صفحه Google Chat API بروید

  2. روی تب Configuration کلیک کنید.
  3. در بخش ویژگی‌های تعاملی ، روی گزینه فعال کردن ویژگی‌های تعاملی در موقعیت روشن کلیک کنید.
  4. در Functionality ، یکی یا هر دو کادر زیر را انتخاب کنید:
    1. دریافت پیام‌های ۱:۱ : به کاربران امکان می‌دهد با برنامه چت شما در فضاهای پیام‌های مستقیم (DM) تعامل داشته باشند. هر زمان که کاربر پیامی را در فضای DM ارسال کند، برنامه چت شما رویدادهای تعاملی را دریافت می کند.
    2. پیوستن به فضاها و مکالمات گروهی : به کاربران امکان می‌دهد برنامه چت شما را به فضاهایی که بیش از یک نفر دارند اضافه و حذف کنند. برنامه چت شما هر زمان که از فضا اضافه یا حذف شود و هر زمان که کاربران @ نام می‌برند یا از دستور اسلش در فضا استفاده می‌کنند، رویدادهای تعاملی را دریافت می‌کند.
  5. در تنظیمات اتصال ، محل ارسال رویدادهای تعامل برنامه Chat را Google Chat مشخص کنید.
  6. اختیاری: در دستورات اسلش ، یک یا چند دستور اسلش را اضافه و پیکربندی کنید. برای اطلاعات بیشتر، به تنظیم دستورات اسلش مراجعه کنید.
  7. اختیاری: در پیش‌نمایش‌های پیوند ، یک یا چند الگوی URL را که برنامه چت شما پیش‌نمایش می‌کند، اضافه و پیکربندی کنید. برای اطلاعات بیشتر، پیش‌نمایش پیوندها را ببینید.
  8. روی ذخیره کلیک کنید.

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

مدیریت تماس های مجدد HTTP برای سرویس شما

اگر درخواست HTTPS به سرویس شما با شکست مواجه شود (مانند مهلت زمانی، خرابی موقت شبکه، یا کد وضعیت غیر 2xx HTTPS)، ممکن است گپ Google چند بار در عرض چند دقیقه تحویل را دوباره امتحان کند (اما این تضمین نمی‌شود). در نتیجه، یک برنامه چت ممکن است در شرایط خاص چند بار پیام مشابهی را دریافت کند. اگر درخواست با موفقیت تکمیل شود اما یک بار پیام نامعتبر برگرداند، Google Chat درخواست را دوباره امتحان نمی‌کند.

رویدادهای تعامل را پردازش کنید یا به آنها پاسخ دهید

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

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

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

نمودار زیر نشان می‌دهد که برنامه Google Chat معمولاً چگونه انواع مختلف رویدادهای تعاملی را پردازش می‌کند یا به آنها پاسخ می‌دهد:

معماری نحوه پردازش برنامه‌های چت Google وقایع تعامل.

در زمان واقعی پاسخ دهید

رویدادهای تعاملی به برنامه‌های چت اجازه می‌دهند به صورت هم‌زمان یا هم‌زمان پاسخ دهند. پاسخ های همزمان نیازی به احراز هویت ندارند.

برای ایجاد پاسخ‌های همزمان به رویدادهای تعامل، راهنماهای زیر را ببینید:

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

به صورت ناهمزمان پاسخ دهید

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

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