این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

مخاطبین را در Google Chat جمع آوری و مدیریت کنید

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

برنامه چت را در عمل ببینید:

شکل 1. برنامه Chat با یک پیام متنی و دکمه ای که فرم تماس را باز می کند به دستور اسلش /about پاسخ می دهد.
شکل 2. برنامه Chat یک گفتگو را باز می کند که در آن کاربران می توانند اطلاعات مربوط به یک مخاطب را وارد کنند.
شکل 3. برنامه Chat یک گفتگوی تأیید را برمی‌گرداند تا کاربران بتوانند اطلاعات را قبل از ارسال بررسی و تأیید کنند.
شکل 4. پس از ارسال فرم توسط کاربر، برنامه چت یک پیام متنی خصوصی برای تایید ارسال ارسال می کند.
شکل 5. برنامه چت همچنین از کاربران می خواهد که یک مخاطب را از کارت در یک پیام اضافه کنند.

پیش نیازها

یک حساب Google Workspace تجاری یا سازمانی با دسترسی به Google Chat .

اهداف

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

معماری

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

موارد زیر نشان می‌دهد که کاربر معمولاً چگونه می‌تواند با برنامه چت تعامل داشته باشد:

کاربر یک پیام مستقیم را با برنامه Chat باز می کند یا برنامه Chat را به فضای موجود اضافه می کند.
برنامه چت از کاربر می خواهد با ساختن و نمایش یک فرم تماس به عنوان یک شی card ، یک مخاطب اضافه کند. برای ارائه فرم تماس، اپلیکیشن چت به روش های زیر به کاربران پاسخ می دهد:
- با یک پیام کارتی که حاوی فرم تماس است به @ نامگذاری و پیام‌های مستقیم پاسخ می‌دهد.
- با باز کردن یک گفتگو با فرم تماس، به دستور اسلش /addContact پاسخ می دهد.
- به دستور اسلش /about با یک پیام متنی پاسخ می‌دهد که دارای دکمه افزودن تماس است که کاربران می‌توانند روی آن کلیک کنند تا یک گفتگو با فرم تماس باز شود.
هنگامی که با فرم تماس ارائه می شود، کاربر اطلاعات تماس را در فیلدها و ابزارک های زیر وارد می کند:
- نام و نام خانوادگی : ویجت textInput که رشته ها را می پذیرد.
- تاریخ تولد : ویجت dateTimePicker که فقط تاریخ ها را می پذیرد.
- نوع تماس : ویجت selectionInput از دکمه‌های رادیویی که به کاربران امکان می‌دهد یک مقدار رشته واحد ( Personal یا Work ) را انتخاب و ارسال کنند.
- دکمه بازبینی و ارسال : آرایه buttonList با ویجت button که کاربر برای ارسال مقادیری که وارد می‌کند روی آن کلیک می‌کند.
برنامه Google Chat یک رویداد تعاملی CARD_CLICKED را برای پردازش مقادیری که کاربر وارد می‌کند مدیریت می‌کند و مقادیر را در کارت تأیید نمایش می‌دهد.
کاربر کارت تایید را بررسی کرده و روی دکمه ارسال کلیک می کند تا اطلاعات تماس نهایی شود.
برنامه Google Chat یک پیام متنی خصوصی ارسال می کند که ارسال را تأیید می کند.

محیط را آماده کنید

این بخش نحوه ایجاد و پیکربندی یک پروژه Google Cloud را برای برنامه Chat نشان می دهد.

یک پروژه Google Cloud ایجاد کنید

کنسول Google Cloud

در کنسول Google Cloud، به منو > IAM & Admin > ایجاد پروژه بروید.
به Create a Project بروید
در قسمت Project Name یک نام توصیفی برای پروژه خود وارد کنید.
اختیاری: برای ویرایش شناسه پروژه ، روی ویرایش کلیک کنید. شناسه پروژه پس از ایجاد پروژه قابل تغییر نیست، بنابراین شناسه ای را انتخاب کنید که نیازهای شما را برای طول عمر پروژه برآورده کند.
در قسمت Location ، روی Browse کلیک کنید تا مکان های احتمالی پروژه شما نمایش داده شود. سپس، روی انتخاب کلیک کنید.
احتیاط: سازمان Google Workspace خود را نمی توانید پیدا کنید؟
این بدان معناست که شما به حساب Google Workspace وارد نشده‌اید. برخی از ویژگی‌های شرح داده شده در اسناد توسعه‌دهنده Google Workspace فقط برای پروژه‌های مرتبط با یک سازمان در دسترس هستند.
روی ایجاد کلیک کنید. کنسول Google Cloud به صفحه داشبورد می رود و پروژه شما در عرض چند دقیقه ایجاد می شود.

