تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توضّح هذه الصفحة كيفية ضبط تطبيق Google Chat ونشره كإضافة في Google Workspace.
لنشر إضافة Google Workspace توسّع نطاق Chat واختبارها، عليك تفعيل تطبيق Chat وإعداده باستخدام Google Chat API. في إعدادات ضبط Chat API، يمكنك تحديد جميع التفاصيل حول تطبيق Chat، بما في ذلك الاسم والصورة الرمزية وعملية النشر والميزات التفاعلية التي تريد استخدامها.
يظهر اسم تطبيق Chat وصورته الرمزية ووصفه للمستخدمين في واجهة مستخدم Chat. للتفاعل مع تطبيقات Chat، يرى المستخدمون هذه المعلومات أو يستخدمونها بالطرق التالية:
أشِر إلى تطبيق Chat لإضافته إلى مساحة أو أرسِل إليه رسالة.
ابحث عن رسالة مباشرة وابدأها باستخدام تطبيق Chat.
في قائمة التطبيقات، تعرض الرسائل المباشرة اسم تطبيق Chat وصورته الرمزية.
من شريط الإنشاء، يمكن للمستخدمين تصفّح تطبيقات Chat والاطّلاع على أسمائهم وصور الأفاتار والأوصاف الخاصة بهم.
قبل إعداد تطبيق Chat، عليك تجهيز المعلومات التالية:
الحقل
الوصف
التنسيق
اسم التطبيق
الاسم المعروض لتطبيق Chat
ما يصل إلى 25 حرفًا أبجديًا رقميًا
عنوان URL للأفاتار
الصورة التي تظهر كأفاتار لتطبيق Chat
تمثّل هذه السمة عنوان URL يستخدم HTTPS ويشير إلى صورة مربّعة (بتنسيق PNG أو JPEG).
الحجم الموصى به هو 256 × 256 بكسل أو أكثر.
الوصف
وصف موجز للغرض من تطبيق Chat
ما يصل إلى 40 حرفًا أبجديًا رقميًا
في القسم التالي، يمكنك تحديد هذه المعلومات في إعدادات
الإعدادات في Chat API.
ضبط تطبيق Chat في Google Cloud Console
في Google Cloud Console، يمكنك ضبط التفاصيل الخاصة بتطبيق Chat والتي تظهر للمستخدمين في Chat، بما في ذلك الاسم المعروض والصورة الرمزية والوصف. لا تظهر هذه التفاصيل إلا في Chat. لنشر تطبيق Chat على Marketplace، يجب أيضًا تحديد التفاصيل التي تظهر في بطاقة بيانات Marketplace الخاصة بتطبيق Chat.
بعد الحصول على تفاصيل تطبيق Chat، افتح مشروعك على Cloud واضبط إعدادات Chat API باتّباع الخطوات التالية:
في وحدة تحكّم Google Cloud، انتقِل إلى صفحة Chat API وانقر على صفحة الإعدادات:
ضمن معلومات التطبيق، املأ الحقول اسم التطبيق وعنوان URL الخاص بالصورة الرمزية والوصف.
ضمن الميزات التفاعلية، انقر على تفعيل الميزات التفاعلية
إلى وضع التشغيل وأكمِل ما يلي:
ضمن الوظائف، انقر على الانضمام إلى المساحات والمحادثات الجماعية
لإتاحة تثبيت تطبيق Chat واستخدامه.
بشكل تلقائي، يمكن للمستخدمين تثبيت تطبيق Chat وإرسال الرسائل من خلاله في مساحة مخصّصة بين المستخدم وتطبيق Chat. ويمكن للمستخدمين أيضًا إضافة تطبيق Chat والتفاعل معه في المساحات التي تضم عدة أشخاص.
لاستخدام خدمة HTTP، اختَر عنوان URL لنقطة نهاية HTTP وقدِّم عنوان URL.
لاستخدام مشروع Google Apps Script، اختَر Apps Script وقدِّم رقم تعريف عملية النشر للمشروع.
اختياري: لتلقّي عناصر الأحداث إلى أكثر من نقطة نهاية أو دالة، انتقِل إلى إعدادات الاتصال>المشغّلات وقدِّم أو عدِّل دوال معاودة الاتصال لمشغّلات المحادثة التالية:
تمت الإضافة إلى المساحة: يضيف مستخدم تطبيق Chat إلى محادثة جماعية أو مساحة، أو يثبّت تطبيق Chat للرسائل بين شخصين.
الرسالة: يرسل المستخدم رسالة إلى تطبيق Chat، مثلاً، يرسل رسالة مباشرة إلى تطبيق Chat أو يشير إلى تطبيق Chat باستخدام @في مساحة تضم عدة مستخدمين.
تمت الإزالة من المساحة: يزيل المستخدم تطبيق Chat من المساحة أو يلغي تثبيته.
أمر التطبيق: يستخدم المستخدم أمرًا سريعًا أو أمرًا يبدأ بشرطة مائلة من تطبيق Chat.
ضمن إمكانية الوصول، حدِّد عنوان بريدك الإلكتروني حتى تتمكّن من
تثبيت تطبيق Chat واختباره
قبل نشره على Google Workspace Marketplace. يمكنك تحديد ما يصل إلى خمسة مستخدمين أو مجموعة واحدة أو أكثر من "مجموعات Google" من مؤسستك على Google Workspace.
اختياري: ضِمن السجلّات، ضَع علامة في مربّع الاختيار تسجيل الأخطاء في Logging لاستخدام Google Cloud Logging. لمزيد من المعلومات، راجِع مقالة
سجلّات أخطاء طلب البحث عن تطبيقات Chat
في وثائق Chat API.
انقر على حفظ.
بعد حفظ الإعدادات، يمكن لأي مستخدم حدّدته في إعداد إمكانية الوصول في Chat API تثبيت تطبيق Chat أو اختباره أو استخدامه. لبدء اختبار تطبيق Chat وتصحيح أخطائه، راجِع مقالة اختبار الميزات التفاعلية لتطبيقات Google Chat في مستندات Chat API.
اعتبارات بشأن إضافات Google Workspace الحالية
تتطلّب تطبيقات Chat إعدادًا مختلفًا مقارنةً بإضافات Google Workspace التي توسّع تطبيقات Google Workspace الأخرى.
إذا كانت الإضافة توسّع تطبيقات أخرى من Google Workspace، يجب مراعاة المتطلبات التالية عند إعداد تطبيق Chat:
يجب أن يتمكّن كل من الأفراد ومشرفي Google Workspace من تثبيت الإضافة من Marketplace. يمكنك ضبط إعدادات التثبيت هذه في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
لا تستخدم تطبيقات Chat الاسم والشعار اللذين تم ضبطهما
لتطبيقات Google Workspace الأخرى في عنصر addons.common من بيان التطبيق.
بالنسبة إلى الإضافات المنشورة على Google Workspace Marketplace، لا يمكنك حفظ مسودة لأي تغييرات في إعدادات ضبط واجهة برمجة التطبيقات Google Chat API.
بعد تعديل إعدادات ضبط واجهة برمجة التطبيقات في Chat وحفظها، سيصبح تطبيق Chat المعدَّل متاحًا لجميع المستخدمين الحاليين. لتعديل بطاقة بياناتك على Marketplace، يمكنك
إنشاء مسودة
قبل إرسال أي تغييرات.
إذا أنشأت الإضافة باستخدام
Apps Script:
يجب استخدام معرّف عملية النشر نفسه في Apps Script الذي تستخدمه لبقية إعدادات الإضافة.
إذا أنشأت الإضافة باستخدام خدمة HTTP، احذف أي تفاصيل إعدادات تطبيق Chat في ملف البيان وعمليات النشر التي تنشئها باستخدام واجهة برمجة التطبيقات الخاصة بإضافات Google Workspace. لا يتم استخدام عمليات نشر HTTP التي تحدّدها في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace إلا لتطبيقات Google Workspace الأخرى.
مواضيع ذات صلة
لإدارة إذن الوصول إلى Chat API، يُرجى الاطّلاع على مقالة
ضبط Google Chat API
في مستندات Google Chat API.
تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis guide explains how to set up a Google Chat app as a Google Workspace add-on using either Apps Script or an HTTP service.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need a Google Workspace account, a Google Cloud project, and necessary API configurations to get started.\u003c/p\u003e\n"],["\u003cp\u003eThe setup involves choosing a display name, avatar, and description for your app, and configuring its interactive features in the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eFor existing Google Workspace add-ons, specific considerations apply when integrating Chat app functionalities.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is part of the Google Workspace Developer Preview Program, granting early access before public release.\u003c/p\u003e\n"]]],["To configure a Chat app, use the Google Cloud console to access the Chat API page. Input the app's name, avatar URL, and description. Enable interactive features, choosing to receive 1:1 messages or join group conversations. Select either an HTTP endpoint URL or an Apps Script deployment ID for connection settings. Optionally, set triggers, add quick/slash commands, and specify visibility. Save configurations; users listed in \"Visibility\" can then test the Chat app.\n"],null,["# Configure a Google Chat app\n\nThis page explains how to configure and deploy a Google Chat app\nas a Google Workspace add-on.\n\nTo deploy and test a Google Workspace add-on that extends Chat,\nyou must enable and configure a Chat app using the\nGoogle Chat API. The Chat API configuration settings are where you\nspecify all the details about the Chat app, including\nthe name, avatar, deployment, and interactive features that you want to use.\n| **Note:** This page explains how to configure a Chat app using Apps Script or an HTTP service. [Dialogflow](/workspace/chat/build-dialogflow-chat-app-natural-language) and [Pub/Sub](/workspace/chat/quickstart/pub-sub) are unavailable. For details, see [Limitations and known issues](/workspace/add-ons/chat#limitations-known-issues).\n\nPrerequisites\n-------------\n\n- A Business or Enterprise [Google Workspace](https://support.google.com/a/answer/6043576) account with access to [Google Chat](https://workspace.google.com/products/chat/).\n- A Google Cloud project. To create one, see\n [Create a Google Cloud project](/workspace/guides/create-project).\n\n- [Configure the OAuth consent screen](/workspace/guides/configure-oauth-consent).\n- [Enable the Google Chat API](/workspace/guides/enable-apis).\n\nChoose a display name, avatar, and description for your Chat app\n----------------------------------------------------------------\n\nThe Chat app's name, avatar, and description are\ndisplayed to users in the Chat UI. To interact with\nChat apps, users see or use this information in the following\nways:\n\n- @mention the Chat app to add it to a space or send it a message.\n- Find and start a direct message with the Chat app. In the **Apps** menu, direct messages display the Chat app's name and avatar.\n- From the compose bar, users can browse Chat apps and see their name, avatar, and description.\n\nBefore you configure a Chat app, you must prepare the\nfollowing information:\n\n| Field | Description | Format |\n|-------------|-----------------------------------------------------|----------------------------------------------------------------------------------------------------------------|\n| App name | The display name for the Chat app. | Up to 25 alphanumeric characters |\n| Avatar URL | The image that displays as your Chat app's avatar. | An HTTPS URL pointing to a square graphics image (PNG or JPEG). Recommended size is 256 by 256 pixels or more. |\n| Description | A brief description of the purpose of the Chat app. | Up to 40 alphanumeric characters |\n\nIn the following section, you specify this information in the configurations\nsettings in the Chat API.\n\nConfigure your Chat app in the Google Cloud console\n---------------------------------------------------\n\nIn the Google Cloud console, you configure the details about your\nChat app that appear to users in Chat,\nincluding a display name, avatar, and description. These details only appear\nin Chat. To publish your Chat app to the\nMarketplace, you must also specify the details that\nappear in your Chat app's\n[Marketplace listing](/workspace/marketplace/create-listing).\n\nWhen you have your Chat app details, open your\nCloud project and configure the Chat API:\n\n1. In the Google Cloud console, go to the Chat API page and click the\n **Configuration** page:\n\n [Go to the Chat API Configuration page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat)\n2. Under **Application info** , fill out the **App name** , **Avatar URL** ,\n and **Description** fields.\n\n3. Under **Interactive features** , click the **Enable interactive features**\n to the on position and complete the following:\n\n 1. Under **Functionality** , select **Join spaces and group conversations**\n to make your Chat app available to install and use.\n\n By default, Users can install and message with the\n Chat app in a dedicated space between\n the user and Chat app. Users can also add and interact\n with the Chat app in spaces with multiple\n people.\n 2. Under **Connection settings** , select the architecture that you want to\n use to receive\n [event objects from Chat](/workspace/add-ons/chat/build#event-objects):\n\n - To use an HTTP service, select **HTTP endpoint URL** and provide a URL.\n - To use a Google Apps Script project, select **Apps Script** and provide a [deployment ID](/apps-script/concepts/deployments) for the project.\n\n | **Warning:** If an Apps Script deployment ID is already populated, the Cloud project is connected to an existing Google Workspace add-on. If you update the deployment ID in the Chat API, the deployment ID is updated for your add-on and could affect your listing in the Google Workspace Marketplace. To review your add-on configuration, see [Configure your app in the Google Workspace Marketplace SDK](/workspace/marketplace/enable-configure-sdk) in the Google Workspace Marketplace documentation.\n 3. Optional: To receive event objects to more than one endpoint or\n function, go to **Connection settings**\n \\\u003e **Triggers** and provide or\n update the callback functions for the following\n [Chat triggers](/workspace/add-ons/chat/build#triggers):\n\n | **Note:** For Apps Script, if you don't update the triggers, you must use the corresponding callback functions that are populated in this section (such as `onMessage`, `onAddedToSpace`, and `onRemovedFromSpace`).\n - **Added to space**: A user adds the Chat app to a group conversation or space, or installs the Chat app for 1:1 messages.\n - **Message**: A user sends a message to the Chat app. For example, sends a direct message to the Chat app or @mentions the Chat app in a space with multiple people.\n - **Removed from space**: A user uninstalls or removes the Chat app from a space.\n - **App command**: A user uses a quick command or slash command from the Chat app.\n 4. Optional: Add other interactive features such as\n [quick commands](/workspace/add-ons/chat/quick-commands),\n [slash commands](/workspace/add-ons/chat/slash-commands),\n or [link previews](/workspace/add-ons/chat/preview-links).\n\n 5. Under **Visibility** , specify your email so that you can\n [install and test the Chat app](/workspace/chat/test-interactive-features)\n before you publish to the Google Workspace Marketplace. You can specify\n up to five individuals, or one or more Google Groups from your\n Google Workspace organization.\n\n4. Optional: Under **Logs** , select the **Log errors to Logging** checkbox to\n use Google Cloud Logging. For more information, see\n [Query error logs for Chat apps](/workspace/chat/query-logs)\n in the Chat API documentation.\n\n5. Click **Save**.\n\nAfter you save the configuration, anyone that you specified in the\nChat API's **Visibility** setting can install, test, or use the\nChat app. To start testing and debugging your\nChat app, see\n[Test interactive features for Google Chat apps](/workspace/chat/test-interactive-features)\nin the Chat API documentation.\n\nConsiderations for existing Google Workspace add-ons\n----------------------------------------------------\n\nChat apps require a different configuration compared to\nGoogle Workspace add-ons that extend other Google Workspace applications.\nIf your add-on extends other\nGoogle Workspace applications, consider the following requirements\nfor configuring the Chat app:\n\n- Both individuals and Google Workspace administrators must be able to install your add-on from the Marketplace. You configure these installation settings in the Google Workspace Marketplace SDK.\n- Chat apps don't use the name and logo that you configure for other Google Workspace applications in the `addons.common` object of the [manifest](/workspace/add-ons/concepts/workspace-manifests).\n- For add-ons that are published to the Google Workspace Marketplace, you can't save a draft of any changes to the [Google Chat API configuration settings](/workspace/add-ons/chat/configure). After you update and save the Chat API configuration settings, the updated Chat app is available to all existing users. To update your Marketplace listing, you can [create a draft](/workspace/marketplace/manage-app-listing#draft-app-listing) before submitting any changes.\n- If you built your add-on using\n Apps Script:\n\n - You must use the same Apps Script deployment ID that you use for the rest of your add-on configuration.\n - You can't use the Apps Script editor to install [test deployments](/workspace/add-ons/how-tos/testing-workspace-addons#install_an_unpublished) in Chat. Instead, you must [install them directly from the\n Chat UI](/workspace/chat/test-interactive-features).\n- If you built your add-on using an HTTP service,\n omit any Chat app configuration details in the\n manifest and deployments that you create using the Google Workspace add-ons API. The\n HTTP deployments that you specify in the Google Workspace Marketplace SDK are\n only used for other Google Workspace applications.\n\nRelated topics\n--------------\n\n- To manage access to the Chat API, see [Configure the Google Chat API](/workspace/chat/configure-chat-api#grant-access) in the Google Chat API documentation.\n- [Test interactive features for Google Chat apps](/workspace/chat/test-interactive-features)"]]
