Quick start: Create your first Chat app with AppSheet

---

To create your first Chat app with AppSheet, perform the following steps:

1. Copy the sample app .
2. Enable Chat apps with AppSheet .
3. Configure your Chat app  using automatic or manual configuration.
4. Test your Chat app .

Copy the sample app

To copy the sample app:

1. Sign in to  AppSheet .
   The My Apps page is displayed.
2. Click Templatesin the left navigation.
   
   
   
   The list of app templates is displayed.
3. Locate the Simple Inventoryapp template and click Copy.
   
   
   
4. Optionally, edit the name of the app and choose a category, or just use the default values.
5. Click Copy app.
   The app template is copied and your new app is created and opened in the AppSheet app editor. The Learning Center is displayed by default.

Enable Chat apps with AppSheet

1. In the app editor, click Chat apps  in the left navigation.
   
   
2. Click  Create.
   After a few minutes, the Enable section expands.
   Note: Review the Google Workspace Marketplace Developer Agreement  and the  Google APIs Terms of Service before proceeding

Next, you'll configure the Chat app.

Configure the Chat app

Configure the Chat app using automatic or manual configuration as described in the following sections. With one-click automatic configuration, Chat apps are only available to users in the organization in which they were created. With manual configuration, you can create Chat apps that are available to users inside your organization or that can be made available to external users. For more guidance on choosing the configuration mode, see Choose the configuration mode .

Automatic configuration is set by default.

Create the Chat app using automatic configuration

To configure the Chat app using automatic configuration: 

1. In the Enablesection, click Nextto create a Google Chat app.
2. In the Customizesection, leave the First messagesection set to the default configuration.
   All primary menu views will be included in the Chat app menu.