gcloud CLI

در یکی از محیط‌های توسعه زیر، به Google Cloud CLI ( gcloud ) دسترسی پیدا کنید:

Cloud Shell : برای استفاده از ترمینال آنلاین با Gcloud CLI که قبلاً راه اندازی شده است، Cloud Shell را فعال کنید.
Cloud Shell را فعال کنید
Local Shell : برای استفاده از یک محیط توسعه محلی، gcloud CLI را نصب و مقداردهی اولیه کنید .
برای ایجاد یک پروژه Cloud، از دستور gcloud projects create استفاده کنید:
```
gcloud projects create PROJECT_ID
```
با تنظیم شناسه پروژه ای که می خواهید ایجاد کنید، PROJECT_ID جایگزین کنید.

احراز هویت و مجوز را تنظیم کنید

برنامه‌های گپ Google از شما می‌خواهند صفحه رضایت OAuth را پیکربندی کنید تا کاربران بتوانند برنامه شما را در برنامه‌های Google Workspace از جمله Google Chat مجوز دهند.

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

در کنسول Google Cloud، به منو > APIs & Services > صفحه رضایت OAuth بروید.
به صفحه رضایت OAuth بروید
در قسمت User type ، Internal را انتخاب کنید، سپس روی Create کلیک کنید.
در نام برنامه ، Contact Manager تایپ کنید.
در ایمیل پشتیبانی کاربر ، آدرس ایمیل یا یک گروه Google مناسب را انتخاب کنید.
در قسمت اطلاعات تماس برنامه‌نویس ، آدرس ایمیل خود را وارد کنید.
روی ذخیره و ادامه کلیک کنید.
در صفحه Scopes ، روی Save and Continue کلیک کنید. (برنامه چت به هیچ محدوده OAuth نیاز ندارد.)
خلاصه را مرور کنید و سپس روی بازگشت به داشبورد کلیک کنید.

برنامه Chat را ایجاد و اجرا کنید

در بخش زیر، کل پروژه Apps Script را کپی کرده و به‌روزرسانی می‌کنید که حاوی تمام کدهای برنامه مورد نیاز برای برنامه چت شما است، بنابراین نیازی به کپی و جای‌گذاری هر فایل نیست.

به صورت اختیاری، می توانید کل پروژه را در GitHub مشاهده کنید.

در GitHub مشاهده کنید

در اینجا یک نمای کلی از هر فایل آورده شده است:

main.gs

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

مشاهده کد `main.gs`

apps-script/contact-form-app/main.gs

در GitHub مشاهده کنید

/**
 * Copyright 2024 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * Responds to a MESSAGE interaction event in Google Chat.
 *
 * @param {Object} event the MESSAGE interaction event from Chat API.
 * @return {Object} message response that opens a dialog or sends private
 *                          message with text and card.
 */
function onMessage(event) {
  if (event.message.slashCommand) {
    switch (event.message.slashCommand.commandId) {
      case 1:
        // If the slash command is "/about", responds with a text message and button
        // that opens a dialog.
        return {
          text: "Manage your personal and business contacts 📇. To add a " +
                  "contact, use the slash command `/addContact`.",
          accessoryWidgets: [{
            buttonList: { buttons: [{
              text: "Add Contact",
              onClick: { action: {
                function: "openInitialDialog",
                interaction: "OPEN_DIALOG"
              }}
            }]}
          }]
        }
      case 2:
        // If the slash command is "/addContact", opens a dialog.
        return openInitialDialog();
    }
  }

  // If user sends the Chat app a message without a slash command, the app responds
  // privately with a text and card to add a contact.
  return {
    privateMessageViewer: event.user,
    text: "To add a contact, try `/addContact` or complete the form below:",
    cardsV2: [{
      cardId: "addContactForm",
      card: {
        header: { title: "Add a contact" },
        sections:[{ widgets: CONTACT_FORM_WIDGETS.concat([{
          buttonList: { buttons: [{
            text: "Review and submit",
            onClick: { action: { function : "openConfirmation" }}
          }]}
        }])}]
      }
    }]
  };
}

