Send a Chat message from an automation

Configure an automation bot to send a Chat message to one or more Chat spaces based on an event by using the Send a Chat message task.

For example, if an employee sends a request for a new chair (the event), you can configure the bot to send a Chat message to their manager requesting approval before fulfilling the request.

Before you can build automations for your Chat apps, you must Configure your Chat app with AppSheet, including granting IAM access to run automations if you selected manual configuration to configure you Chat app.

Add and configure the Send a Chat message task by performing the following steps: 

  1. Add the Send a Chat message task to a bot, as described in Add a task to a bot.
  2. Configure the Send a Chat message task by using the settings described in the table below.
  3. When you are done, save the app by selecting one of the following:
    • Save - Save the app.
    • Save & verify data - Save the app and verify that it is runnable based on external dependencies.

Configure the Send a Chat message task by using the settings described in the following table.



Linking Enable or disable reuse of this component by expanding the Linking panel and toggling the Linking setting. See Reuse automation components.

Expand the Linking panel and toggle the Linking setting to enable or disable component reuse

Table name

Table referenced by the task. Select an existing table in the list or No table.

You can also select a table slice but note that if the selected slice contains a row filter, you may see failures in the task. This is because the user that triggered the automation may not have access to the row because of the slice row filter.

Click Show this table Show icon to view the selected table in a dialog.

See Tables: The Essentials for more information about adding tables.

Message content

Select one of the following in the drop-down:

  • Select chat spaces to explicitly select the Chat spaces, group Chats, or direct messages (using the Space IDs field) to which you want to send the Chat message.
  • Respond to same thread to respond to the originating Chat space thread.
Note: If you select Respond to same thread:
  • For the parent process, don't set linking on. The originating Chat space thread can't be identified when the process is used by multiple bots. See Reuse automation components
  • The parent event must be a Chat event. See Configure Chat events.

Space IDs

Note: This setting is available if you choose Select chat spaces in the Message content drop-down.

Specify the IDs for the Chat spaces, group Chats, or direct messages to which you want to send the Chat message. Click Add and select an item from the drop-down list. Repeat to add additional IDs.

Message text

Chat message text. Specify text, variables, and expressions.

Send an app view (optional)

Optionally, you can send an app view to the Chat space as a Chat card

Note: For preview, only deck and detail views are supported from Send a Chat message tasks. For more information, see Supported view types and settings

 Expand and customize the Advanced settings, as described below.




Add inputs to dynamically configure a task. For details, see Set input values dynamically in tasks

  1. Expand the Advanced section.
  2. Click Add under Inputs.
  3. Enter the name of the input value in the Name field.
  4. Select the data type from the Type drop-down.
    Only a subset of data types are supported for inputs.
  5. To add an initial value or edit any fields:
    1. Click  to open the Input dialog.
    2. Add a value or expression in the Initial value field.
      If you don't specify an initial value, then the input value will be required. If an initial value is specified, then the input value is optional.
      Use of [_THIS] or [_INPUT] are not supported in the Initial value field.
    3. Edit other fields, as required.
    4. Click Done.
  6. Repeat to add additional input values.

Then, use the following expressions to access the input values from the current step: [_INPUT].[inputname]

Was this helpful?

How can we improve it?

Need more help?

Try these next steps:

Clear search
Close search
Google apps
Main menu
Search Help Center