Skip to content
TriggerGoogle ChatReal-timeUpdated May 2026

When does Google Chat fire on new messages?

Short answer: Drop the "Google ChatGoogle Chat Message Received" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in Google Chat, not on a polling schedule.

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder
Trigger
Google Chat Message Received
When the matching event happens
when chat message receivednew google chat messagegoogle chat trigger message
What this trigger returns
for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
"name": "spaces/AAAA1234/messages/DDDD1357",
"text": "Hey team!",
"space": {
"name": "spaces/AAAA1234",
"displayName": "Engineering"
},
"sender": {
"displayName": "John Doe"
},
"createTime": "2026-04-12T10:00:00Z"
}
Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

FieldTypeExample
namestring"spaces/AAAA1234/messages/DDDD1357"
textstring"Hey team!"
spaceobject{ … }
space.namestring"spaces/AAAA1234"
space.displayNamestring"Engineering"
senderobject{ … }
sender.displayNamestring"John Doe"
createTimestring"2026-04-12T10:00:00Z"
FAQ

Questions about Google Chat Message Received.

How does the Google Chat Message Received trigger work in Google Chat?
Fires when a message lands in a Google Chat space the bot is in. For "react to mentions of @helpbot" or "auto-respond to common questions" workflows in Workspace teams.
Is the Google Chat Message Received trigger real-time?
Yes. Google Chat Message Received uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in Google Chat.
What data does Google Chat Message Received return?
The full event payload from Google Chat. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.
Can I filter Google Chat Message Received so only some events start a workflow?
Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.
Do I need Google Chat admin permissions to use Google Chat Message Received?
For most Google Chat accounts a standard user can authorize the trigger. Some Google Chat plans require an admin to enable third-party webhooks. Check Google Chat's docs if the trigger fails to register.

Build a workflow on this trigger.

One trigger. 3+ downstream actions. Zero glue.