/**
 * Responds to CARD_CLICKED interaction events in Google Chat.
 *
 * @param {Object} event the CARD_CLICKED interaction event from Google Chat.
 * @return {Object} message responses specific to the dialog handling.
 */
function onCardClick(event) {
  // Initial dialog form page
  if (event.common.invokedFunction === "openInitialDialog") {
    return openInitialDialog();
  // Confirmation dialog form page
  } else if (event.common.invokedFunction === "openConfirmation") {
    return openConfirmation(event);
  // Submission dialog form page
  } else if (event.common.invokedFunction === "submitForm") {
    return submitForm(event);
  }
}

/**
 * Opens the initial step of the dialog that lets users add contact details.
 *
 * @return {Object} a message with an action response to open a dialog.
 */
function openInitialDialog() {
  return { actionResponse: {
    type: "DIALOG",
    dialogAction: { dialog: { body: { sections: [{
      header: "Add new contact",
      widgets: CONTACT_FORM_WIDGETS.concat([{
        buttonList: { buttons: [{
          text: "Review and submit",
          onClick: { action: { function: "openConfirmation" }}
        }]}
      }])
    }]}}}
  }};
}

/**
 * Returns the second step as a dialog or card message that lets users confirm details.
 *
 * @param {Object} event the interactive event with form inputs.
 * @return {Object} returns a dialog or private card message.
 */
function openConfirmation(event) {
  const name = fetchFormValue(event, "contactName") ?? "";
  const birthdate = fetchFormValue(event, "contactBirthdate") ?? "";
  const type = fetchFormValue(event, "contactType") ?? "";
  const cardConfirmation = {
    header: "Your contact",
    widgets: [{
      textParagraph: { text: "Confirm contact information and submit:" }}, {
      textParagraph: { text: "<b>Name:</b> " + name }}, {
      textParagraph: {
        text: "<b>Birthday:</b> " + convertMillisToDateString(birthdate)
      }}, {
      textParagraph: { text: "<b>Type:</b> " + type }}, {
      buttonList: { buttons: [{
        text: "Submit",
        onClick: { action: {
          function: "submitForm",
          parameters: [{
            key: "contactName", value: name }, {
            key: "contactBirthdate", value: birthdate }, {
            key: "contactType", value: type
          }]
        }}
      }]}
    }]
  };

  // Returns a dialog with contact information that the user input.
  if (event.isDialogEvent) {
    return { action_response: {
      type: "DIALOG",
      dialogAction: { dialog: { body: { sections: [ cardConfirmation ]}}}
    }};
  }

  // Updates existing card message with contact information that the user input.
  return {
    actionResponse: { type: "UPDATE_MESSAGE" },
    privateMessageViewer: event.user,
    cardsV2: [{
      card: { sections: [cardConfirmation]}
    }]
  }
}

/**
  * Validates and submits information from a dialog or card message
  * and notifies status.
  *
  * @param {Object} event the interactive event with parameters.
  * @return {Object} a message response that opens a dialog or posts a private
  *                  message.
  */
function submitForm(event) {
  const contactName = event.common.parameters["contactName"];
  // Checks to make sure the user entered a contact name.
  // If no name value detected, returns an error message.
  if (!contactName) {
    const errorMessage = "Don't forget to name your new contact!";
    if (event.dialogEventType === "SUBMIT_DIALOG") {
      return { actionResponse: {
        type: "DIALOG",
        dialogAction: { actionStatus: {
          statusCode: "INVALID_ARGUMENT",
          userFacingMessage: errorMessage
        }}
      }};
    } else {
      return {
        privateMessageViewer: event.user,
        text: errorMessage
      };
    }
  }

  // The Chat app indicates that it received form data from the dialog or card.
  // Sends private text message that confirms submission.
  const confirmationMessage = "✅ " + contactName + " has been added to your contacts.";
  if (event.dialogEventType === "SUBMIT_DIALOG") {
    return {
      actionResponse: {
        type: "DIALOG",
        dialogAction: { actionStatus: {
          statusCode: "OK",
          userFacingMessage: "Success " + contactName
        }}
      }
    }
  } else {
    return {
      actionResponse: { type: "NEW_MESSAGE" },
      privateMessageViewer: event.user,
      text: confirmationMessage
    };
  }
}

