یک برنامه Google Chat تعاملی بسازید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه یک نمای کلی از چارچوب هایی را ارائه می دهد که می توانید از آنها برای ایجاد یک برنامه تعاملی Google Chat استفاده کنید.
برنامههای چت تعاملی به کاربران این امکان را میدهند که هر یک از موارد زیر را انجام دهند:
- برنامههای چت را به فضاهای چت یا پیامهای مستقیم اضافه کنید.
- به برنامههای چت پیام بفرستید یا از آن پیام دریافت کنید.
- برنامههای چت را با یک فرمان درخواست کنید.
- پیش نمایش پیوندها از یک سرویس یا سیستم خارجی.
- اطلاعاتی را به برنامههای چت ارسال کنید، مانند وارد کردن متن در گفتگو یا پیام کارت.
چگونه کاربران برنامههای چت تعاملی را کشف و استفاده میکنند
کاربران میتوانند برنامههای Chat منتشر شده در Marketplace را به روشهای مختلفی کشف و استفاده کنند، از جمله موارد زیر:
- برنامههای چت را از Google Chat یا Marketplace جستجو و نصب کنید.
- با یک برنامه چت که به فضای چت اضافه شده است تعامل داشته باشید.
- پس از اینکه یک سرپرست Google Workspace برنامه Chat را از طرف او نصب کرد، برنامه Chat را در پانل پیامهای مستقیم آنها کشف کنید.
برای شروع استفاده از برنامه چت، کاربران گپ Google میتوانند یک پیام مستقیم را با برنامه چت شروع کنند یا آن را به یک فضا اضافه کنند. کاربران همچنین می توانند با ذکر @ نام برنامه Chat را اضافه کنند. برای اطلاعات بیشتر، به استفاده از برنامههای گپ مراجعه کنید.
مثال زیر نشان میدهد که چگونه یک کاربر @ از یک برنامه Chat نام میبرد تا آن را به یک فضا اضافه کند:

چارچوبی را برای برنامه چت تعاملی خود انتخاب کنید
برای ساختن یک برنامه چت که با کاربران تعامل دارد، میتوانید از بین چارچوبهای زیر یکی را انتخاب کنید:
- افزونه Google Workspace : به شما امکان می دهد سایر برنامه های Google Workspace را گسترش دهید و برنامه Chat خود را با انواع دیگر برنامه ها در Google Workspace Marketplace فهرست کنید. برای کسب اطلاعات بیشتر، به Extend Google Chat در اسناد افزودنی Google Workspace مراجعه کنید.
- رویداد تعامل Chat API : به شما امکان میدهد ویژگیهای اضافی مانند صفحه اصلی برنامه Chat بسازید و از معماریهای دیگری مانند Pub/Sub و Dialogflow CX استفاده کنید. برای کسب اطلاعات بیشتر، به رویدادهای تعاملی دریافت و پاسخ دهید .
برای هر چارچوب، جدول زیر مستندات پیکربندی و ایجاد یک برنامه چت تعاملی اساسی را برای معماری هر برنامه Google Chat نشان میدهد:
ساخت ویژگی های تعاملی
برای هر چارچوب، جدول زیر مستندات ساخت ویژگی های تعاملی را نشان می دهد:
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Build an interactive Google Chat app\n\nThis page provides an overview of the frameworks that you can use to build an\ninteractive Google Chat app. \n\nInteractive Chat apps let users do any of the following:\n\n- Add Chat apps to Chat spaces or direct messages.\n- Send messages to or receive messages from Chat apps.\n- Prompt Chat apps with a command.\n- Preview links from an external service or system.\n- Submit information to Chat apps, such as entering text into a dialog or card message.\n\nHow users discover and use interactive Chat apps\n------------------------------------------------\n\nUsers can discover and use Chat apps published to the\nMarketplace in many ways, including the following:\n\n- Search and install Chat apps from Google Chat or the Marketplace.\n- Interact with a Chat app that's been added to a Chat space.\n- Discover the Chat app in their direct messages panel after a Google Workspace administrator installed the Chat app on their behalf.\n\nTo start using a Chat app, Google Chat users can\nstart a direct message with the Chat app or add it to a\nspace. Users can also add the Chat app by @mentioning\nit. For more information, see\n[Use Chat apps](https://support.google.com/chat/answer/7655820).\n\nThe following example shows how a user @mentions a\nChat app to add it to a space:\n\nChoose a framework for your interactive Chat app\n------------------------------------------------\n\nTo build a Chat app that interacts with users, you\ncan choose between the following frameworks:\n\n- **Google Workspace add-on** : Lets you extend other Google Workspace applications and list your Chat app with other types of apps on the Google Workspace Marketplace. To learn more, see [Extend Google Chat](/workspace/add-ons/chat) in the Google Workspace add-on documentation.\n- **Chat API interaction event** : Lets you build additional features such as a [Chat app homepage](/workspace/chat/send-app-home-card-message) and use other architectures such as Pub/Sub and Dialogflow CX. To learn more, see [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions).\n\n### Configure an interactive Chat app\n\nFor each framework, the following table shows the documentation for configuring\nand creating a basic interactive Chat app for each\n[Google Chat app architecture](/workspace/chat/structure):\n\n| Configuration | Add-on | Chat API interaction events |\n|------------------------|-----------------------------------------------------------------|-----------------------------------------------------------------------------|---|\n| Configure the Chat API | [Documentation](/workspace/add-ons/chat/configure) | [Documentation](/workspace/chat/configure-chat-api) |\n| **Quickstarts** | |||\n| Apps Script | [Documentation](/workspace/add-ons/chat/quickstart-apps-script) | [Documentation](/workspace/chat/quickstart/apps-script-app) |\n| HTTP service | [Documentation](/workspace/add-ons/chat/quickstart-http) | [Documentation](/workspace/chat/quickstart/gcf-app) |\n| Dialogflow CX | Unavailable for add-ons. | [Documentation](/workspace/chat/build-dialogflow-chat-app-natural-language) |\n| Pub/Sub | Unavailable for add-ons. | [Documentation](/workspace/chat/quickstart/pub-sub) |\n\n### Build interactive features\n\nFor each framework, the following table shows the documentation for\nbuilding interactive features:\n\n| Feature | Add-on | Chat API interaction events |\n|---------------------------------------|------------------------------------------------------------------------|-------------------------------------------------------------|\n| Send messages | [Documentation](/workspace/add-ons/chat/send-messages) | |\n| Respond to commands | [Documentation](/workspace/add-ons/chat/commands) | [Documentation](/workspace/chat/commands) |\n| Build interactive dialogs | [Documentation](/workspace/add-ons/chat/dialogs) | [Documentation](/workspace/chat/dialogs) |\n| Collect and process information | [Documentation](/workspace/add-ons/chat/collect-information) | [Documentation](/workspace/chat/read-form-data) |\n| Preview links in Chat messages | [Documentation](/workspace/add-ons/chat/preview-links) | [Documentation](/workspace/chat/preview-links) |\n| Build a homepage for your Chat app | Unavailable for add-ons. | [Documentation](/workspace/chat/send-app-home-card-message) |\n| Connect to external systems and tools | [Documentation](/workspace/add-ons/guides/connect-third-party-service) | [Documentation](/workspace/chat/connect-web-services-tools) |\n\nRelated topics\n--------------\n\n- [Build a Google Chat app as a Google Workspace add-on](/workspace/add-ons/chat)\n- [Receive and respond to interaction events](/workspace/chat/receive-respond-interactions)\n- [Choose a Google Chat app architecture](/workspace/chat/structure)"]]