3. Leave the Smart "/search" commandturned on to allow users to search for Chat app  views using simple phrases.
4. Add the following actions (slash commands) to your Chat app:
   1. In the app editor, expand the Customize section (if it's not already expanded).
   2. Click + Action.
   3. Click Slash command: Open app view in the drop-down.
   4. Enter the following information:

      Field	Value
      App View	Inventory Log
      Name	/inventory-log
      Description	Display a log of inventory

   5. Click + Action.
   6. Click Slash command: Open app view in the drop-down.
   7. Enter the following information:

      Field	Value
      App View	Inventory_Form
      Name	/inventory-form
      Description	Add inventory

5. Click Next.
   The Test section expands. You need to deploy your Chat app before you can test it.
6. Deploy the app:
   1. Click Go to deployment settingsin the top banner.
   2. In the Deployment Check section, click Move app to deployed state.
7. Share the app with the test accounts.
8. Go to Test your Chat app .

Configure the Chat app using manual configuration

To configure the Chat app using manual configuration: 

1. In the Enablesection, select More> Switch to manual configuration in the Chat apps header.
   
   .
   
   The Enable section is refreshed with the steps for manual configuration.
2. To create a new Google Cloud project:
   1. Click Google Cloud Console > Projects in the app editor to open the New Project page.
   2. Enter a name for your project.
      This name is internal and isn't displayed in your Chat app.
   3. Set your billing account, organization, and location.
      For more information, see  Creating a project .
   4. Do notselect the Create Googleplex internal App Engine projectoption.
   5. Click Create.
3. Select  Cloud overview > Dashboard in the navigation menu to display the project dashboard.
   
   
4. Select the Google Cloud project in the project drop-down (if it's not already selected) and copy the Project numberthat is displayed in the Project infocard.
   
   
   
5. Return to the app editor and paste the project number in the Google Project Numberfield.
   
   
6. Click Next.
   Your app in now linked to the Google Cloud project. The Enable the Google Chat API section expands.
7. Enable the Google Chat API:
   1. In the  Enable the Google Chat APIsection, click Google Cloud Console > Google Chat API  to open the Google Chat API page in the Google Cloud Console.
   2. In the console, click Enableon the Google Chat API page for the connected Google Cloud project.
   3. Return to the app editor and click Next.
      The Customize section expands.
8. In the Customizesection, leave the First messagesection set to the default configuration. All primary menu views will be included in the Chat app menu.
9. Add the following actions (slash commands) to your Chat app:
   1. Click + New action.
   2. Click Slash command: Open app view in the drop-down.
   3. Enter the following information:

      Field	Value
      App View	Inventory Log
      Name	/inventory-log
      Description	Display a log of inventory

   4. Click + New action.
   5. Click Slash command: Open app view in the drop-down.
   6. Enter the following information:

      Field	Value
      App View	Inventory_Form
      Name	/inventory-form
      Description	Add inventory

      You'll complete the configuration of the slash commands later.

10. Click Next.
    The Configure the Google Chat API section expands.
11. To configure the Chat API:
    1. In the Configure the Google Chat API section, click Google Cloud Console > Google Chat API > Configuration  to open the Configuration tab for the Google Chat API in the Google Cloud Console.
    2. To complete the fields under Application info, including the App name, Avatar URL, and Description, copy the information from the app editor and paste it in the equivalent field in the console, as shown:
       
       
       
    3. In the console, make sure Enable interactive featuresis turned on.
    4. Turn on (select)  Receive 1:1 messagesand Join spaces and group conversationsunder Functionality.
       
       
       
    5. In the console, under Connection settingsselect App URL.
    6. To complete the App URLfield under Connection settings, copy the App URL field from the app editor and paste it in the equivalent field in the console, as shown:
       
       
12. In the Authentication Audiencefield, select Project Number.
13. Add slash commands to your Chat app:
    1. In the console, click Add a new slash commandunder Slash commands.
    2. To add the /inventory-logslash command, complete the fields under  New slash command, including the Name, Command Id, and Description, by copying the information from the app editor in Slash Command 1section of the Configure the Google Chat APIsection and pasting it in the equivalent field in the console.
       
       
    3. Enable the Opens a dialogoption.
    4. Click Done.
    5. Repeat to add the /inventory-formslash command. 
       
       
       
    6. Enable the Opens a dialogoption.
    7. Click Done.
14. Configure who can access the Chat app:
    1. In the console, under Visibility select Make this Chat app available to specific people and groups in your domainand add the email addresses for individual accounts.
       For initial test purposes, you may just add your own account.
    2. Click Save.
15. In the app editor, click Next.
16. Click Nextto skip the optional step, Grant IAM access to run automations. This step is not required for this tutorial.
    The Test section expands. You need to deploy your Chat app before you can test it.
17. Deploy the app:
    1. Click Go to deployment settingsin the top banner.
    2. In the Deployment Check section, click Move app to deployed state.
18. Share the app with the test accounts.

Test your Chat app

To test your Chat app:

1. Open Google Chat .
2. Click +next to Chat or Spaces.
3. Click Find appsin the drop-down.
   
   
   
4. Enter Simple Inventoryin the search field.
   
   
5. Click the Simple Inventoryapp in the list.
   The following dialog displays:
   
   
   
6. Do one of the following: The Chat app interface appears as follows:
   
   
   
   Notice that the Items and Levels views are targeted to open in the desktop UI because they use views types that are not yet supported for Chat apps with AppSheet. See Summary of features supported for Chat apps with AppSheet .
   • Click Add to spaceto add the Chat app to a space, enter the space name, and click Add.
   • Click Chatto start a direct message (DM). Type hello (or any string not starting with /) to display the Chat app interface.
7. Click Inventory Logto display the complete inventory log in the app dialog.
   Click through the inventory details, as desired, and click Xto close the app dialog.
8. Click Itemsand notice that it opens in a separate desktop browser window. 
   The Items view is a card view type, which is not supported in Google Chat. See Summary of features supported for Chat apps with AppSheet .
9. Enter /in Google Chat.
   The list of slash commands is displayed.
   
   
   
10. Click /inventory-formin the list, then click Enter.
    The Inventory form is open in the app dialog.
11. Enter a new inventory log and click Save.

Congratulations!You have successfully created your first Chat app with AppSheet!