/**
 * Extracts form input value for a given widget.
 *
 * @param {Object} event the CARD_CLICKED interaction event from Google Chat.
 * @param {String} widgetName a unique ID for the widget, specified in the widget's name field.
 * @returns the value inputted by the user, null if no value can be found.
 */
function fetchFormValue(event, widgetName) {
  const formItem = event.common.formInputs[widgetName][""];
  // For widgets that receive StringInputs data, the value input by the user.
  if (formItem.hasOwnProperty("stringInputs")) {
    const stringInput = event.common.formInputs[widgetName][""].stringInputs.value[0];
    if (stringInput != null) {
      return stringInput;
    }
  // For widgets that receive dateInput data, the value input by the user.
  } else if (formItem.hasOwnProperty("dateInput")) {
    const dateInput = event.common.formInputs[widgetName][""].dateInput.msSinceEpoch;
     if (dateInput != null) {
       return dateInput;
     }
  }

  return null;
}

/**
 * Converts date in milliseconds since epoch to user-friendly string.
 *
 * @param {Object} millis the milliseconds since epoch time.
 * @return {string} Display-friend date (English US).
 */
function convertMillisToDateString(millis) {
  const date = new Date(millis);
  const options = { year: 'numeric', month: 'long', day: 'numeric' };
  return date.toLocaleDateString('en-US', options);
}

contactForm.gs

شامل ویجت هایی است که داده های فرم را از کاربران دریافت می کنند. این ویجت های ورودی فرم در کارت هایی که در پیام ها و دیالوگ ها ظاهر می شوند نمایش داده می شوند.

مشاهده کد `contactForm.gs`

apps-script/contact-form-app/contactForm.gs

در GitHub مشاهده کنید

/**
 * Copyright 2024 Google Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

/**
 * The section of the contact card that contains the form input widgets. Used in a dialog and card message.
 * To add and preview widgets, use the Card Builder: https://addons.gsuite.google.com/uikit/builder
 */
const CONTACT_FORM_WIDGETS = [
  {
    "textInput": {
      "name": "contactName",
      "label": "First and last name",
      "type": "SINGLE_LINE"
    }
  },
  {
    "dateTimePicker": {
      "name": "contactBirthdate",
      "label": "Birthdate",
      "type": "DATE_ONLY"
    }
  },
  {
    "selectionInput": {
      "name": "contactType",
      "label": "Contact type",
      "type": "RADIO_BUTTON",
      "items": [
        {
          "text": "Work",
          "value": "Work",
          "selected": false
        },
        {
          "text": "Personal",
          "value": "Personal",
          "selected": false
        }
      ]
    }
  }
];

appsscript.json

مانیفست Apps Script که پروژه Apps Script را برای برنامه Chat تعریف و پیکربندی می‌کند.

کد `appsscript.json` را مشاهده کنید

apps-script/contact-form-app/appsscript.json

در GitHub مشاهده کنید

{
  "timeZone": "America/Los_Angeles",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "chat": {}
}

شماره و شناسه پروژه Cloud خود را پیدا کنید

در کنسول Google Cloud، به پروژه Cloud خود بروید.
به کنسول Google Cloud بروید
روی Settings and Utilities > تنظیمات پروژه کلیک کنید.
به مقادیر موجود در قسمت Project number و Project ID توجه کنید. شما از آنها در بخش های زیر استفاده می کنید.

پروژه Apps Script را ایجاد کنید

برای ایجاد یک پروژه Apps Script و اتصال آن به پروژه Cloud:

روی دکمه زیر کلیک کنید تا پروژه مدیریت مخاطبین در Google Chat Apps Script باز شود.
پروژه را باز کنید
روی نمای کلی کلیک کنید.
در صفحه نمای کلی، کلیک کنید یک کپی تهیه کنید .
کپی پروژه Apps Script خود را نام ببرید:
1. روی کپی مدیریت مخاطبین در گپ Google کلیک کنید.
2. در عنوان پروژه ، Contact Manager - Google Chat app تایپ کنید
3. روی تغییر نام کلیک کنید.

پروژه Cloud پروژه Apps Script را تنظیم کنید

در پروژه Apps Script خود، کلیک کنید تنظیمات پروژه
در پروژه Google Cloud Platform (GCP) ، روی تغییر پروژه کلیک کنید.
در شماره پروژه GCP ، شماره پروژه پروژه Cloud خود را جای‌گذاری کنید.
روی تنظیم پروژه کلیک کنید. پروژه Cloud و پروژه Apps Script اکنون متصل هستند.

یک استقرار اسکریپت Apps ایجاد کنید

اکنون که همه کدها در جای خود هستند، پروژه Apps Script را اجرا کنید. وقتی برنامه Chat را در Google Cloud پیکربندی می‌کنید، از شناسه استقرار استفاده می‌کنید.

در Apps Script، پروژه برنامه Chat را باز کنید.
به Apps Script بروید
روی Deploy > New Deployment کلیک کنید.
اگر افزونه قبلاً انتخاب نشده است، در کنار انتخاب نوع ، روی انواع استقرار کلیک کنید و Add-on را انتخاب کنید.
در توضیحات ، توضیحاتی را برای این نسخه وارد کنید، مانند Test of Contact Manager .
روی Deploy کلیک کنید. Apps Script استقرار موفقیت آمیز را گزارش می دهد و یک شناسه استقرار ارائه می دهد.
روی Copy کلیک کنید تا شناسه استقرار کپی شود و سپس روی Done کلیک کنید.

برنامه چت را در کنسول Google Cloud پیکربندی کنید

این بخش نحوه پیکربندی Google Chat API را در کنسول Google Cloud با اطلاعاتی درباره برنامه Chat خود، از جمله شناسه پیاده‌سازی که به تازگی از پروژه Apps Script خود ایجاد کرده‌اید، نشان می‌دهد.

در کنسول Google Cloud، > محصولات بیشتر > Google Workspace > کتابخانه محصول > Google Chat API > مدیریت > پیکربندی کلیک کنید.
به تنظیمات Chat API بروید
در نام برنامه ، Contact Manager تایپ کنید.
در URL آواتار ، https://developers.google.com/chat/images/contact-icon.png را تایپ کنید.
در توضیحات ، Manage your personal and business contacts تایپ کنید.
روی گزینه فعال کردن ویژگی های تعاملی در موقعیت روشن کلیک کنید.
در بخش عملکرد ، کادرهای انتخاب دریافت پیام‌های 1:1 و پیوستن به فضاها و مکالمات گروهی را انتخاب کنید.
در قسمت تنظیمات اتصال ، Apps Script را انتخاب کنید.
در Deployment ID ، Apps Script Deployment ID را که در بخش قبلی هنگام ایجاد استقرار Apps Script کپی کردید، جای‌گذاری کنید.
در زیر دستورات اسلش ، دستورات اسلش /about و /addContact را تنظیم کنید:
1. برای تنظیم اولین دستور اسلش روی Add a slash کلیک کنید.
2. در نام ، /about تایپ کنید.
3. در Command ID 1 تایپ کنید.
4. در توضیحات ، Learn how to use this Chat app to manage your contacts تایپ کنید.
5. باز کردن یک گفتگو را انتخاب کنید.
6. روی Done کلیک کنید.
7. برای تنظیم دستور اسلش دیگر روی Add a Slash کلیک کنید.
8. در Name ، /addContact تایپ کنید
9. در Command ID 2 را تایپ کنید.
10. در توضیحات ، Submit information about a contact تایپ کنید.
11. باز کردن یک گفتگو را انتخاب کنید.
12. روی Done کلیک کنید.
در قسمت Visibility ، گزینه Make this Chat app برای افراد و گروه‌های خاص در YOUR DOMAIN را انتخاب کنید و آدرس ایمیل خود را وارد کنید.
در زیر گزارش‌ها ، Log errors to Logging را انتخاب کنید.
روی ذخیره کلیک کنید. یک پیام پیکربندی ذخیره شده ظاهر می شود.

برنامه چت آماده نصب و تست در چت است.

برنامه چت را تست کنید

برای آزمایش برنامه چت خود، یک فضای پیام مستقیم با برنامه چت باز کنید و یک پیام ارسال کنید:

Google Chat را با استفاده از حساب Google Workspace که هنگام اضافه کردن خود به عنوان آزمایش‌کننده معتمد ارائه کرده‌اید، باز کنید.
به Google Chat بروید
روی گپ جدید کلیک کنید.
در قسمت افزودن 1 یا چند نفر ، نام برنامه چت خود را تایپ کنید.
برنامه چت خود را از نتایج انتخاب کنید. یک پیام مستقیم باز می شود.
توجه: اگر برنامه Chat خود را در لیست نتایج نمی‌بینید، مطمئن شوید که حساب Google Workspace خود را در تنظیمات Visibility صفحه پیکربندی Chat API در کنسول Google Cloud قرار داده‌اید.

در پیام مستقیم جدید با برنامه چت، /addContact تایپ کرده و enter را فشار دهید.
در گفتگوی باز شده، اطلاعات تماس را وارد کنید:
1. در قسمت نام و نام خانوادگی ، یک نام وارد کنید.
2. در انتخابگر تاریخ تولد ، یک تاریخ را انتخاب کنید.
3. در قسمت نوع تماس ، دکمه رادیویی Work یا Personal را انتخاب کنید.
روی بررسی و ارسال کلیک کنید.
در گفتگوی تأیید، اطلاعاتی را که ارسال کردید مرور کنید و روی ارسال کلیک کنید. برنامه چت با یک پیام متنی پاسخ می دهد که می گوید ✅ CONTACT NAME has been added to your contacts. .
در صورت تمایل، می توانید فرم تماس را به روش های زیر نیز تست و ارسال کنید:
- از دستور /about slash استفاده کنید. برنامه چت با یک پیام متنی و یک دکمه ابزارک جانبی که می‌گوید Add a contact پاسخ می‌دهد. می توانید روی دکمه کلیک کنید تا یک گفتگو با فرم تماس باز شود.
- برای برنامه چت یک پیام مستقیم بدون دستور اسلش، مانند Hello ارسال کنید. برنامه چت با یک متن و کارت حاوی فرم تماس پاسخ می دهد.

پاک کن

برای جلوگیری از تحمیل هزینه به حساب Google Cloud خود برای منابع استفاده شده در این آموزش، توصیه می کنیم پروژه Cloud را حذف کنید.

احتیاط: حذف یک پروژه دارای اثرات زیر است:

همه چیز در پروژه حذف می شود. اگر از یک پروژه موجود برای این آموزش استفاده کرده اید، وقتی آن را حذف می کنید، هر کار دیگری را که در پروژه انجام داده اید نیز حذف می کنید.
شناسه های پروژه سفارشی گم می شوند. وقتی این پروژه را ایجاد کردید، ممکن است یک ID پروژه سفارشی ایجاد کرده باشید که می خواهید در آینده از آن استفاده کنید. برای حفظ URL هایی که از شناسه پروژه استفاده می کنند، مانند URL در appspot.com، به جای حذف کل پروژه، منابع انتخاب شده در داخل پروژه را حذف کنید.

اگر قصد دارید چندین آموزش و شروع سریع را کاوش کنید، استفاده مجدد از پروژه ها می تواند به شما کمک کند از فراتر رفتن از محدودیت های سهمیه پروژه جلوگیری کنید.

در کنسول Google Cloud، به صفحه مدیریت منابع بروید. > IAM & Admin > Manage Resources کلیک کنید.
به Resource Manager بروید
در لیست پروژه، پروژه ای را که می خواهید حذف کنید انتخاب کنید و سپس روی حذف کلیک کنید.
در گفتگو، ID پروژه را تایپ کنید و سپس بر روی Shut down کلیک کنید تا پروژه حذف شود.

مخاطبین را در Google Chat جمع آوری و مدیریت کنید

پیش نیازها

اهداف

معماری

محیط را آماده کنید

یک پروژه Google Cloud ایجاد کنید

کنسول Google Cloud

gcloud CLI

احراز هویت و مجوز را تنظیم کنید

برنامه Chat را ایجاد و اجرا کنید

مشاهده کد main.gs

مشاهده کد contactForm.gs

کد appsscript.json را مشاهده کنید

شماره و شناسه پروژه Cloud خود را پیدا کنید

پروژه Apps Script را ایجاد کنید

پروژه Cloud پروژه Apps Script را تنظیم کنید

یک استقرار اسکریپت Apps ایجاد کنید

برنامه چت را در کنسول Google Cloud پیکربندی کنید

برنامه چت را تست کنید

پاک کن

موضوعات مرتبط

مشاهده کد `main.gs`

مشاهده کد `contactForm.gs`

کد `appsscript.json` را مشاهده کنید